IBM SC33-1686-02 x

Notes on terminology

CICS refers to IBM CICS Transaction Server for OS/390 Release 3

VTAM refers to IBM ACF/VTAM

IMS refers to IBM IMS/ESA

TCAM refers to the DCB interface of ACF/TCAM.

xCICS Supplied Transactions

Contents

Main CICS Supplied Transactions Page Page Third edition (March 1999) Contents iv Page Page Notices Trademarks viii CICS Front End Programming Interface User's Guide Preface What this book is about Who should read this book x Bibliography CICS Transaction Server for OS/390 CICS books for CICS Transaction Server for OS/390 CICSPlex SM books for CICS Transaction Server for OS/390 Other CICS books xii OS/390 MVS Diagnosis: Tools and Service Aids MVS/DFP 3.2 System Programming Reference Transaction Processing and Data Collection Kit Page Summary of changes Changes for the CICS Transaction Server for OS/390 release 2 edition Changes for the CICS Transaction Server for OS/390 release 1 edition CICS-Supplied Transactions xvi CICS-Supplied Transactions Changes for the CICS/ESA 4.1 edition Chapter 1. Transactions supplied by CICS transactions Upgrading CICS transactions How to start or stop a transaction Syntax notation and conventions used in this book Uppercase input to transactions 2 master terminal operator supervisory terminal operator Operator security all class Resource Access Control Facility (RACF): Security Administrators Guide Terminal operator Master terminal operator master terminal operator 4 MRO and ISC support Partitions and the execution diagnostic facility Partitions and the command interpreter PA1 print key Routing and multiple partitions Terminal paging Rules for console entry MODIFY command 6 REPLY command Example of a conversation using CONVERSE Example of a conversation using WRITE/READ Time sharing option (TSO) consoles Page Page Page Chapter 3. CDBCdatabase control menu CICS IMS Database Control Guide Connecting CICS to DBCTL Disconnecting CICS from DBCTL CDBCdatabase control menu Specifying a DBCTL system identifier (DBCTLID) CICS IMS Database Control Guide 12 Chapter 4. CDBIdatabase control inquiry CICS IMS Database Control Page Chapter 5. CDBMdatabase control interface R SAMPLE STA C 16 Key The CICS-DBCTL interface CICS IMS Database Control The HELP panels 18 Chapter 6. CEBRtemporary storage browse ANY active task. CEBRtemporary storage browse 20 Note: .1/Header .2/Command line .3/Body .4/Message line .5/Menu of options Figure 14. Typical CEBR displayof defaulttemporary storage queue . If you press the help key (PF1), the following panel is Chapter 7. CEBTmaster terminal (alternate CICS) CEBT INQUIRE and SET commands CEBT INQUIRE AUXTRACE Function: Description: CEBT INQUIRE DUMP Function: 22 Description: Input: CEBT INQUIRE GTFTRACE Function: Description: Displayed fields CEBT INQUIRE INTTRACE Function: Description: CEBT INQUIRE SURVEILLANCE Function: 24 CICS/ESA 3.3 XRF Guide CEBT INQUIRE TAKEOVER CEBT PERFORM commands CEBT PERFORM SHUTDOWN Function: Description: Options CEBT PERFORM SNAP CEBT PERFORM TAKEOVER 26 CEBT SET AUXTRACE Function: Description: Options CEBT SET DUMP CEBT SET GTFTRACE CEBT SET DUMP Function: Description: 28 Options CEBT SET GTFTRACE CEBT SET INTTRACE Function: Description: Options CEBT SET SURVEILLANCE Function: CEBT SET TAKEOVER Function: 30 Options Chapter 8. CECIcommand-level interpreter CICS Application Programming Reference CECI/CECScommand-level interpreter CICS Application Programming Guide 32 Command-level syntax-checking transaction (CECS) Chapter 9. CEDAresource definition online 34 | | | Figure 21. CEDA transaction: INSTALLscreen CICS Resource Definition Guide 36 processes CICS Resource Definition CSD compatibility panel Figure 22. CEDA transaction: normalpanel 38 Figure 23. CEDA transaction: normalpanel (continued) Figure 25. CEDA transaction: compatibilitymode panel Figure 28. CEDA transaction: HELPPanel 2 Chapter 9. Resource definition online CEDA 39 Figure 29. CEDA transaction: HELPPanel 3 Figure 30. CEDA transaction: HELPPanel 4 CEDB and CEDC CEDB 40 CEDC Chapter 10. CEDF & CEDX the execution diagnostic facility single-screen mode CICS Application Programming Guide CEDF transaction Beginning an EDF session (dual-screen mode) dual-screen mode 42 CICS RACF Security Guide tranid after Page Chapter 11. CEMTmaster terminal Starting the CEMT transaction System parameters Program function (PF) keys 46 ALL option CLASS option CICS Resource Definition Family of resources (using * and + symbols) List of resource identifiers: Subdefining resource groups Tab key Scrolling symbol (+ sign) 48 Blank fields in a display Using the ? key Variables Invoking CEMT from an application program CICS Front End Programming Interface User's Guide CICS Security checking CEMT DISCARD 50 can nn DFHJ01 52 CEMT INQUIRE commands CEMT INQUIRE AUTINSTMODEL Function: Description: Sample screen CEMT INQUIRE AUTOINSTALL Function: Description: 54 Sample screen Displayed fields CEMT INQUIRE AUXTRACE Function: Description: Sample screen CEMT INQUIRE AUXTRACE 56 value) (input only field Displayed fields CEMT INQUIRE CONNECTION CEMT INQUIRE CONNECTION Function: Description: 58 Sample screen Page value) (appc only 60 appc and mro only vtam only and irc only appc and mro only input-only field 62 CEMT INQUIRE DB2CONN Function: Description: Sample screen Displayed fields 64 Page 66 CEMT INQUIRE DB2ENTRY Function: Description: Input: Sample screen 68 Page CEMT INQUIRE DB2TRAN CEMT INQUIRE DELETSHIPPED CEMT INQUIRE DB2TRAN inactive 70 Function: Description: CEMT INQUIRE DSAS CEMT INQUIRE DSAS Function: 72 Description: Input: CEMT INQUIRE DSNAME CEMT INQUIRE DSNAME Function: Description: 74 Sample screen Page in-doubt 76 Page 78 CEMT INQUIRE DUMPDS Function: Description: Input: Sample screen 80 unless CEMT INQUIRE ENQMODEL 82 CEMT INQUIRE EXCI Function: Description: Sample screen Displayed fields CEMT INQUIRE FEPI Comments: 84 CICS Front End Programming Interface User's CEMT INQUIRE FILE Function: Description: Sample screen name 86 BDAM only 88 CEMT INQUIRE GTFTRACE Function: Description: Sample screen Displayed fields CEMT INQUIRE INTTRACE CEMT INQUIRE IRBATCH CEMT INQUIRE INTTRACE Function: Description: 90 Sample screen Displayed fields CEMT INQUIRE IRC Displayed fields Function: Description: Input: Sample screen CEMT INQUIRE JMODEL Function: 92 Description: Sample screen CEMT INQUIRE JOURNALNAME Function: Description: Input Sample screen CEMT INQUIRE LINE Function: 94 Sample screen CEMT INQUIRE MODENAME Function: Description: Sample screen CEMT INQUIRE MODENAME 96 Displayed fields CEMT INQUIRE MONITOR Displayed fields Function: Description: Sample screen 98 Performance Guide CEMT INQUIRE NETNAME Sample screen Function: Description: Displayed fields 100 Page CEMT INQUIRE PARTNER data-area CEMT INQUIRE PARTNER Function: Description: 102 Sample screen Displayed fields CEMT INQUIRE PROCESSTYPE 104 and CICS Business Transaction Services CEMT INQUIRE PROFILE Function: Description: Input: Sample screen Displayed fields 106 Page 108 Page CEMT INQUIRE REQUESTMODEL CEMT INQUIRE RRMS 110 (name) CEMT INQUIRE STATISTICS Function: Description: CICS Operations and Utilities Guide Sample screen Displayed fields 112 CEMT INQUIRE STREAMNAME Function: Description: Sample screen Displayed fields CEMT INQUIRE SYDUMPCODE Function: 114 Description: Sample screen OS/390 MVS Diagnosis: Tools and Service Aids CEMT INQUIRE SYSTEM CEMT INQUIRE SYSTEM pgrmid 116 vvrrmm Function: Description: pgrmid 118 CEMT INQUIRE TASK Function: Description: 120 Page 122 CEMT INQUIRE TCLASS Function: Description: Sample screen Displayed fields 124 CEMT INQUIRE TDQUEUE CEMT INQUIRE TDQUEUE extrapartition queues only 126 Function: Description: value) (intrapartition queues only extrapartition queues only value) (intrapartition queues only 128 CEMT INQUIRE TERMINAL Function: Description: Sample screen 130 Page data-area 132 CEMT INQUIRE TRANSACTION Function: Description: Sample screen Displayed fields 134 Page CEMT INQUIRE TRDUMPCODE CEMT INQUIRE TRDUMPCODE Function: 136 Description: Sample screen CEMT INQUIRE TSMODEL 138 CEMT INQUIRE TSQUEUE / TSQNAME CEMT INQUIRE TSQUEUE / TSQNAME Function: 140 Description: Sample screen Displayed fields CEMT INQUIRE UOW CICS CEMT INQUIRE UOW Function: 142 Description: Page 144 CEMT INQUIRE UOWDSNFAIL Function: Description: Input: 146 Recovery and Restart Guide non-rls data sets only CICS Recovery and Restart Guide CEMT INQUIRE UOWENQ CEMT INQUIRE UOWENQ unless 148 Description: Page 150 CEMT INQUIRE UOWLINK Function: Description: Sample screen Displayed fields 152 CEMT INQUIRE VTAM Function: Description: Input: Sample screen 154 CEMT PERFORM commands CEMT PERFORM DELETSHIPPED Function: Description: Syntax CEMT PERFORM DUMP|SNAP Function: Description: 156 Syntax Options CEMT PERFORM RESET Function: Syntax CEMT PERFORM SECURITY Function: CEMT PERFORM SHUTDOWN Function: 158 Syntax Options CEMT PERFORM STATISTICS CICS Operations and Utilities Guide Function: Description: Syntax CEMT SET commands 160 CEMT SET AUTOINSTALL Function: Description: Options CEMT SET AUXTRACE CEMT SET AUXTRACE Function: Description: 162 Options CEMT SET CONNECTION Function: Description: Options appc and lu6.1 only 164 appc and cics-to-cics mro only Systems Network ArchitectureLU6.2 Reference: Peer Protocols vtam only and irc only mro to CICS Transaction Server for OS/390 and later systems and appc only 166 before CEMT SET DB2CONN Function: Syntax: Options 168 Page 170 DB2ID can only be changed by stopping and restarting the attachment CEMT SET DB2ENTRY Function: Description: 172 Page CEMT SET DB2TRAN CEMT SET DB2TRAN Function: 174 Description: Options CEMT SET DELETSHIPPED inactive Function: Syntax: Options CEMT SET DSAS Function: 176 Options CEMT SET DSNAME Options CEMT SET DSNAME 178 in-doubt CEMT SET DUMPDS Function: Description: Options CEMT SET FEPI CEMT SET FILE CEMT SET FEPI Front End Programming Interface User's Guide 180 Comments: CEMT SET FILE Page 182 CICS Recovery and Restart Guide CEMT SET GTFTRACE CEMT SET INTTRACE CEMT SET GTFTRACE Function: Description: 184 Options CEMT SET INTTRACE CEMT SET IRC Function: Description: Options CEMT SET JOURNALNAME CEMT SET LINE CEMT SET JOURNALNAME Function: Description: 186 Syntax Options CEMT SET MODENAME Function: Description: Options CEMT SET MONITOR CEMT SET MONITOR CICS Customization Guide 188 Function: Description: Options CEMT SET NETNAME CEMT SET NETNAME Function: Description: 190 Options value) (vtam only and OFF CEMT SET PROGRAM CEMT SET PROGRAM Function: Description: 192 Options CEMT SET QUEUE CEMT SET STATISTICS CEMT SET QUEUE Operations and Utilities Guide 194 Comments: CEMT SET STATISTICS CEMT SET SYDUMPCODE CEMT SET SYDUMPCODE Function: 196 Description: Options OS/390 MVS Diagnosis: Tools and Service Aids CEMT SET SYSTEM CEMT SET SYSTEM CICS System Definition Guide 198 Function: Syntax: Options CEMT SET TASK CEMT SET TASK Function: Description: 200 Options CEMT SET TCLASS Function: Options CEMT SET TCPIPSERVICE 202 CEMT SET TDQUEUE Function: Description: Options CEMT SET TERMINAL CEMT SET TERMINAL Function: Description: 204 Options value) (vtam only CEMT SET TRANSACTION CEMT SET TRANSACTION Tcl 206 Tcl Function: CEMT SET TRDUMPCODE Function: Description: Options CEMT SET TSQUEUE 208 CEMT SET UOW Function: Description: Syntax Options CEMT SET UOWLINK CEMT SET VTAM Function: 210 Options Page Page ceot xxxx nnn netname 214 Chapter 13. CESFsign off CICS Application Programming Reference Page Chapter 14. CESNsign on IBM 3270 family display devices CESNsign on Non-3270 family terminal CICS RACF Security Guide 218 Command options Signing off with CESN Chapter 15. CESTsupervisory terminal Page Chapter 16. CETRtrace control Component trace options Transaction and terminal-related trace options 222 Chapter 16. Trace control CETR 223 Figure 149. CETR transaction: HELPpanel (2) HELP panels If you press the help key (PF1), the following panels are 224 Figure 154. CETR transaction: Componenttrace HELPpanel (3) Figure 155. CETR transaction: Componenttrace HELPpanel (4) | Figure 156. CETR transaction: Componenttrace HELPpanel (5) HELP panels for terminal and transaction trace Chapter 16. Trace control CETR 225 Figure 158. CETR transaction: Terminaland transactionHELP panel (1) Figure 159. CETR transaction: Terminaland transactionHELP panel (2) Figure 160. CETR transaction: Terminaland transactionHELP panel (3) Page Chapter 17. CINDin-doubt testing tool Running the CIND in-doubt tool CINDin-doubt testing tool Inquiring on the status of CIND Running the in-doubt tool using an EXEC CICS LINK command 228 Setting a single transaction in-doubt Chapter 18. CMACmessages and codes display Page Chapter 19. CMSGmessage switching Sending a message Canceling a message Message-switching continuation 232 Message delivery Subsystems and terminal systems IBM 3270 display devices IBM 3767 Communication Terminal Sequential terminal CMSG command options 234 Page title 236 title Page termid/opid,... 238 Logical unit destinations Logical device codes Examples of 3600 and 3770 batch destinations 240 Message-switching responses 242 Page 244 Examples of complete message-switching transactions Page Chapter 20. CRTEremote transactions Page Chapter 21. CSFEterminal and system test Terminal test System spooling interface trace Terminal builder trace Debug functions 250 Storage freeze Storage violation trap Global trap/trace program exit and global kernel exit Page Chapter 22. CSPGpage retrieval Retrieve a page Single keystroke retrieval (SKR) System Definition Guide 254 Page retrieval for logical devices Page retrieval and partitions Display information about logical messages message chaining Message chaining Message termination 256 Copying pages Status of hardcopy terminal Routed pages displayed at terminal Page Chapter 23. CWTOwrite to console operator Page Chapter 24. DSNCCICS DB2 transaction DSNC CICS DB2 Guide Page Appendix. List of CICS transactions Appendix 264 Index Special Characters A 266 B C 268 Page 270 Page D 272 Page E 274 F G H 276 I J K 278 L M N 280 Page O 282 P 284 Q R 286 S 288 Page T 290 Page 292 U V W 294 X Y Z Page Sending your comments to IBM