System Programming Reference - IBM

CICS Transaction Server for z/OS 5.4

System Programming Reference

IBM

Note Before using this information and the product it supports, read the information in "Notices" on page 773.

This edition applies to the IBM CICS? Transaction Server for z/OS? Version 5 Release 4 (product number 5655-Y04) and to all subsequent releases and modifications until otherwise indicated in new editions. ? Copyright International Business Machines Corporation 1974, 2020. US Government Users Restricted Rights ? Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

About this PDF......................................................................................................ix

Chapter 1. Introduction to system programming commands................................... 1

Command format......................................................................................................................................... 2 CICS syntax notation....................................................................................................................................2

Summary of format rules........................................................................................................................4 CICS command argument values................................................................................................................ 5

Data-areas and data-values................................................................................................................... 5 Pointer arguments.................................................................................................................................. 6 CICS-value data areas (CVDAs)............................................................................................................. 6 CVDA examples...................................................................................................................................... 7 Data types............................................................................................................................................... 9 COBOL argument values.........................................................................................................................9 C and C++ argument values................................................................................................................. 10 PL/I argument values........................................................................................................................... 10 Assembler language argument values.................................................................................................11 Argument lengths................................................................................................................................. 12 Null values............................................................................................................................................ 12 Exception conditions..................................................................................................................................12 RESP and RESP2 options..................................................................................................................... 13 Security checking.......................................................................................................................................13 Inquiry commands.....................................................................................................................................17 Browsing resource definitions................................................................................................................... 18 Starting a browse..................................................................................................................................19 Retrieving the next resource................................................................................................................ 20 Ending the browse................................................................................................................................21 Browse example................................................................................................................................... 21 Rules for browsing................................................................................................................................21 Exception conditions for browsing.......................................................................................................22 SET commands.......................................................................................................................................... 22 Creating resource definitions.................................................................................................................... 23 The ATTRIBUTES option...................................................................................................................... 24 Discarding resource definitions........................................................................................................... 26 Exit-related commands............................................................................................................................. 27 Defining exits........................................................................................................................................ 27 Exit names............................................................................................................................................ 27 CICS threadsafe commands in the SPI..................................................................................................... 28 SPI commands that can be audited.......................................................................................................... 28

Chapter 2. System commands.............................................................................. 31

RESP2 values for CREATE and CSD commands ....................................................................................... 31 ACQUIRE TERMINAL..................................................................................................................................60 COLLECT STATISTICS................................................................................................................................ 62 CREATE ATOMSERVICE............................................................................................................................. 70 CREATE BUNDLE........................................................................................................................................ 72 CREATE CONNECTION...............................................................................................................................73 CREATE DB2CONN.....................................................................................................................................77 CREATE DB2ENTRY....................................................................................................................................80 CREATE DB2TRAN..................................................................................................................................... 83 CREATE DOCTEMPLATE.............................................................................................................................85

iii

