book

Designing and Programming CICS Applications

by John Horswill, Members of the CICS Development Team at IBM Hursley

July 2000

Intermediate to advanced

414 pages

9h 41m

English

O'Reilly Media, Inc.

Read now

Unlock full access

A Note Regarding Supplemental Files
Preface
The Book’s AudienceOrganization of the BookAbout the CD-ROMConventions in This BookHow to Contact UsAcknowledgments
I. Introduction to CICS
1. Introduction
The Essentials of a Business ApplicationDivision of ResponsibilitiesLifecycle RequirementsTechnical RequirementsBusiness Applications as Creators of ValueUsing CICS for Business ApplicationsExamples of Business Applications That Use CICS
2. Designing Business Applications
The Heart of a Business ApplicationComponentsBusiness logic componentsPresentation logic componentsComponent interfacesA note about traditional CICS applicationsTransactionsLimitations of ACID transactionsError HandlingThe need for a methodical approachHow CICS Can Help the Application DesignerCICS TransactionsCICS Programs and LinkingSynchronous calling between programsAsynchronous calling between programsCalling CICS programs from non-CICS programsDefining resourcesWorking with MQSeriesError Handling FacilitiesSecurityTransaction securityResource security and command securityOther Services for the Application DesignerDeveloping the Components of a Business ApplicationDesignProgrammingTest and DebugDeploymentWhat’s Next…
3. Introducing the Sample Application
The Business CaseThe IT RequirementsThe Cross-Functional TeamThe Design of the Sample ApplicationThe Initial ArchitectureWhat’s Next…
II. The COBOL Business Logic Component
4. Designing the Business Logic
Understanding What COBOL Components Need to DoLooking at the Data StructureAssessing RestrictionsEstimating the WorkloadSummaryIncorporating CICS Design GuidelinesUsing Resources EfficientlyShared resourcesSingle-user resourcesMaintaining File Integrity: Using LockingHandling ErrorsCategories of errors in a CICS transactionHandling DataThe Account FileThe Name FileThe Locking FileRecovery RequirementsDesigning the Individual FunctionsCreating, Reading, Updating, and Deleting Account RecordsReading a recordBrowsing RecordsError ProcessingMapping the Functions to CICS ProgramsLooking at the Business Logic ProgramsThe Create, Read, Update, and Delete Backend Progam (NACT02)The ABEND/Error Handler Program (NACT04)The Name Browse Backend Program (NACT05)Summary
5. Programming the COBOL Business Logic
Writing CICS Programs in COBOLInvoking CICS ServicesDifferences from Standard COBOL ProgramsHandling FilesREAD CommandsUsing the READ Command in the Sample ApplicationBrowsing a FileStarting the browse operationReading the next recordFinishing the browse operationUsing the browse commands in the sample applicationWrite CommandsRewriting a file recordAdding (writing) a file recordDeleting a file recordUsing the write commands in the example applicationErrors on file commandsOther File ServicesSaving Data: Using a Scratchpad FacilityAffinitiesControlling ProgramsAssociating Programs and TransactionsCommands for Passing Program ControlThe LINK CommandThe XCTL CommandThe RETURN CommandThe COBOL CALL StatementSubroutinesExamples of Passing Control and Data Between Programs and TransactionsCommunicating Between Transactions in the Sample ApplicationAccessing the COMMAREA in the called programExamples of EXEC CICS RETURN useErrors on the Program Control CommandsAbending a TransactionOther Program Control CommandsQueuing Facilities: Temporary Storage and Transient DataTemporary StorageTransient DataThe EXEC CICS WRITEQ TD CommandThe EXEC CICS WRITEQ TD command as used in the NACT04 programHandling ErrorsThe EXEC CICS ASSIGN CommandThe EXEC CICS ASSIGN command as used in the NACT04 programThe EXEC CICS INQUIRE PROGRAM CommandDescriptionBrowsingThe EXEC CICS INQUIRE PROGRAM as used in the NACT04 programThe EXEC CICS DUMP TRANSACTION CommandEXEC CICS DUMP TRANSACTION as used in NACT04The EXEC CICS SYNCPOINT ROLLBACK CommandThe EXEC CICS SYNCPOINT ROLLBACK command as used in the NACT04 programThe EXEC CICS WRITE OPERATOR CommandThe EXEC CICS WRITE OPERATOR command as used in the NACT04 programOther CommandsWhat’s Next…
III. The CICS Java Component

