IBM SC33-1686-02 - Manuals

Notices This information was developed for products and services offered in the U.S.A. IBM may notoffer the products, services, or features discussed in this document in other countries.Consult your local IBM representative for information on the products and services currentlyavailable in your area...

Trademarks The following terms are trademarks of International Business Machines Corporation in theUnited States, or other countries, or both: Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. inthe United States, other countries, or both. Other company, product, ...

Preface What this book is about This book tells you how to start the transactions supplied with CICS  . It tells you how to control the CICS system, how to send messages, how to collect statistics, and how to getterminal error information. It is also useful if you are responsible for preparing proc...

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. x CICS Supplied Transactions

Bibliography CICS Transaction Server for OS/390 CICS Transaction Server for OS/390: Planning for Installation GC33-1789 CICS Transaction Server for OS/390 Release Guide GC34-5352 CICS Transaction Server for OS/390 Migration Guide GC34-5353 CICS Transaction Server for OS/390 Installation Guide GC33-1...

CICSPlex SM books for CICS Transaction Server for OS/390 General CICSPlex SM Master Index SC33-1812 CICSPlex SM Concepts and Planning GC33-0786 CICSPlex SM User Interface Guide SC33-0788 CICSPlex SM View Commands Reference Summary SX33-6099 Administration and Management CICSPlex SM Administration SC...

Subsequent updates will probably be available in softcopy before they are available inhardcopy. This means that at any time from the availability of a release, softcopy versionsshould be regarded as the most up-to-date. For CICS Transaction Server books, these softcopy updates appear regularly on th...

Summary of changes This edition is based on the CICS Transaction Server for OS/390 Release 2 edition,SC33-1686-01. Changes for this edition are marked by vertical bars to the left of the text. | Changes for this edition | Changes include: | Ÿ The CEMT transaction is extended to support the new resou...

Changes for the CICS Transaction Server for OS/390 release 1 edition This edition is based on the CICS/ESA 4.1 CICS-Supplied Transactions manual (SC33-0710-00). For CICS Transaction Server for OS/390, the following changes have been made: Ÿ Removal of local DL/I and CEMT INQUIRE and SET PITRACE Ÿ Ad...

introduction Chapter 1. Transactions supplied by CICS CICS provides operations, usually initiated from terminals,called transactions, each of which involves the use of CICS tables, programs, and internal services. This book deals withthose transactions that are supplied by CICS and which, inaddition...

introduction Syntax notation and conventions used inthis book Each command has a syntax box to show you what optionsthere are. You interpret the syntax by following the arrows from left toright. The conventions are: Minimum abbreviation of keywords In general, the CICS transactions accept as few cha...

introduction | $ (the dollar symbol) | In the character sets given in this book, the dollar symbol ($)| is used as a national currency symbol and is assumed to be| assigned the EBCDIC code point X'5B'. In some countries a| different currency symbol, for example the pound symbol (£),| or the yen symb...

introduction Master terminal operator The master terminal operator controls system componentsusing the master terminal transaction, CEMT. With thistransaction, the master terminal operator can dynamicallychange the system control parameters. Although the transaction can be started at any valid IBM32...

introduction Partitions and the execution diagnosticfacility The execution diagnostic facility (EDF), invoked by CEDF, isnot available in single-screen mode on a terminal inpartitioned state. EDF must be used in dual-screen mode fordebugging application programs that use partitions. Partitions and t...

introduction messages from other terminals and consoles, as well as fromCICS transactions. In a system that has consoles and VTAM terminals, aconsole can remain active when CICS and VTAM aredisconnected from each other. You can use the console tomake or break the CICS-VTAM connection without CICSbei...

CBAM—BTS browser | Chapter 2. CBAM—BTS browser | Use CBAM to browse the CICS business transaction| services (BTS) objects (process-types, processes, activities,| containers, events and timers) known to this region. CBAM is| described in the CICS Business Transaction Services | manual.  Copyright IB...

CDBC—database control menu Chapter 3. CDBC—database control menu Use CDBC to connect CICS to DBCTL, or to disconnectCICS from DBCTL. CDBC is applicable only to CICSsystems using the IMS/ESA Database Control (DBCTL)interface. For detailed guidance on using the CDBCtransaction with databases controlle...

CDBC—database control menu The following display shows you the effect of asking foroption 2: à ð CDBC CICS-DBCTL CONNECTION/DISCONNECTION 93.259 13:39:2ð Select one of the following: 1 Connection2 ORDERLY disconnection3 IMMEDIATE disconnection Option Selection ==> 2 Startup Table Suffix ==> ðð...

CDBI–database control inquiry Chapter 4. CDBI—database control inquiry Use CDBI to inquire about the status of the interfacebetween CICS and DBCTL. You can start CDBI from 3270(and 3270-like) terminals or from the operating systemconsole. For detailed information about the CICS-DBCTL interfaceand gu...

CDBM–database control interface Chapter 5. CDBM—database control interface Use the CDBM transaction to issue DBCTL operatorcommands from a CICS terminal. CDBM is applicable only toCICS systems using the IMS/ESA Database Control(DBCTL) interface. | CDBM also provides a means of maintaining a command ...

CDBM–database control interface à ð CDBM CICS-DBCTL IMS Responses Screen 1 Responses 1 to 18 More: + DATABASE TYPE TOTAL UNUSED TOTAL UNUSED ACC CONDITIONS ACCUNTDB UP STOPPED, NOTOPEN, NOTINIT ADMIDX1 UP STOPPED, NOTOPEN, NOTINIT ADMOBJ1 UP STOPPED, NOTOPEN, NOTINIT ADMOBJ2 UP STOPPED, NOTOPEN, NOT...

CDBM–database control interface | à | ð | CDBM CICS/DBCTL COMMAND GROUP MAINTENANCE | _ ACTION A add B browse D delete R read U update | ____________ GROUP __________ IMS COMMAND | > < | > < | > < | > < | > < | > < | > < | > < | > < | > < |...

CEBR—temporary storage browse Chapter 6. CEBR—temporary storage browse Use the CEBR transaction to browse temporary storagequeues and to delete them. You can also use CEBR to transfer a transient data queue totemporary storage in order to look at its contents, and torecreate the transient data queue...

CEBT INQUIRE AUXTRACE Chapter 7. CEBT—master terminal (alternate CICS) Use CEBT to control an alternate CICS system in anextended recovery facility (XRF) environment. For informationabout XRF, see the CICS/ESA 3.3 XRF Guide. You can start this transaction only at the operating systemconsole. Startin...

CEBT INQUIRE DUMP Stop Auxiliary tracing has stopped. Switch displays the information that an immediate switch isbeing made from the current auxiliary trace data set tothe alternate trace data set. CEBT INQUIRE DUMP Function: Retrieve information about the CICS dump data sets. Description: CEBT INQU...

CEBT INQUIRE GTFTRACE Ÿ CEBT INQUIRE INTTRACE CEBT INQUIRE GTFTRACE Function: Show the GTF status. Description: CEBT INQUIRE GTFTRACE tells you whether CICS tracing to the MVS Generalized TracingFacility (GTF) is started or stopped. This command is intended for use at terminals that do notsupport th...

CEBT INQUIRE SURVEILLANCE Ÿ CEBT INQUIRE TAKEOVER CEBT INQUIRE SURVEILLANCE Function: Display whether surveillance (or tracking) of the active CICS system by the alternate CICS system is ON orOFF. Input: Press the Clear key and type CEBT INQUIRE SURVEILLANCE (the minimum abbreviation is CEBT I SU )....

CEBT PERFORM commands Ÿ CEBT PERFORM SHUTDOWN CEBT PERFORM commands The CEBT PERFORM commands allow you to: Ÿ Shut down the alternate CICS system (CEBT PERFORMSHUTDOWN) Ÿ Request a dump of the alternate CICS and continueprocessing (CEBT PERFORM SNAP) Ÿ Cause the alternate CICS to take over from the ...