CREATE ENQMODEL.................................................................................................................................. 87 CREATE FILE.............................................................................................................................................. 89 CREATE IPCONN........................................................................................................................................ 92 CREATE JOURNALMODEL..........................................................................................................................95 CREATE JVMSERVER................................................................................................................................. 97 CREATE LIBRARY....................................................................................................................................... 99 CREATE LSRPOOL.................................................................................................................................... 101 CREATE MAPSET......................................................................................................................................105 CREATE MQCONN.................................................................................................................................... 106 CREATE MQMONITOR............................................................................................................................. 108 CREATE PARTITIONSET.......................................................................................................................... 109 CREATE PARTNER....................................................................................................................................111 CREATE PIPELINE................................................................................................................................... 113 CREATE PROCESSTYPE........................................................................................................................... 114 CREATE PROFILE..................................................................................................................................... 116 CREATE PROGRAM.................................................................................................................................. 119 CREATE SESSIONS.................................................................................................................................. 121 CREATE TCPIPSERVICE...........................................................................................................................124 CREATE TDQUEUE................................................................................................................................... 127 CREATE TERMINAL..................................................................................................................................131 CREATE TRANCLASS............................................................................................................................... 134 CREATE TRANSACTION...........................................................................................................................136 CREATE TSMODEL................................................................................................................................... 139 CREATE TYPETERM................................................................................................................................. 141 CREATE URIMAP......................................................................................................................................145 CREATE WEBSERVICE............................................................................................................................. 149 CSD ADD...................................................................................................................................................150 CSD ALTER............................................................................................................................................... 153 CSD APPEND............................................................................................................................................156 CSD COPY.................................................................................................................................................159 CSD DEFINE............................................................................................................................................. 163 CSD DELETE............................................................................................................................................. 167 CSD DISCONNECT................................................................................................................................... 169 CSD ENDBRGROUP..................................................................................................................................170 CSD ENDBRLIST...................................................................................................................................... 170 CSD ENDBRRSRCE...................................................................................................................................171 CSD GETNEXTGROUP..............................................................................................................................172 CSD GETNEXTLIST.................................................................................................................................. 173 CSD GETNEXTRSRCE...............................................................................................................................174 CSD INQUIREGROUP...............................................................................................................................175 CSD INQUIRELIST................................................................................................................................... 176 CSD INQUIRERSRCE................................................................................................................................178 CSD INSTALL............................................................................................................................................181 CSD LOCK................................................................................................................................................. 184 CSD REMOVE........................................................................................................................................... 186 CSD RENAME........................................................................................................................................... 188 CSD STARTBRGROUP.............................................................................................................................. 191 CSD STARTBRLIST................................................................................................................................... 192 CSD STARTBRRSRCE............................................................................................................................... 193 CSD UNLOCK............................................................................................................................................194 CSD USERDEFINE.................................................................................................................................... 196 DISABLE PROGRAM.................................................................................................................................200 DISCARD ATOMSERVICE.........................................................................................................................203 DISCARD AUTINSTMODEL...................................................................................................................... 203 DISCARD BUNDLE................................................................................................................................... 204 DISCARD CONNECTION.......................................................................................................................... 205 DISCARD DB2CONN................................................................................................................................ 207 DISCARD DB2ENTRY............................................................................................................................... 208

iv

DISCARD DB2TRAN.................................................................................................................................208 DISCARD DOCTEMPLATE........................................................................................................................ 209 DISCARD ENQMODEL..............................................................................................................................210 DISCARD FILE..........................................................................................................................................211 DISCARD IPCONN................................................................................................................................... 212 DISCARD JOURNALMODEL..................................................................................................................... 213 DISCARD JOURNALNAME....................................................................................................................... 213 DISCARD JVMSERVER.............................................................................................................................214 DISCARD LIBRARY.................................................................................................................................. 215 DISCARD MQCONN..................................................................................................................................216 DISCARD MQMONITOR........................................................................................................................... 217 DISCARD PARTNER................................................................................................................................. 218 DISCARD PIPELINE................................................................................................................................. 219 DISCARD PROCESSTYPE.........................................................................................................................220 DISCARD PROFILE...................................................................................................................................220 DISCARD PROGRAM................................................................................................................................221 DISCARD TCPIPSERVICE........................................................................................................................ 222 DISCARD TDQUEUE.................................................................................................................................223 DISCARD TERMINAL............................................................................................................................... 224 DISCARD TRANCLASS............................................................................................................................. 226 DISCARD TRANSACTION........................................................................................................................ 226 DISCARD TSMODEL................................................................................................................................. 228 DISCARD URIMAP................................................................................................................................... 228 DISCARD WEBSERVICE...........................................................................................................................229 ENABLE PROGRAM.................................................................................................................................. 231 EXTRACT EXIT......................................................................................................................................... 237 EXTRACT STATISTICS..............................................................................................................................238 INQUIRE ASSOCIATION..........................................................................................................................247 INQUIRE ASSOCIATION LIST................................................................................................................. 258 INQUIRE ATOMSERVICE......................................................................................................................... 261 INQUIRE AUTINSTMODEL...................................................................................................................... 264 INQUIRE AUTOINSTALL.......................................................................................................................... 265 INQUIRE BRFACILITY............................................................................................................................. 267 INQUIRE BUNDLE....................................................................................................................................270 INQUIRE BUNDLEPART........................................................................................................................... 274 INQUIRE CAPDATAPRED.........................................................................................................................276 INQUIRE CAPINFOSRCE......................................................................................................................... 279 INQUIRE CAPOPTPRED...........................................................................................................................281 INQUIRE CAPTURESPEC......................................................................................................................... 283 INQUIRE CONNECTION.......................................................................................................................... 289 INQUIRE CFDTPOOL................................................................................................................................297 INQUIRE DB2CONN.................................................................................................................................299 INQUIRE DB2ENTRY............................................................................................................................... 307 INQUIRE DB2TRAN................................................................................................................................. 312 INQUIRE DELETSHIPPED........................................................................................................................314 INQUIRE DISPATCHER............................................................................................................................ 316 INQUIRE DOCTEMPLATE.........................................................................................................................319 INQUIRE DSNAME................................................................................................................................... 323 INQUIRE DUMPDS...................................................................................................................................328 INQUIRE ENQ.......................................................................................................................................... 329 INQUIRE ENQMODEL.............................................................................................................................. 331 INQUIRE EPADAPTER............................................................................................................................. 334 INQUIRE EPADAPTERSET....................................................................................................................... 339 INQUIRE EPADAPTINSET........................................................................................................................341 INQUIRE EVENTBINDING....................................................................................................................... 343 INQUIRE EVENTPROCESS.......................................................................................................................345 INQUIRE EXCI..........................................................................................................................................346 INQUIRE EXITPROGRAM........................................................................................................................ 348