6. Designing the CICS Java Component
Background to Java and CORBA in a CICS EnvironmentJava in a CICS EnvironmentIntroduction to CORBACICS IIOP SupportUnderstanding What This Component Needs to DoDescribing a Customer Account Object with IDLDesign of the CICS Java ComponentImplementing CICS Java ComponentsWhat’s Next…
7. Programming the CICS Java Component
ToolsSetting Up Your Development EnvironmentCreating and Compiling the IDL DefinitionWriting the Server Implementation ClassExamining the Methods in the _accountInterfaceImpl ClassExporting and Binding the Server Application to the CICS RegionCreating the CORBA ClientCreating the Client ProgramCreate genfac.ior FileCreating the RunClient ClassTesting the ClientWhat’s Next…
IV. The Web Component
8. Designing the Web Component
Understanding What the Component Needs To DoDesigning the Web InterfaceDesigning the Web Server ComponentsThe Java ServletThe JavaBeanThe Java Server Pages (JSP files)Why Design It This Way?Designing the CORBA Client ImplementationWhat’s Next…
9. Programming the Web Component
ToolsInstall and Configure a Web ServerUsing WebSphere StudioServlet ConfigurationBuilding the Web SiteProgramming the Web Server ComponentsCreating a WebSphere Studio ProjectCreating AccountBeanLooking at the coding in AccountBeanCreating KanDoItServletCreating the Java Server Page FileExamining the details of the Java Server PageCreating the Error JSP FileIncorporating the CORBA ClientModifying KanDoItServlet.javaModifying ClientStub.javaPublishing Your FilesTesting the SampleWhat’s Next…
V. The 3270 Interface
10. Designing the Presentation Logic
Understanding What the Presentation Logic Component Needs to DoIBM 3270 Information Display System3270 Field StructurePlanning Your 3270 Screen Layout: Using a Menu ScreenInterface Design PrinciplesIncorporating CICS Design GuidelinesConversational or Pseudo-conversational Transactions?Conversational transactionsPseudo-conversational transactionsHandling ErrorsDesigning the Functions
11. Programming the 3270 Presentation Logic Component
Defining Screens with Basic Mapping Support (BMS)What Is BMS and What Does It Do?Defining a Menu Map Using BMS MacrosThe DFHMDF macro: generate a map definition for a fieldThe DFHMDI macro: generate BMS map definitionThe DFHMSD macro: generate BMS map set definitionRules on macro formatsMap Definitions for the Sample ApplicationDefining the account detail mapNotes on the Account Detail mapDefining the error mapThe MapsetSymbolic Description MapsCopying the Map Structure into a ProgramNotes on DSECTsSending a Map to a TerminalThe SEND MAP CommandUsing SEND MAP in the sample applicationPositioning the CursorSending Control Information Without DataReceiving Input from a TerminalThe RECEIVE MAP commandFinding Out What Key the Operator PressedThe EXEC Interface Block (EIB)AID byte definitionsErrors on BMS CommandsMAPFAIL errorsStarting Another Task, and Other Time ServicesStarting Another TaskRetrieving data passed to the START commandUsing the START and RETRIEVE commands in the sample applicationErrors on the START and RETRIEVE commandsLocal Printing (NACT03): Requests for PrintingWhat’s Next…
VI. The Visual Basic Component
12. Designing the Visual Basic Component
Understanding What the Component Needs to DoDesigning the Graphical User InterfaceDesigning the Log In panelDesigning the Main MenuDesigning the Print FunctionDesigning the Online HelpDesigning the Data ValidationDesigning Access to and Control of the CICS ApplicationUnderstanding the CICS External Call Interface (ECI)Using the ECIInitiating the CICS clientData Conversion Between the CICS Universal Client and CICS Transaction ServerAccessing Applications on the CICS Server with Standard CICS Object-Oriented SupportUsing the CICS Client Component Object Module (COM) librariesAccessing Applications on the CICS Server Using the VisualAge Interspace APICreating the link to the CICS ECICommunicating with the CICS applicationDesigning Error Handling
13. Programming the Visual Basic Program
Writing the Graphical User InterfaceImplementing the Print FunctionImplementing the Online HelpImplementing the Data Validation CodeAccessing Applications on the CICS ServerHandling DataWriting the ECI ComponentMaking an ECI link call to CICSHandling ECI errorsAccessing Applications on the CICS Server with the VisualAge Interspace APICreating the VisualAge Interspace Service for the NACT02 CICS Server ApplicationTesting the VisualAge Interspace ServiceGenerating the Visual Basic module for the serviceIncorporating the generated service module into the Visual Basic projectCoding the required VisualAge Interspace API callsCommunicating with CICSA Digression About TCP62Configuring the ApplicationConfiguring CICS Transaction Server for OS/390 for TCP62Configuring VTAM for OS/390Handling Data ConversionConfiguring the Windows NT HOSTS File on the ClientConfiguring the CICS Universal ClientTesting the TCP62 ConnectionRunning the ACCT ApplicationWhat’s Next….
VII. CICS and MQSeries
14. Designing an Application to Use the MQSeries-CICS Bridge
Background to MQSeriesQueue ManagersHow Applications Identify Themselves to Queue ManagersOpening a QueuePutting and Getting MessagesMessaging Using More Than One Queue ManagerThe MQSeries-CICS BridgeWhen To Use the MQSeries-CICS BridgeDesigning the Graphical User InterfaceDesigning the Java ApplicationConfiguring MQSeriesRunning CICS DPL ProgramsWhy Design It This Way?What’s Next…
15. Programming the MQSeries-CICS Bridge
Building the Java GUICoding the Java ApplicationCoding the Java ApplicationOpening the Relevant MQSeries QueuesCreating the MQSeries MessageAdding the CICS Program Name and COMMAREA Fields to the Message BufferSending the Request Message to the Bridge Queue on MQSeries for OS/390Receiving the Response Message.Checking for CICS-Related ErrorsDisplaying the Relevant InformationSetting Up MQSeries and CICSDefine MQSeries for Windows NTStarting MQSeries for Windows NTSetting Up MQSeries for OS/390Setting Up CICS To Use the MQSeries-CICS BridgeDefining MQSeries for OS/390 ObjectsStarting Your ChannelConnecting to MQSeries from Your CICS RegionStarting the CICS BridgeStarting the Listener on OS/390Running the Application for the WorkstationTroubleshootingWhat’s Next…
VIII. Debugging
16. Debugging in CICS
CICS-Supplied TransactionsEDF: Execution Diagnostic FacilityInterception PointsEDF DisplaysOther Information DisplayedUseful Techniques with EDFEDF OptionsGetting StartedExamples of EDF DisplaysProgram Initiation with EIBAbout to Execute CommandCommand Execution CompleteCommand Sequence for the BrowseWorking StorageTask TerminationSummary
IX. Appendices
A. Configuring Your CICS for OS/390 Environment
Getting ReadyUsing the CD-ROMGetting the Data from the CD-ROMUploading the FilesReceiving the data setsConfiguring the COBOL ComponentSetting up the VSAM FileSetting Up and Installing the CICS Resource DefinitionsRunning the ApplicationConfiguring the CICS Java ComponentDefining Your CICS ResourcesSetting Up CICS Java on OS/390Using the PDF Files for the CICS Main Library
B. List of CD-ROM Files
Files Used by the COBOL Application
Glossary
C. Suggestions for Further Reading
Index
About the Authors
Colophon
Copyright