CEBT PERFORM SNAP Ÿ CEBT PERFORM TAKEOVER CEBT PERFORM SNAP Function: Cause a “snapshot” dump of the alternate CICS system to be taken while CICS continues to run. All CEBT PERFORM SNAP requests result in an SDUMP onan MVS SYS1.DUMPnn data set. The use of CEBT PERFORM SNAP prevents all other tasksfr...

CEBT SET AUXTRACE CEBT SET AUXTRACE Function: Change auxiliary tracing options. Description: You can start, stop, or pause tracing, and specify that automatic switching of the auxiliary data set is tooccur when needed. You can use the switch option tochange the data set. Instead of using the SET com...

CEBT SET DUMP Ÿ CEBT SET GTFTRACE CEBT SET DUMP Function: Change the attributes of a CICS dump data set. Description: Using CEBT SET DUMP, you can open or close the active CICS dump data set, and specify whether ornot the automatic switch to the inactive dump data set is tooccur when the active dump...

CEBT SET INTTRACE Ÿ CEBT SET SURVEILLANCE CEBT SET INTTRACE Function: Switch CICS internal tracing on or off. Description: This command is intended for use at terminals that do not support the full-screen tracingtransaction CETR. Syntax: Press the Clear key to clear the screen. There are two ways of...

CEBT SET TAKEOVER CEBT SET TAKEOVER Function: Set takeover from the active CICS system by the alternate CICS system to be automatic, manual, orcommand-driven. Syntax: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEBT SET TAKEOVER (the minimum abb...

CECI/CECS—command-level interpreter Chapter 8. CECI—command-level interpreter Use CECI, which invokes the CICS command-levelinterpreter, to enter an EXEC CICS command, check itssyntax, and modify it if necessary. In most cases, you canalso process the command. For programming information on each EXE...

CEDA—resource definition online Chapter 9. CEDA—resource definition online Use CEDA to define resources to your CICS system whilethe system is running. With CEDA, you can update both theCICS system definition (CSD) file and the running CICSsystem. Start the transaction by entering CEDA on the comman...

CEDA—resource definition online If you enter INST on the command line and press ENTER,you get the screen shown in Figure 21 which lists theresources: à ð CEDA INST OVERTYPE TO MODIFY CEDA Install All Connection ==> DB2Conn ==> DB2Entry ==> DB2Tran ==> | DOctemplate ==> | Enqmodel ==&g...

CEDA—resource definition online 55─ ─ ─CEDA ───────────────────────────────────────────────────────────────────5 5─ ─ ─┬ ┬ ─ADD─ ─ ─GROUP( groupname1 ) ─ ─LIST( name ) ─ ─┬ ┬ ──────────────────── ──── ─5% │ │ ├ ┤ ─ ─AFTER( groupname2 ) ─ │ │ └ ┘ ─ ─BEFORE( groupname3 ) ├ ┤ ─ALTER──┤ Resource ├─ ─ ─G...

CEDA—resource definition online Resource: ├─ ─ ─┬ ┬ ─ ─CONNECTION( name ) ── ─┤ ├ ┤ ─ ─DB2CONN( name ) ───── ├ ┤ ─ ─DB2ENTRY( name ) ──── ├ ┤ ─ ─DB2TRAN( name ) ───── | ├ ┤ ─ ─DOCTEMPLATE( name ) ─ | ├ ┤ ─ ─ENQMODEL( name ) ──── ├ ┤ ─ ─FILE( name ) ──────── ├ ┤ ─ ─JOURNALMODEL( name ) ├ ┤ ─ ─LSRPOOL...

CEDA—resource definition online GROUP Every resource definition must have a GROUP name.The resource definition becomes a member of the groupand is installed in the CICS system when the group isinstalled. The GROUP name can be up to 8 charactersin length. JOURNALMODEL The name of a journal model cont...

CEDA—resource definition online à ð ALTER TRANS OVERTYPE TO MODIFY CICS RELEASE = ð41ð CEDA ALter TRANSaction( ) TRANSaction ==> Group ==> DEscription ==> PROGram ==> TWasize ==> ð-32767 PROFile ==> PArtitionset ==>STAtus ==> Enabled | Disabled PRIMedsize ==> ð-6552ð TASKD...

CEDA—resource definition online CEDB and CEDC Two further resource definition transactions, CEDB andCEDC, allow you to use some, but not all, of the functions ofCEDA. CEDB When you use the CEDB transaction, the INSTALLcommand is not available to you. This means that you canupdate the CSD, but not th...

CEDF—execution diagnostic facility Chapter 10. CEDF & CEDX — the execution diagnostic facility The CICS execution diagnostic facility (EDF) provides twotransactions that you can use for testing applicationprograms. These transactions—CEDF and CEDX—enableyou to test application programs interacti...

CEDF—execution diagnostic facility Beginning an EDF session (dual-screenmode) You can also use EDF in what is known as dual-screen mode; that is, using one terminal to monitor a transactionrunning at a second terminal. This mode is started by adding the terminal identifier (termid)of the second term...

CEDF—execution diagnostic facility ┌ ┐ ─,ON── 55─ ─ ─CEDX ─ ─tranid ─ ─┼ ┼ ────── ─5% └ ┘ ─,OFF─ Command options OFF specifies that the EDF screen is to be switched OFF. Ifyou specify OFF you must enter the preceding comma,as shown in the following example: CEDX TRNA,OFF ON specifies that the EDF sc...

CEMT—master terminal Chapter 11. CEMT—master terminal Use CEMT to invoke all the master terminal functions. The master terminal program provides dynamic user controlof the CICS system. By using this function, an operator caninquire about and change the values of parameters used byCICS, alter the sta...

CEMT—master terminal If you type: P and press ENTER, you get the following screen: à ð P STATUS: ENTER ONE OF THE FOLLOWING DEletshipped DUmp ENDaffinity RESet SEcurity SHUTdown SNap STatistics Figure 40. CEMT transaction: PERFORM screen If you type: S and press ENTER, you get the following screen: ...

CEMT—master terminal CLASS option When operating on terminals, transactions, and programs,the CLASS option can be used to identify the suffix of a TLT,XLT, or PLT. This limits the scope of the INQUIRE or SETcommands to those resources defined in the specified table.Any resources whose definitions ha...

CEMT—master terminal The sequence of the positional fields is given in thedescriptions of the various CEMT INQUIRE commands. Whenever you overtype a display, not only is that particularaction taken but all the status information is refreshed. Youcan avoid the overhead of a large number of table sear...

CEMT DISCARD Variables PF5 gives a display of variables, similar to that for the CECIcommand. Here are some examples of its use. From a FILE display, you may wish to inquire of a particularDSNAME, which is typically 26 characters and can be up to44 characters in length. Go to the expanded panel, pos...

CEMT DISCARD and a screen similar to Figure 45 on page 50 appears.Use the carriage return key to move the cursor to thebeginning of the line for the resource or resources youwant to discard, and type “D” as shown and then pressENTER. à ð IN PROG STATUS: RESULTS - OVERTYPE TO MODIFY D Prog(ABCDTASK) ...

CEMT DISCARD Options AUTInstmodel( value) specifies the name of the autoinstall model that is to beremoved. The name can be up to 8 characters long. TheDISCARD AUTINSTMODEL command removes theinstalled name of an autoinstall model from theautoinstall terminal model (AITM) table and the CICScatalog. ...

CEMT DISCARD | PROCesstype( value) | Specifies the 8–character name of the Processtype to be | removed. Only disabled processtypes can be discarded. | If you are using BTS in a sysplex, it is strongly | recommended that you use CPSM to remove them. PROFile( value) specifies the name of the profile t...

CEMT INQUIRE COMMANDS Ÿ CEMT INQUIRE AUTINSTMODEL CEMT INQUIRE commands Most CEMT requests either inquire about (INQUIRE), orchange (SET) the status of one or more named instances ofa resource (such as a terminal), a particular subgroup ofresources (such as a class of terminals), or all resources of...

CEMT INQUIRE AUTOINSTALL CEMT INQUIRE AUTOINSTALL Function: Retrieve information about autoinstall values. Description: The INQUIRE AUTOINSTALL command | displays information and parameters that control the| automatic installation (autoinstall) of VTAM terminals, APPC| connections, and MVS consoles....

CEMT INQUIRE AUXTRACE Program( value) displays the name of the program that controls theautoinstall process. This is either the CICS-supplieddefault autoinstall program, DFHZATDX, or auser-written program. Note: You can reset this value by overtyping it with a different value. CEMT INQUIRE AUXTRACE ...

CEMT INQUIRE AUXTRACE à ð I AUX RESULT - OVERTYPE TO MODIFY Auxtrace Curauxds(A)Status( Stop )Switchstatus( Noswitch ) Switchaction( ) Figure 51. The expanded display of an individual entry 55─ ─ ─CEMT Inquire AUXtrace ─5% Displayed fields Auxiliary identifies this panel as relating to auxiliary tra...

CEMT INQUIRE CFDTPOOL | CEMT INQUIRE CFDTPOOL | Function: Retrieves information about coupling facility | data table pools. | Description: INQUIRE CFDTPOOL returns information | about any currently installed CFDT pool names. CICS installs| these automatically whenever it installs a file resource| de...

CEMT INQUIRE CONNECTION CEMT INQUIRE CONNECTION Function: Retrieve information about system connections. Description: CEMT INQUIRE CONNECTION returns information about the status of connections to a remotesystem or to another CICS region. You can reset the options either by typing the SET commandor ...

CEMT INQUIRE CONNECTION Lu61 The connection uses the VTAM LUTYPE6.1protocol for CICS-to-CICS or CICS-to-IMSintersystem communication. Purgetype ( input only field) specifies how associated transactions are to be purged.The values are: PUrge ( vtam only and irc only) Transactions running on the conne...

CEMT INQUIRE CONNECTION RNAme( value) displays the 4-character name by which this connectionis known in a remote system, if the subject of the inquiryis a remote connection. RNEtname( value) displays the 8-character netname of the owning TOR, ifthe subject of this inquiry is a remote connection. If ...

CEMT INQUIRE DB2CONN CEMT INQUIRE DB2CONN Function: Retrieves information about the CICS DB2 connection. Description: INQUIRE DB2CONN returns information about the attributes of the currently installed DB2CONN,which defines the connection to DB2. Note that because there can be only one DB2CONN insta...

CEMT INQUIRE DB2CONN Tern The terminal identification (four characters padded to eight) is used as an authorization ID. Anauthorization ID cannot be obtained in this mannerif a terminal is not connected with the transaction. If a transaction is started (using a CICS command)and has no terminal assoc...

CEMT INQUIRE DB2CONN Connectst returns the status of the CICS DB2 connection. Thevalues are: Connected CICS is connected to DB2. Notconnected CICS is not connected to DB2. Connecting CICS is currently attempting to connect to DB2. Disconning CICS is currently disconnecting from DB2. DB2id returns th...

CEMT INQUIRE DB2CONN SET DB2CONN. See SECURITY(REBUILD) onpage170. Standbymode returns the action to be taken by the CICS DB2attachment if DB2 is not active when an attempt is madeto start the connection from CICS to DB2. The valuesare: Noconnect The CICS DB2 attachment terminates. Connect The CICS ...

CEMT INQUIRE DB2ENTRY CEMT INQUIRE DB2ENTRY Function: Returns the attributes of the DB2ENTRY that defines resources to be used by a specific transaction or bya group of transactions when accessing DB2. Description: The entry is identified by the name with which it was defined in CEDA. Input: For RCT...

CEMT INQUIRE DB2ENTRY DISabling The DB2ENTRY is in the process of beingdisabled. New transactions cannot access theDB2ENTRY. Existing transactions using theDB2ENTRY will be allowed to complete unless theDB2ENTRY is being disabled with the FORCEoption. PLAN returns the name of the plan to be used for...

CEMT INQUIRE DB2TRAN Ÿ CEMT INQUIRE DELETSHIPPED CEMT INQUIRE DB2TRAN Function: Returns attributes of a particular DB2TRAN that associates a transaction or group of transactions with aDB2ENTRY. Description: The DB2TRAN is identified by the name it was defined with in CEDA. For RCTs migrated to the C...

CEMT INQUIRE DOCTEMPLATE installed in this region. When the CICS timeout deletemechanism is invoked, only those shipped definitionsthat have been inactive for longer than this time aredeleted. The time interval can be in the range 00-99 hours; 00-59minutes; and 00-59 seconds. Note: You can reset thi...

CEMT INQUIRE DSAS | DDNAME| returns the DD name of the PDS containing the | template. The DDName applies only to a template of | type PDS. If a membername is supplied without a value | for DDNAME, the default value DFHHTML is used. | DOCTEMPLATE| returns the name of this DOCTEMPLATE definition. | NA...

CEMT INQUIRE DSAS SOSABOVE CICS is short on storage in at least one of thedynamic storage areas above 16MB. SOSBELOW CICS is short on storage in at least one of thedynamic storage areas below 16MB. CDsasize( value) displays the size, in bytes, of the CICS dynamic storagearea (CDSA). The size of this...

CEMT INQUIRE DSNAME CEMT INQUIRE DSNAME Function: Retrieve information about an external data set. Description: INQUIRE DSNAME returns information about the status of a data set managed by CICS file control.The data set name is either the name specified on the DSNparameter of the data set’s DD state...

CEMT INQUIRE DSNAME displayed. The full set of keywords can be displayed bymoving the cursor to the beginning of a displayed item (infront of the Dsn field) and pressing the ENTER key. You geta display of all the keyword information for the displayeditem, as follows: à ð IN DSNRESULT - OVERTYPE TO M...

CEMT INQUIRE DSNAME Quiescestate displays the RLS quiesce state of the data set. Theinformation is obtained from the ICF catalog entry for thedata set. The values displayed are: Quiesced A data set has been quiesced. It means that RLSACBs cannot open against the data set and noCICS region has an RLS...

CEMT INQUIRE DUMPDS CEMT INQUIRE DUMPDS Function: Retrieve information about the CICS dump data sets. Description: INQUIRE DUMPDS tells you which dump data set (A or B) is currently open. Instead of using the SET command, you can overtype yourchanges on the INQUIRE screen after tabbing to theappropr...

CEMT INQUIRE ENQ | CEMT INQUIRE ENQ | Function: Retrieve information about enqueues held or | waited on by a UOW, or about UOWs holding or waiting on a| specified enqueue. | Description: INQUIRE ENQ returns information about the | enqueues held by a UOW. Enqueues are used by CICS to| lock recoverabl...

CEMT INQUIRE ENQMODEL | TDq The resource is a logically-recoverable transient | data queue. RESOURCE contains the name of the | queue. QUALIFIER contains either the string | “FROMQ” or “TOQ,” indicating whether a read or | write lock is held for the queue. | A READQ TD request acquires the “FROMQ” l...

CEMT INQUIRE EXCI | DISABLED| Matching ENQ requests are rejected, and the issuing | task abended abcode ENQ_DISABLED. Matching | INSTALL/CREATE/DISCARD requests are processed. | ENABLED| Matching ENQ requests are processed in the normal | way. | WAITING| Matching ENQ requests are rejected, and the i...

CEMT INQUIRE FEPI Exci( value) indicates that this panel relates to an EXCI inquiry. The value consists of: jobname.stepname.procname - mvsid One or both of the stepname and procname may not bepresent, indicated by the periods (.) being adjacent toone another. The mvsid identifies the MVS system on ...

CEMT INQUIRE FILE CEMT INQUIRE FILE Function: Retrieve information about VSAM, BDAM, and remote files, and files that refer to data tables. Description: The values that are returned to you can vary according to when the command is issued. For example, ifthe file is closed when you issue the command,...

CEMT INQUIRE GTFTRACE | Updatemodel (CFDT only)| displays the update model specified for the coupling | facility data table in the installed file definition. The | values are: | CONTENTION | The coupling facility data table is updated using | the contention model. | LOCKING | The coupling facility d...

CEMT INQUIRE INTTRACE Ÿ CEMT INQUIRE IRBATCH CEMT INQUIRE INTTRACE Function: Show the status of CICS internal tracing. Description: INQUIRE INTTRACE tells you whether CICS internal tracing is in progress. This command is intended for use at terminals that do notsupport the full-screen tracing transa...

CEMT INQUIRE IRC CEMT INQUIRE IRC Function: Show the IRC status. Description: INQUIRE IRC tells you whether the interregion communication (IRC) facility is open or closed. Input: Press the Clear key and type CEMT INQUIRE IRC (the minimum abbreviation is CEMT I IRC ). You will get a display screen, a...

CEMT INQUIRE JMODEL CEMT INQUIRE JMODEL Function: Retrieve information about journal models and log stream names. Description: The INQUIRE JMODEL command enables you to inquire on installed journal models to obtaincorresponding log stream names. Input: Press the CLEAR key to clear the screen. There ...

CEMT INQUIRE JOURNALNAME CEMT INQUIRE JOURNALNAME Function: Show the status of the CICS system log and general logs. Description: The INQUIRE JOURNALNAME command enables you to inquire on the status of the CICS system logand general logs. It replaces the INQUIRE JOURNALNUMcommand. Input: Press the C...

CEMT INQUIRE LINE STreamname( value) displays the MVS log stream name associated with thejournal. CICS displays 8 blanks (X ' 40 ' ) if the journal is defined with a type of DUMMY or SMF. Type displays the type of log stream. The possible types are: Mvs Records for journals defined with this journal...

CEMT INQUIRE MODENAME à ð INQ LINE(TTT1) RESULT Line(TTT1) Number()Negpoll( ððð8ð )Servstatus( Inservice ) Purgetype( ) Figure 86. The expanded display Displayed fields Inservice The line is available for use. Changing the status of theline does not affect the equivalent status of the terminalson it...

CEMT INQUIRE MODENAME Note: There are blank fields on the screen where a value does not apply or is ‘negative’; that is, the valuebegins with ‘No’. To modify these fields, locate themby tabbing (they appear in the same sequence as inthe expanded format), and overtype with input validfor that field. ...

CEMT INQUIRE MONITOR CEMT INQUIRE MONITOR Function: Retrieve information about the status of CICS monitoring. Description: INQUIRE MONITOR tells you whether monitoring is switched on or off, which classes of monitoringdata are to be collected, and the current settings of themonitoring options. Input...

CEMT INQUIRE MONITOR Perfclass displays whether the performance class of monitoringdata is being collected. The values are: Perf Performance-class monitoring data is beingcollected. Noperf Performance-class monitoring data is not beingcollected. Note: You can reset this value by overtyping it with a...

CEMT INQUIRE NETNAME CEMT INQUIRE NETNAME Function: Retrieve information about a network. Description: If you are familiar with network names, you may prefer to use this command as an alternative to CEMTINQUIRE TERMINAL. Input: Press the Clear key to clear the screen. There are two ways of commencin...

CEMT INQUIRE NETNAME CId( value) displays an 8-character correlation-identifier that is setonly for sessions, and only after a session has beenacquired. (The value relates to the previously acquiredsession if there was one, if the session is not acquired).CID is set as follows: Ÿ For LU6.2 sessions,...

CEMT INQUIRE NETNAME Purgetype ( input only field) specifies whether the transactions running with thenamed terminal are to be purged. The values are: PUrge Transactions are to be terminated only if systemand data integrity can be maintained. Atransaction is to be purged if its definition specifiesS...

CEMT INQUIRE PARTNER NOTti This terminal cannot be used by transactions. Notes: 1. You can reset this value by overtyping it with a different value. 2. A terminal cannot be defined with both NOATI and NOTTI. Userid( data-area) returns the 8-character identifier of the user signed on atthis terminal ...

CEMT INQUIRE PROCESSTYPE à ð I PART RESULT Partner(IST1ISC2) Network() Netname(IYMVM2) Profile(DFHCICSA) Ltpname(ð4) Tpname(IST1) Figure 94. The expanded display of an individual entry Displayed fields Ltpname( value) displays the length of the name of the remotetransaction program (TPNAME), in byte...

CEMT INQUIRE PROFILE Ÿ CEMT INQUIRE PROGRAM CEMT INQUIRE PROFILE Function: Retrieve information about a transaction profile. Description: INQUIRE PROFILE returns information about the profiles installed in your system. There is no SETPROFILE function. However, the INQUIRE PROFILE screendoes allow yo...

CEMT INQUIRE REQUESTMODEL Ÿ CEMT INQUIRE RRMS | CEMT INQUIRE REQUESTMODEL | Function: Retrieves information about a | REQUESTMODEL | Description: INQUIRE REQUESTMODEL returns | information about any currently installed Request models. | Input: Press the Clear key to clear the screen, and type | CEMT...

CEMT INQUIRE STATISTICS CEMT INQUIRE STATISTICS Function: Retrieve statistics information. Description: INQUIRE STATISTICS tells you the interval during which statistics are accumulated, the end-of-day timefor shutdown (or logical end-of-day) statistics, the time atwhich statistics are next recorded...

CEMT INQUIRE STREAMNAME CEMT INQUIRE STREAMNAME Function: Retrieve information about currently connected MVS log streams. Description: The INQUIRE STREAMNAME command allows you to inquire on the currently connected MVS logstreams. Input: Press the Clear key to clear the screen. There are two ways of...

CEMT INQUIRE SYDUMPCODE CEMT INQUIRE SYDUMPCODE Function: Retrieve information about the system dump code table. Description: INQUIRE SYDUMPCODE allows you to see the current settings of the entries in the system dump table.‘NO’ settings (NOSYSDUMP, for example) are shown asblank. The INQUIRE comman...

CEMT INQUIRE SYDUMPCODE Action ( input only field) specifies the action to be taken with this system dumpcode. The values are: Reset The current number of calls for this dump code isreset to zero. Remove This system dump code is removed from thesystem dump code table. Add This system dump code is ad...

CEMT INQUIRE SYSTEM CEMT INQUIRE SYSTEM Function: Retrieve information about CICS. Description: INQUIRE SYSTEM returns information about the CICS system. Input: Press the Clear key to clear the screen, and type CEMT INQUIRE SYSTEM (the minimum abbreviation is CEMT I SYS ). You get a display that lis...

CEMT INQUIRE SYSTEM AUTOActive Autoinstall for programs is active. On first use, if aprogram, mapset, or partitionset is not defined, thedefinition is created dynamically. AUTOInactive Autoinstall is not active. If a program is notdefined, a PGMIDERR or transaction abendoccurs when it is referenced....

CEMT INQUIRE TASK Time( value) displays the interval, in milliseconds, for which CICSreleases control to the operating system if notransactions are ready to resume processing. Thisinterval is known as the ‘region exit interval’. Notes: 1. You can reset this value by overtyping it with a different va...

CEMT INQUIRE TASK ┌ ┐ ─ALl─────────── 55─ ─ ─CEMT Inquire TAsk ─ ─┼ ┼ ─────────────── ──────5 ├ ┤ ─ ─( value ) ────── └ ┘ ─ ─TClass( value ) 5─ ─ ─┬ ┬ ─────────────── ─ ─┬ ┬ ───────────────── ─────5 └ ┘ ─ ─TRanid( value ) └ ┘ ─ ─FAcility( value ) 5─ ─ ─┬ ┬ ────────────── ─ ─┬ ┬ ────── ──────────────...

CEMT INQUIRE TCLASS CEMT INQUIRE TCLASS Function: Retrieve information about tasks within a task class. Description: INQUIRE TCLASS returns information about the current and maximum number of tasks, the purgethreshold, and the status of a user-defined task class. Input: Press the Clear key to clear ...

CEMT INQUIRE TCPIP Ÿ CEMT INQUIRE TCPIPSERVICE | CEMT INQUIRE TCPIP | Function: Inquire about CICS internal TCP/IP support | status. | Description: INQUIRE TCPIP returns information about | the current status of CICS internal TCP/IP support. | Input: Press the Clear key to clear the screen. There ar...

CEMT INQUIRE TDQUEUE CEMT INQUIRE TDQUEUE Function: Retrieve information about transient data queues. Description: INQUIRE TDQUEUE returns information about a named transient data queue that is defined in thedestination control table (DCT). Input: Press the Clear key to clear the screen. There are t...

CEMT INQUIRE TDQUEUE TRIggerlevel( value) (intrapartition queues only) displays the number of requests for output to aqueue that must accrue before automatictransaction initiation (ATI) occurs. Note: You can reset this value by overtyping it with a different value. The number can be between 0 and 32...

CEMT INQUIRE TERMINAL CEMT INQUIRE TERMINAL Function: Retrieve information about terminals. Description: INQUIRE TERMINAL returns information about a named terminal defined in the terminal control table(TCT). In an SNA environment, a terminal is the CICSrepresentation of an SNA logical unit with whi...

CEMT INQUIRE TERMINAL à ð IN TERM STATUS: RESULTS - OVERTYPE TO MODIFY Ter(CBRF) Pri( ððð ) Pag Ins Ati Tti Rte Net(CBRF ) Rem(CBR ) Rna(CBRF) Ter(CERR) Pri( ððð ) Pag Ins Tti Loc | Con(\ERRCON\ ) Ter(CTSO) Pri( ððð ) Pag Ins Tti Loc | Con(PKING ) | Ter(KING) Pri( ððð ) Pag Ins Tti Loc | Con(PRUEKIN...

CEMT INQUIRE TERMINAL Outservice The terminal is not available for use. Setting aterminal Out(service) means that the terminal canno longer be used by transactions. If PURGE orFORCEPURGE is also specified, any transactionusing the terminal is terminated abnormally. IfPURGE or FORCEPURGE is not speci...

CEMT INQUIRE TRANSACTION CEMT INQUIRE TRANSACTION Function: Retrieve information about transactions. Description: INQUIRE TRANSACTION returns information about transaction definitions. Input: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEMT INQU...

CEMT INQUIRE TRDUMPCODE CEMT INQUIRE TRDUMPCODE Function: Retrieve information about transaction dump codes. Description: The INQUIRE function allows you to see the current settings of the entries in the transaction dump table.See the CICS Problem Determination Guide for information on using dumps. ...

CEMT INQUIRE TSMODEL | CEMT INQUIRE TSMODEL | Function: Retrieve information about TS models. | Description: The INQUIRE TSMODEL command returns | information about temporary storage models (TS models). | Input: Press the Clear key to clear the screen. There are | two ways of commencing this transac...

CEMT INQUIRE TSPOOL | TSmodel( value) | indicates that this panel relates to a TSMODEL inquiry | and displays the 8-character name of a temporary | storage model. | Note: Nondisplayable characters appear as periods. | You can use PF2 on the expanded panel to see | the value in hexadecimal. | CEMT IN...

CEMT INQUIRE TSQUEUE / TSQNAME | Displayed fields | Connstatus( value) | displays the connection status of this TS pool. The | values are: | Connected | This TS pool is connected. | Unconnected | This TS pool is not connected. | Tspool( value) | indicates that this panel relates to a TSPOOL inquiry ...

CEMT INQUIRE TSQUEUE / TSQNAME ┌ ┐ ─ALl───── | 55─ ─ ─CEMT Inquire TSQueue ─ ─┼ ┼ ───────── ─────────5 └ ┘ ─ ─( value ) 5─ ─ ─┬ ┬ ───────────────── ─ ─┬ ┬ ───────────────── ───5 | ├ ┤ ─ ─SYSID( value ) ─── └ ┘ ─ ─Numitems( value ) | └ ┘ ─ ─POOLNAME( value ) 5─ ─ ─┬ ┬ ──────────────────── ───────────...

CEMT INQUIRE UOW MAIn The temporary storage queue is held in mainstorage. MAXitemlen( value) displays the length in bytes of the largest item in thetemporary storage queue. For information about howCICS calculates the length of items, see the CICS System Programming Reference. MInitemlen( value) dis...

CEMT INQUIRE UOW ┌ ┐ ─ALl───── 55─ ─ ─CEMT Inquire UOW ─ ─┼ ┼ ───────── ─────────────5 └ ┘ ─ ─( value ) 5─ ─ ─┬ ┬ ────────── ─ ─┬ ┬ ───────── ──────────────────5 ├ ┤ ─Backout── ├ ┤ ─ACtive── ├ ┤ ─COMmit─── ├ ┤ ─WAITIng─ ├ ┤ ─INDoubt── └ ┘ ─SHunted─ ├ ┤ ─INFlight─ ├ ┤ ─HBackout─ └ ┘ ─HCommit── 5─ ─ ─...

CEMT INQUIRE UOWDSNFAIL distributed UOW. Values of WAITFORGET orWAITRMI, and BACKOUT or COMMIT indicatehow the UOW was resolved on this system. SHunted Syncpoint processing of the UOW has beendeferred. SHUNTED further indicates that the task,terminal and program storage have been released,and locks ...

CEMT INQUIRE UOWDSNFAIL See the section on moving data sets in the CICS Recovery and Restart Guide. DEAdlock ( non-rls data sets only) A deadlock was detected. This may go away if theUOW is retried. DELexiterror Backout of a write to an ESDS failed because alogical delete global user exit program wa...

CEMT INQUIRE UOWENQ Rlsaccess displays whether the data set was last opened in thisCICS region in RLS or non-RLS mode. The values are: RLS The last open in this CICS region was in RLS mode. NOtrls The last open in this CICS region was in non-RLSmode. Sysid( value) displays the 4-character sysid (whe...

CEMT INQUIRE UOWENQ RLen( value) displays the length of the data, in the range 0 through255, displayed in the RESOURCE field. RESource( value) displays a 1- through 255-character string containing thename of the resource associated with the enqueue lock.The data displayed depends on the type of enqu...

CEMT INQUIRE UOWLINK CEMT INQUIRE UOWLINK Function: Retrieve information about connections involved in units of work. Description: INQUIRE UOWLINK returns information about a connection involved in a unit of work. The connectioncan be to a remote system, or to a task-related user exit. If itis to a ...

CEMT INQUIRE VTAM CEMT INQUIRE VTAM Function: Inquire on the state of the connection between CICS and VTAM. Description: INQUIRE VTAM inquires on the state of the connection between CICS and VTAM, and also on thegeneric resource name (GRNAME) and the persistentsession delay interval (PSDI). Input: P...

CEMT INQUIRE WEB Hhmmss If CICS fails, sessions are held inrecovery-pending state by VTAM for up to theinterval specified. Vtam indicates that this panel relates to a VTAM inquiry. | CEMT INQUIRE WEB | Function: Retrieve information about CICS Web support. | Description: INQUIRE WEB returns informat...

CEMT PERFORM commands Ÿ CEMT PERFORM DELETSHIPPED CEMT PERFORM commands The CEMT PERFORM commands are not concerned withresource status. They are used to: Ÿ Cause the CICS timeout delete mechanism to beinvoked immediately (PERFORM DELETSHIPPED) Ÿ Dump and continue processing (PERFORM DUMP orPERFORM ...

CEMT PERFORM DUMP|SNAP Ÿ CEMT PERFORM ENDAFFINITY CEMT PERFORM DUMP|SNAP Function: Obtain a CICS system dump. Description: To get a CICS system to dump and continue processing, you can use either the CEMT PERFORM DUMPcommand or the CEMT PERFORM SNAP command. Bothcommands produce a “snapshot” of the ...

CEMT PERFORM RESET Ÿ CEMT PERFORM SECURITY CEMT PERFORM RESET Function: Synchronize the CICS date and time-of-day with the system date and time-of-day. This command should be executed following a change to thesystem date or to the time-of-day. For example, when setting clocks forward or back an hour...

CEMT PERFORM SHUTDOWN CEMT PERFORM SHUTDOWN Function: Shut down the CICS region. The shutdown can be either controlled or immediate. Syntax 55─ ─ ─CEMT Perform SHUTdown ─ ─┬ ┬ ──────────── ─────5 └ ┘ ─ ─Xlt( value ) 5─ ─ ─┬ ┬ ──────────── ─ ─┬ ┬ ─────────────── ──────────5 └ ┘ ─ ─Plt( value ) ├ ┤ ─ ...

CEMT PERFORM STATISTICS CEMT PERFORM STATISTICS Function: Write the statistics for a named resource type immediately to the SMF data set, rather than wait for thecurrent statistics-gathering interval to expire. The recordingis made irrespective of the ON or OFF setting of statistics.See also page “C...

CEMT SET COMMANDS RESetnow The statistics counters are to be reset. STAts Statistics domain statistics are to be written immediatelyto the SMF data set. STOrage Storage manager statistics are to be written immediatelyto the SMF data set. STReamname Log stream statistics are to be written immediately...

CEMT SET AUTOINSTALL CEMT SET AUTOINSTALL Function: Change autoinstall values. Description: The CEMT SET AUTOINSTALL command | allows you to change some of the values that control the| automatic installation (autoinstall) of VTAM terminals and| MVS consoles. For information about autoinstall, see th...

CEMT SET AUXTRACE CEMT SET AUXTRACE Function: Change auxiliary tracing options. Description: For more information about traces, see the CICS Problem Determination Guide. See also the descriptionof the CETR transaction, Chapter 16, “CETR—trace control”on page 221. Syntax: Press the Clear key to clear...

CEMT SET CONNECTION CEMT SET CONNECTION Function: Change the status of connections linked to specific terminals. Description: When a connection has been defined as INDIRECT, no information is given unless the directconnection to which it refers is installed. If you want to install a new connection d...

CEMT SET CONNECTION All UOWs shunted due to the failure of this connectionare to be committed. The normal resynchronizationprocess is to be partially overridden: decisions are takenfor any units of work that are in-doubt due to a failure ofthe connection; but the decisions are recorded and anydata i...

CEMT SET CONNECTION circumstances. It erases recovery informationand may compromise data integrity for units ofwork that have updated resources on remotesystems. Examples of circumstances in which you might need touse it are: Ÿ You need to discard a connection, or issue a SETCONNECTION ENDAFFINITY c...

CEMT SET DB2CONN CEMT SET DB2CONN Function: Set attributes of the CICS DB2 connection including the pool and command thread attributes. Syntax: Press the Clear key to clear the screen. To commence this transaction: Ÿ Type CEMT SET DB2CONN (the minimum abbreviation is CEMT S DB2C ). You get a display...

CEMT SET DB2CONN is terminated. Additionally, authorization changescause accounting records to be produced. AUTHId specifies what id should be used for security checkingfor pool threads. If AUTHID is specified, AUTHTypemay not be specified. AUTHType specifies the type of ID that can be used for pool...

CEMT SET DB2ENTRY Note that when you change the value of AUTHId,AUTHType, COMAUTHId, COMAUTHType or SIgnid, asurrogate user security check is invoked if security is active.This ensures that the userid under which SET is beingexecuted is authorized to act on behalf of the userid beingset. Note that w...

CEMT SET DB2TRAN THREADWAIT parameter on the DB2CONN. Thetransaction is terminated with abend code AD3T. All parameters on SET DB2ENTRY can be set whilst theCICS DB2 attachment is active and the transactions areactive. CEMT SET DB2TRAN Function: specify this to set the attributes of a particular DB2...

CEMT SET DELETSHIPPED CEMT SET DELETSHIPPED Function: Change system settings that control the CICS timeout delete mechanism. Syntax: The CICS timeout delete mechanism is invoked at user-specified intervals to remove any shipped terminaldefinitions that have not been used for longer than auser-specif...

CEMT SET DSAS Ÿ CEMT SET DSNAME CEMT SET DSAS Function: Change the system storage attributes. Syntax: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEMT SET DSAS . You get a display that lists the current status, similar to that obtained by CEMTIN...

CEMT SET DSNAME If the BWO attributes are not updated after the restore ofa backup copy of a data set that was taken using BWO,CICS fails a subsequent file open because the data setis marked as down-level. REMOve This option is used when a data set is no longerrequired on the local system. It delete...

CEMT SET DUMPDS Ÿ CEMT SET ENQMODEL CEMT SET DUMPDS Function: Change the attributes of a CICS dump data set. Description: Using SET DUMPDS, you can open or close the active CICS dump data set, and specify whether or notthe automatic switch to the inactive dump data set occurswhen the active dump dat...

CEMT SET FEPI Ÿ CEMT SET FILE CEMT SET FEPI Comments: For information on CEMT SET FECONNECTION, CEMT SET FEPOOL, CEMT SETFEPROPSET, and CEMT SET FETARGET, see the CICS Front End Programming Interface User's Guide. CEMT SET FILE Function: Change some of the attributes of one or more VSAM or BDAM file...

CEMT SET FILE EMptyreq ( vsam only) Applies only to a VSAM file that has been defined toVSAM as a cluster with the REUSE parameter, andwhich is opened in non-RLS access mode. It indicatesthat when a file is next opened, its data is erased. If the file is opened in RLS access mode this parameterhas n...

CEMT SET GTFTRACE Ÿ CEMT SET INTTRACE CEMT SET GTFTRACE Function: Change the status of GTF tracing Description: SET GTFTRACE allows you to switch CICS tracing to the MVS Generalized Tracing Facility (GTF) onand off. This command is intended for use at terminals that do notsupport the CETR full-scree...

CEMT SET IRC CEMT SET IRC Function: Open or close the interregion communication (IRC) facility. Description: New MRO connections can be installed without first closing IRC. However, if you want to modifyexisting MRO connections, IRC must be closed using theSET IRC CLOSED command. For example: CEMT S...

CEMT SET JOURNALNAME Ÿ CEMT SET LINE CEMT SET JOURNALNAME Function: Enable or disable a CICS user journal. Description: The SET JOURNALNAME command allows you to enable or disable a CICS user journal. It has no effecton a journal that is being used as the forward recovery log orauto-journal for a VS...

CEMT SET MODENAME (DFHTEP) when a CICS task is not ready to accept arecord from an input process queue. If the CICS task issues a read before the intervalexpires, processing continues normally and DFHTEP isnot notified. The default value is zero. NUmber( value) specifies the relative line number of ...

CEMT SET MONITOR AVailable( value) specifies the maximum number of sessions within thegroup that can be concurrently allocated for use. Thisvalue has to be the same for both sides involved in thesession. CLosed CICS is to release all sessions within the group. Thesessions are quiesced and unbound. N...

CEMT SET NETNAME CEMT SET NETNAME Function: Change the status of networks. Description: If you are familiar with network names, you may prefer to use this command as an alternative to CEMTSET TERMINAL (described under “CEMT SET TERMINAL”on page 204). However, CEMT SET NETNAME cannot beused for APPC ...

CEMT SET PROCESSTYPE If NOCREATE is set for an LU6.1 ISC session and thereare no allocatable sessions left, the connection is placedOUTSERVICE. NOTti ( vtam only) This terminal cannot be used by transactions. Note: A terminal cannot be defined with both NOATI and NOTTI. Outservice ( vtam only) The t...

CEMT SET PROGRAM | For details of the records that are written from the | process, activity primary, and activity secondary audit | points, see the CICS Business Transaction Services | manual. | ALl| specifies that any changes you specify are made to all | process-types that you are authorized to ac...

CEMT SET QUEUE Ÿ CEMT SET STATISTICS CEMT SET QUEUE Comments: See “CEMT SET TDQUEUE” on page 203. (QUEUE is accepted for INQUIRE commands, but thecorrect keyword is TDQUEUE.) CEMT SET STATISTICS Function: Change statistics attributes. Description: SET STATISTICS allows you to change some of the valu...

CEMT SET STATISTICS Interval( hhmmss) specifies the length of time during which the statisticscounters are incremented. At the end of each interval,the accumulated statistics are recorded and the statisticscounters are reset. Interval times must be in the range 000100-240000. Thedefault interval val...

CEMT SET SYDUMPCODE CEMT SET SYDUMPCODE Function: Change the attributes of the system dump codes. Description: SET SYDUMPCODE allows you to define the entries that you require in the system dump table. Youcontrol system dumps by creating an entry in the systemdump table for each dump code that requi...

CEMT SET SYDUMPCODE NODae A system dump will not be suppressed by the DAEcomponent. (However, be aware of the SUPPRESS andSUPPRESSALL options in the ADYSETxx parmlibmember. These are controlled by the VRADAE andVRANODAE keys in the SDWA. They may lead to dumpsuppression even though NODAE is set here...

CEMT SET SYSTEM CEMT SET SYSTEM Function: Change the system attributes. Syntax: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEMT SET . The SYSTEM keyword does not have to be typed. If you type just CEMT SET , SYSTEM is assumed as the default. Yo...

CEMT SET SYSTEM DSAlimit( value) specifies the maximum amount of storage, as a totalnumber of bytes, within which CICS can dynamicallyallocate storage for the four individual DSAs that residebelow the 16MB boundary. See the CICS System Definition Guide for a description of the DSALIM systeminitializ...

CEMT SET TASK Time( value) specifies the interval, in milliseconds, for which CICSreleases control to the operating system if notransactions are ready to resume processing. Thisinterval is known as the ‘region exit interval’. It can have a value in the range 100–3600000, and mustbe greater than or e...

CEMT SET TCLASS Ÿ CEMT SET TCPIP CEMT SET TCLASS Function: Reset the maximum number of tasks and the purge threshold for a transaction class. Syntax: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEMT SET TCLASS (the minimum abbreviation is CEMT S...

CEMT SET TCPIPSERVICE | CEMT SET TCPIPSERVICE | Function: Modify the status of a service using CICS | internal TCP/IP support | Description: SET TCPIPSERVICE allows you to update | the information relating to a service which uses CICS internal| TCP/IP support. | Note: This command has no effect on t...

CEMT SET TDQUEUE CEMT SET TDQUEUE Function: Change the attributes of transient data queues. Description: The SET TDQUEUE command changes some of the attributes of a transient data queue. The queuemust not be REMOTE or INDIRECT. You cannot alter the following attributes unless the queue isfully disab...

CEMT SET TERMINAL CEMT SET TERMINAL Function: Change the attributes of named terminals. Description: The SET TERMINAL command changes some of the values of a named terminal defined in theterminal control table (TCT). It cannot be used for APPCsessions. In an SNA environment, a terminal is the CICSre...

CEMT SET TRANSACTION CEMT SET TRANSACTION Function: Change some of the attributes of a selected transaction. Syntax: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEMT SET TRANSACTION (the minimum abbreviation is CEMT S TRANS ) with ( value), CLAS...

CEMT SET TRDUMPCODE CEMT SET TRDUMPCODE Function: Change the status of a transaction dump. Description: Using the SET function, you can change entries in the transaction dump table to request a transactiondump. You can also set the maximum number of dumps thatcan be taken. See the CICS Problem Deter...

CEMT SET TSQUEUE | CEMT SET TSQUEUE | Function: Delete a temporary storage queue (TS queue). | This section applies also to the alternative command, CEMT| SET TSQNAME. Use either to delete temporary storage| queues (TS queues) with names up to 8 characters long.| Use SET TSQNAME to delete temporary ...

CEMT SET UOW Ÿ CEMT SET UOWLINK CEMT SET UOW Function: Commit or back out a shunted unit of work. Description: The SET UOW command enables you to commit, back out, or force a unit of work that has beenshunted during the transaction’s in-doubt period. Syntax 55─ ─ ─CEMT Set UOW( value ) ─ ─┬ ┬ ─ ─( v...

CEMT SET VTAM CEMT SET VTAM Function: Open or close the VTAM ACB, set the persistent session delay interval (PSDI), or deregister CICSfrom membership of a generic resource. Syntax: Press the Clear key to clear the screen. There are two ways of commencing this transaction: Ÿ Type CEMT SET VTAM (the m...

CEMT SET WEB | CEMT SET WEB | Function: Open or close CICS internal sockets support, | change Web garbage collection settings, or change Web| 3270 terminal timeout settings. | Input: Press the Clear key to clear the screen. There are | two ways of commencing this transaction: | Ÿ Type CEMT SET WEB (...

CEOT—terminal status Chapter 12. CEOT—terminal status The CEOT command allows you to inquire about the statusof your own terminal, and to change some of its values. Youcannot use CEOT to inquire about or change the values ofany other terminal. You can start CEOT from 3270 family display devices, orf...

CESF—sign off Chapter 13. CESF—sign off Use the CESF transaction to sign off from the CICS system. This transaction: Ÿ Writes the signoff message to your terminal Ÿ Logs the message on the transient data destinationCSCS Ÿ Logs any error message on the transient datadestination CSMT. If you are using...

CESN—sign on Chapter 14. CESN—sign on By default, intending users of CICS see the CICS“good-morning” panel displayed when they logon to CICS asa VTAM application (see Figure 142). à ð \\\\\\\ \\\\\\\ \\\\\\\ \\\\\\\ \\ \\\\\\\\\ \\\\\\\ \\\\\ \\\\\\\\\ \\\\\\\ \\\\\\\\\ \\\\\\\\\ \\\ \\\\\\\\\ \\\\\...

CESN—sign on Non-3270 family terminal A user can also sign on by providing all the user informationalong with the transaction id, as follows: | 55─ ─ ─CESN USERID= uuuuuuuu ─ ─CESN ───────────────5 | 5─ ─ ─USERID= uuuuuuuu ─ ─┬ ┬ ─────────────────── ─────5 └ ┘ ─ ─,GROUPID= gggggggg 5─ ─ ─┬ ┬ ───────...

CEST—supervisory terminal Chapter 15. CEST—supervisory terminal Use CEST to invoke a subset of the master terminal (CEMT)transaction. The CEST INQ|SET commands allows you toinquire about and alter some of the values of lines,netnames, tasks, and terminals. CEST can be invoked from 3270 family displa...

CETR—trace control Chapter 16. CETR—trace control Use CETR to control CICS tracing activity. Start the transaction by typing CETR on the command line ofyour display, as follows: CETR Press the ENTER key. You get the following display, with the values of your ownsystem in each of the fields. à ð CETR...

CETR—trace control The equal sign “=” can be used, when changing severalfields, to indicate that a particular field should be changed tothe same value as the one above. The complete list of components is: Components marked * are subcomponents of the APdomain, and the trace entries for these componen...

CETR—trace control STANDARD tracing OFF. (STANDARD tracing can also beturned off by coding SYSTR=OFF at system initialization.)You can then press PF4 for the “components trace options”screen, shown in Figure 146 on page 221, where you selectthe levels of tracing for the required components under the...

CIND—in-doubt testing tool Chapter 17. CIND—in-doubt testing tool Use CIND to: Ÿ Test the effect of in-doubt failures on applicationprograms Ÿ Produce shunted units of work (UOWs) to test programsthat use SPI commands to inquire on, and change thecharacteristics of, shunted UOWs Ÿ Unshunt UOWs that ...

CIND—in-doubt testing tool The CICS recovery manager domain unshunts allUOWs that were previously shunted because of the tool.The commit or backout specifies what happened in thedummy coordinator DFHINDSP, and hence what theCICS recovery manager domain instructs itssubordinates to do when the unshun...

CMAC—messages and codes display Chapter 18. CMAC—messages and codes display Use CMAC to give you individual message information asprovided in the CICS Messages and Codes manual. To use the CMAC transaction: Ÿ Add the DFHCMAC group on the CICS system definition(CSD) file to your initialization list (...

CMSG—message switching Chapter 19. CMSG—message switching Use CMSG to send messages from your terminal to one ormore destinations. The destination may be: Ÿ Another terminal Ÿ Another terminal, but only when a specified operator issigned on at that terminal Ÿ Another terminal, but only when the oper...

CMSG—message switching Canceling a message You can cancel your current message-switching transactionby entering: Ÿ CANCEL as the last 6 characters of your input. You getthe response: TERMINATED BY OPERATOR. Ÿ CMSG as your first 4 characters, followed by end-of-data(EOD). You get the response: NO INP...

CMSG—message switching When the processing status is TRANSACTION, you mustrequest message delivery by entering a paging command,see Chapter 22, “CSPG—page retrieval” on page 253. A message is formed into one or more “pages”, the size ofwhich is predefined for a destination by the systemprogrammer. T...

CMSG—message switching Command syntax ┌ ┐ ── ────────────── 55─ ─ ─CMSG ─ ─┬ ┬ ────── ─ ─'message' ─ ─┬ ┬ ───────────────────────────────────────────────── ─ ── 6 ┴ ┬ ┬ ──────────── ──────5 └ ┘ ─MSG=─ │ │ ┌ ┐ ── ─────────────── └ ┘ ─,OPCLASS=n─ └ ┘ ─,ROUTE=─ ─ ─┬ ┬ ─ ── 6 ┴ ─Termid──/opid─ ─────────...

CMSG—message switching Notes: 1. In all cases, the delivery time that you request must be less than 100 hours from the beginning of thecurrent day. This means that the delivery time cannever be later than 03.59 on the fourth day from thecurrent day. | 2. When processing date options entered in the f...

CMSG—message switching | date. For example, if you specify | FULLDATE=07/29/1998 and TIME=1130, the | message is transmitted at 11.30 on 07/29/1998. | Note: In all cases, the delivery time that you request | must be less than 100 hours from the beginning | of the current day. This means that the del...

CMSG—message switching $ is provided as the second character. (Forexample, PROTECT=T causes a prefix of T$.) If this option is omitted, a default prefix of ** is used. **is also the default for user application programs issuingBMS message requests where no protection is specified(REQID option omitte...

CMSG—message switching Ÿ If you specify ROUTE=(.L1,.L2), all entries fromDFHTLTL1 are included as destinations.Duplicate entries within DFHTLTL1 are kept. Allentries from DFHTLTL2 are checked forduplicates against the entries in the previouslyspecified DFHTLTL1 and, if a duplicate isfound, it is not...

CMSG—message switching If you specify a delivery time on the current day that fallswithin the past hour, it is interpreted as a request forimmediate delivery. An earlier time than that isconsidered already passed and is treated as an error.The following message is issued: TIME ALREADY PASSED Note th...

CMSG—message switching If a destination is specified by /opid without termid, itbecomes termid/opid, in which termid is the identifier of thefirst terminal or LU to which an operator with that identifier iscurrently signed on. If no such terminal or LU is found, thedestination is not valid and the o...

CMSG—message switching Message-switching responses Every input from the terminal receives a response. Mostresponses are preceded by indicators where the lettersbefore OK represent the first character of each of the CMSGoptions (except CANCEL) as follows: D DATE E ERRTERM H HEADING I ID M MSG O OPCLA...

CMSG—message switching specification to be eliminated. The message isrouted following this input. 3. Any option that causes a return to normal option processing mode. If another ERRTERM option isnot entered to correct this condition, the same errormessage is repeated after SEND has beenreentered. HE...

CMSG—message switching UNSUP OPRT TRMNL xxxxxxxx An operator identifier without a terminal identifier wasspecified as a ROUTE destination; however thatoperator is signed on to a terminal that is a type notsupported by BMS and is, therefore, an invaliddestination. The valid reply to this is the same ...

CRTE—remote transactions Chapter 20. CRTE—remote transactions Use CRTE to run transactions that reside on a remotesystem. Transaction routing in a multiregion operation (MRO)environment or for intersystem communication (ISC) isusually achieved by making entries in the PCT. The entriesdefine the tran...

CSFE—terminal and system test Chapter 21. CSFE—terminal and system test Use CSFE to diagnose terminal problems and softwareproblems. This transaction is mainly intended to be used bysystem programmers and IBM field engineers. Use this transaction to: Ÿ Test your terminal Ÿ Activate the system spooli...

CSFE—terminal and system test Debug functions Storage freeze, the storage violation trap and the globaltrap/trace exit are all debugging functions that are controlledby the CSFE transaction. These functions are described inthe following sections. Storage freeze You can use CSFE DEBUG to freeze stora...

CSFE—terminal and system test Global trap/trace program exit and globalkernel exit You can use CSFE DEBUG with the TRAP or GTRAPoperand to activate and deactivate the global trap/traceprogram exit routine or the global kernel exit routinerespectively. These exits are intended to be used only under t...

CSPG—page retrieval Chapter 22. CSPG—page retrieval Some transactions, especially those performed on screens,produce a response that is too large to be displayed orprinted at one time. The whole response is held on directaccess storage, and only the first portion (called a page) isdisplayed. You can...

CSPG—page retrieval *ldc Is the LDC for the device to which you want to send themessage. (See Page retrieval for logical devices.) *ALL A special case of *ldc. Hhhhhh Is the 6-digit hexadecimal identifier of an undeliveredlogical message to be retrieved. You would normallydetermine this identifier b...

CSPG—page retrieval Display information about logicalmessages This command displays the message identifiers and titles oflogical messages queued for this terminal. getpageQ Getpage The user-defined identification code for the retrievaltransaction, and is 1–7 characters long. The PGRETsystem initiali...

CSPG—page retrieval C/PREC 1ð43 This finds the personnel record for employee number 1043.PREC is the identifier of a user-written transaction forexamining personnel records. Receive: NAME - BERESFORD, JERRY A.EMPLOYEE NO - 1ð43(and so on) To go back to the list of names, enter: T/C T/ is the user-de...

CSPG—page retrieval Hhhhhh The 6-digit hexadecimal identifier of a specific,undelivered logical message to be erased. (Thisidentifier would have been determined using a pagequery command.) If the message specified issecurity-protected, the operator should have a securitycode that matches the one in ...

CWTO—write to console operator Chapter 23. CWTO—write to console operator Use CWTO to send messages to the console operator. Start the transaction by entering CWTO, optionally followedby the text of your message, on the command line of thescreen, as follows: 55─ ─ ─CWTO ─ ─Message ─5% Press the ENTE...

DSNC—write to console operator Chapter 24. DSNC—CICS DB2 transaction DSNC The DSNC transaction can be used to perform the following: Ÿ Enter DB2 commands from a CICS terminal. Ÿ Cause threads to be terminated when they are released(DSNC DISCONNECT). Ÿ Display information about transactions using the...

Appendix Appendix. List of CICS transactions The following table lists all the transactions that are suppliedwith CICS, except for those that are part of CICS sampleprograms. The transactions that have operator interfaces, and which aretherefore described in this manual, are marked by an asterisk(*)...

Index Special Characters ? and CEMT 45 (VALUE) CEMT INQUIRE JMODEL 92 CEMT INQUIRE JOURNALNAME 93 CEMT SET PROCESSTYPE 192 * and CEMT 47 *ALL CSPG 254 *LDC CMSG 239 − TERMID*LDC/OPID CMSG 239 + in CEMT syntax 47 + in scrolling under CEMT 48 + HHMM CMSG 244 + M CMSG 244 + MM CMSG 244 + TERMID*LDC/OPI...

Sending your comments to IBM If you especially like or dislike anything about this book, please use one of the methods listed below to send your comments toIBM. Feel free to comment on what you regard as specific errors or omissions, and on the accuracy, organization, subject matter, orcompleteness ...