v

INQUIRE FILE.......................................................................................................................................... 354 INQUIRE HOST........................................................................................................................................ 366 INQUIRE IPCONN.................................................................................................................................... 368 INQUIRE IPFACILITY.............................................................................................................................. 376 INQUIRE IRC............................................................................................................................................377 INQUIRE JOURNALMODEL..................................................................................................................... 378 INQUIRE JOURNALNAME....................................................................................................................... 381 INQUIRE JOURNALNUM......................................................................................................................... 382 INQUIRE JVMSERVER............................................................................................................................. 383 INQUIRE LIBRARY...................................................................................................................................387 INQUIRE MODENAME............................................................................................................................. 392 INQUIRE MONITOR................................................................................................................................. 394 INQUIRE MQCONN.................................................................................................................................. 398 INQUIRE MQINI.......................................................................................................................................401 INQUIRE MQMONITOR........................................................................................................................... 403 INQUIRE MVSTCB....................................................................................................................................406 INQUIRE NETNAME.................................................................................................................................408 INQUIRE OSGIBUNDLE........................................................................................................................... 409 INQUIRE OSGISERVICE.......................................................................................................................... 412 INQUIRE PARTNER..................................................................................................................................413 INQUIRE PIPELINE..................................................................................................................................415 INQUIRE PROCESSTYPE......................................................................................................................... 419 INQUIRE PROFILE................................................................................................................................... 422 INQUIRE PROGRAM................................................................................................................................ 425 INQUIRE REQID.......................................................................................................................................436 INQUIRE RRMS........................................................................................................................................440 INQUIRE STATISTICS.............................................................................................................................. 440 INQUIRE STORAGE..................................................................................................................................442 INQUIRE STREAMNAME..........................................................................................................................445 INQUIRE SUBPOOL................................................................................................................................. 446 INQUIRE SYSDUMPCODE........................................................................................................................448 INQUIRE SYSTEM.................................................................................................................................... 451 INQUIRE TASK......................................................................................................................................... 462 INQUIRE TASK LIST.................................................................................................................................472 INQUIRE TCLASS.....................................................................................................................................473 INQUIRE TCPIP....................................................................................................................................... 474 INQUIRE TCPIPSERVICE.........................................................................................................................476 INQUIRE TDQUEUE................................................................................................................................. 484 INQUIRE TEMPSTORAGE........................................................................................................................ 492 INQUIRE TERMINAL................................................................................................................................492 INQUIRE TRACEDEST..............................................................................................................................509 INQUIRE TRACEFLAG..............................................................................................................................511 INQUIRE TRACETYPE..............................................................................................................................513 INQUIRE TRANCLASS............................................................................................................................. 516 INQUIRE TRANDUMPCODE.....................................................................................................................519 INQUIRE TRANSACTION.........................................................................................................................522 INQUIRE TSMODEL................................................................................................................................. 531 INQUIRE TSPOOL.................................................................................................................................... 534 INQUIRE TSQUEUE / TSQNAME..............................................................................................................535 INQUIRE UOW......................................................................................................................................... 540 INQUIRE UOWDSNFAIL.......................................................................................................................... 544 INQUIRE UOWENQ.................................................................................................................................. 548 INQUIRE UOWLINK................................................................................................................................. 553 INQUIRE URIMAP....................................................................................................................................557 INQUIRE VOLUME................................................................................................................................... 564 INQUIRE VTAM........................................................................................................................................ 564 INQUIRE WEB..........................................................................................................................................567 INQUIRE WEBSERVICE........................................................................................................................... 568