Content preview from Designing and Programming CICS Applications

Appendix A. Configuring Your CICS for OS/390 Environment

Up until now we have described the individual components in the KanDoIT business application. This appendix explains how to configure your CICS region on OS/390 so that you can run the sample application. The CD-ROM that accompanies this book contains both compiled code and source code.

Warning

The COBOL code has been compiled and is ready to run with CICS TS for OS/390 Version 1.3 and Language Environment (LE) for OS/390 2.8. If you are running any earlier version of CICS or LE you need to compile the source files that are provided.

This chapter is solely concerned with the installation of the compiled sample code.

Before you start to use the application you need to check the systems requirements in Getting Ready.

The COBOL business logic is the core of the sample and is mandatory if you are to use any of the presentation interfaces. Installing the COBOL code supplied includes the 3270 interface so you will be able to use the application (see Configuring the COBOL Component). The other options for the presentation logic are:

The CORBA Server and the web component as described in Configuring the CICS Java Component and “Programming the Web Component” in Chapter 9.
The customer services frontend using Visual Basic as described in Accessing Applications on the CICS Server in Chapter 13.
The MQSeries-CICS bridge as described in Setting Up MQSeries and CICS in Chapter 15.

You will find a complete list of the programs that are provided ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

ABCs of IBM z/OS System Programming Volume 1

Publisher Resources

ISBN: 9781449311933Errata Page

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Designing and Programming CICS Applications

by John Horswill, Members of the CICS Development Team at IBM Hursley