CICS Transaction Server for z/OS Version 4 Release 2

1 cics Transaction Server for z/OSVersion 4 Release 2 Application Programming GuideSC34-7158-02 cics Transaction Server for z/OSVersion 4 Release 2 Application Programming GuideSC34-7158-02 NoteBefore using this information and the product it supports, read the information in Notices on page edition applies to Version 4 Release 2 of cics Transaction Server for z/OS (product number 5655-S97) and toall subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 1989, Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM this manual is should read this you need to know to understand to use this on is not covered in this in cics Transaction Serverfor z/OS, Version 4 Release 1.

2 Writing cics applications .. 1 Chapter 1. Overview: Writing is a cics application?..3 cics programs, transactions and programming interface block (EIB).. for programming 2. Programming languages andLanguage 2. Language Environment .. 11 Language Environment callable Environment abend and Environment languages in Language Environment .. 15 Dynamic Link Libraries (DLLs)..17 Defining runtime options for and CEECSTX user : cics environment exit for Language 3. Programming in COBOL .. 23 COBOL programming restrictions and requirements 24 Language Environment CBLPSHPOP option.

3 27 Using the DL/I CALL COBOL II based addressing with subprograms from COBOL programs .. 30 Flow of control between programs for calling and COBOL3 translator translator actions for COBOL programs .. 37 Batch compilation for COBOL COBOL OS/VS COBOL 4. Programming in C and C++49C and C++ programming restrictions arguments in C and C++..53 Accessing the EIB from C and C++..55 Locale support for C and C++..56 XPLink and C and C++ uses X8 and X9 mode control between XPLink and user exits and 5. Programming in programming restrictions and requirements.. 59 Language Environment coding requirements forPL/I PL/I 6.

4 Programming in language programming restrictions Environment coding requirements forassembly language assembly language 3. Translating, compiling,installing and testing 7. Translation and compilation 73 The integrated cics the integrated cics cics translator translation cics -supplied invocation of the separate translator .. 78 Using a cics translator options COPY cics -supplied interface the EXEC interface Assembly language PROGRAM 8. Installing installation dynamic program LIBRARY resources .. 100 Copyright IBM Corp. 1989, 2013iiiExamples of using dynamic LIBRARY resources 101 Defining MVS residence and addressing modes.

5 110 Establishing a program's addressing mode.. 110 cics address space programs permanently resident .. 111 Running applications in the link pack area .. 112 Running application programs in the RDSAs .. and C/++.. BMS map sets in application programs.. 115 Using the cics -supplied procedures to installapplication programs in load library the cics -supplied interface modules .. 117 Installing assembly language application programs 118 Installing COBOL application JCL to install COBOL PL/I application C application JCL to install C application programs126 Using your own job 9. Installing map sets andpartition map of map physical map symbolic description map sets.

6 138 Installing physical and symbolic descriptionmaps partition programs, map sets, and partition sets 10. Testing applications .. 145 Preparing the application for the system for 11. Execution diagnosticfacility (EDF)..149 Restrictions when using does EDF display?..152 The programs using program EDF in single-screen EDF in dual-screen and remote and non-terminal and DTP typing to make EDF menu 12. Temporary storagebrowse (CEBR)..173 Using the CEBR does the CEBR Transaction display?..174 Using the CEBR function the CEBR the CEBR Transaction with transient data179 Chapter 13.

7 Command-levelinterpreter (CECI)..181 What does CECI display?..181 The command status screen message options on function CECI storage: ENQ commands without 14. Preparing to usedebuggers with cics applications .. 193 Debugging debugging profiles to select programs generic parameters in debugging profiles197 Chapter 15. Debugging cics applications from a workstation .. 199 Preparing to debug applications from 16. Using Debug Tool withCICS Debug to debug applications with Debug Tool 201 Part 4. cics applicationprogramming 17. Application and conversational design 205 Terminal tasks are Transaction ?

8 208 Separating business and presentation logic .. 211 Multithreading: Reentrant, quasi-reentrant, andthreadsafe application applications (REQUIRED) programs .. 221 OPENAPI the FORCEQR system TS for z/OS : Application Programming Guide||Non-reentrant data within a work area (TWA)..226 User in LINK and XCTL commands227 Channels in LINK and XCTL commands .. 227 Program storage transient SHARED own data of areas passed to cics commands .. 231 Minimizing cics from application errors .. 233 Testing Transaction 18. Design for performance235 Program paging control of system NOSUSPEND sequential data set 19.

9 Sharing data the common work area (CWA)..245 Protecting the the TCTTE user area (TCTUA)..249 Using the COMMAREA in RETURN commands249 Using a channel on RETURN the display screen to share 20. Enhanced inter-programdata transfer using : quick and channels: some typical channel, one channel, several programs (a component) 257 Several channels, one interactive a current channel example, with LINK commands 260 Current channel example, with channel: START and scope of a example, with LINK example, with LINK and which containers were passed to which containers were returned from read only a channel: Best and using a channel: an example.

10 271 Channels and BTS channels from routing with is data conversion needed?..275 Preparing for code page conversion conversion with of from COMMAREAs to channels .. 282 Migrating LINK commands that XCTL commands that pseudoconversational COMMAREAson RETURN START programs that use temporary storageto pass dynamically-routed applications .. 285 Chapter 21. Program program logical to another program expecting return .. 288 Passing data to other mixed addressing LINK to pass RETURN to pass 22. of techniques and techniques that avoid affinity .. 304 The ENQ and DEQ commands withENQMODEL resource techniques that create affinities.