vi

INQUIRE WLMHEALTH............................................................................................................................ 573 INQUIRE WORKREQUEST....................................................................................................................... 574 INQUIRE XMLTRANSFORM..................................................................................................................... 575 PERFORM DELETSHIPPED...................................................................................................................... 578 PERFORM DUMP...................................................................................................................................... 579 PERFORM ENDAFFINITY.........................................................................................................................581 PERFORM PIPELINE................................................................................................................................ 582 PERFORM RESETTIME............................................................................................................................ 584 PERFORM SECURITY REBUILD............................................................................................................... 584 PERFORM SHUTDOWN............................................................................................................................585 PERFORM SSL REBUILD.......................................................................................................................... 588 PERFORM STATISTICS RECORD............................................................................................................. 590 RESYNC ENTRYNAME..............................................................................................................................596 SET ATOMSERVICE.................................................................................................................................. 598 SET AUTOINSTALL................................................................................................................................... 599 SET BRFACILITY...................................................................................................................................... 600 SET BUNDLE............................................................................................................................................ 601 SET CONNECTION................................................................................................................................... 604 SET DB2CONN......................................................................................................................................... 612 SET DB2ENTRY........................................................................................................................................ 622 SET DB2TRAN.......................................................................................................................................... 628 SET DELETSHIPPED................................................................................................................................ 629 SET DISPATCHER.....................................................................................................................................631 SET DOCTEMPLATE................................................................................................................................. 633 SET DSNAME............................................................................................................................................635 SET DUMPDS............................................................................................................................................643 SET ENQMODEL....................................................................................................................................... 645 SET EPADAPTER...................................................................................................................................... 646 SET EPADAPTERSET................................................................................................................................647 SET EVENTBINDING................................................................................................................................648 SET EVENTPROCESS............................................................................................................................... 649 SET FILE................................................................................................................................................... 650 SET HOST................................................................................................................................................. 663 SET IPCONN.............................................................................................................................................664 SET IRC.................................................................................................................................................... 669 SET JOURNALNAME................................................................................................................................ 670 SET JOURNALNUM.................................................................................................................................. 672 SET JVMSERVER...................................................................................................................................... 673 SET LIBRARY............................................................................................................................................675 SET MODENAME...................................................................................................................................... 678 SET MONITOR..........................................................................................................................................680 SET MQCONN...........................................................................................................................................685 SET MQMONITOR.................................................................................................................................... 688 SET NETNAME......................................................................................................................................... 690 SET PIPELINE....................................................................................................................................... 691 SET PROCESSTYPE.................................................................................................................................. 692 SET PROGRAM......................................................................................................................................... 695

Using the SET PROGRAM OPERATION command to experiment with application context............ 700 SET STATISTICS.......................................................................................................................................701 SET SYSDUMPCODE................................................................................................................................ 705 SET SYSTEM.............................................................................................................................................709 SET TASK..................................................................................................................................................715

Purging Java tasks..............................................................................................................................717 SET TCLASS..............................................................................................................................................717 SET TCPIP................................................................................................................................................ 718 SET TCPIPSERVICE................................................................................................................................. 720 SET TDQUEUE.......................................................................................................................................... 723 SET TEMPSTORAGE.................................................................................................................................727

vii

SET TERMINAL.........................................................................................................................................729 SET TRACEDEST...................................................................................................................................... 737 SET TRACEFLAG...................................................................................................................................... 740 SET TRACETYPE.......................................................................................................................................742 SET TRANCLASS...................................................................................................................................... 746 SET TRANDUMPCODE............................................................................................................................. 747 SET TRANSACTION................................................................................................................................. 751 SET TSQUEUE / TSQNAME...................................................................................................................... 754 SET UOW.................................................................................................................................................. 756 SET UOWLINK..........................................................................................................................................757 SET URIMAP............................................................................................................................................ 758 SET VOLUME............................................................................................................................................ 760 SET VTAM................................................................................................................................................. 761 SET WEB...................................................................................................................................................764 SET WEBSERVICE...................................................................................................................................765 SET WLMHEALTH..................................................................................................................................... 766 SET XMLTRANSFORM.............................................................................................................................. 767 Threadsafe SPI commands..................................................................................................................... 768

Additional Threadsafe Commands.................................................................................................... 772

Notices.............................................................................................................. 773 Index................................................................................................................ 779

viii

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download