Setting up transient data destination data sets

Data sets used for transient data destinations (queues) can be intrapartition or extrapartition. This section tells you how to define data sets for transient data queues. The transient data intrapartition data set is a VSAM entry-sequenced data set (ESDS) used for queuing messages and data within the CICS® region. Transient data extrapartition data sets are sequential files, normally on disk or tape; each queue can be used either to send data outside the CICS region or to receive data from outside the region. For background information about intrapartition and extrapartition transient data, see the CICS Application Programming Guide.

Messages or other data are addressed to a symbolic queue which you define as either intrapartition or extrapartition using the CEDA transaction. The queues can be used as indirect destinations to route messages or data to other queues.

For information about coding transient data resources, see the CICS Resource Definition Guide.

System messages that CICS produces are commonly sent to transient data queues, either intrapartition or extrapartition. The following is a brief description of the queues used by CICS. Sample definitions for the CICS-supplied queues can be found in group DFHDCTG, which is included in list DFHLIST.

CADL
CEDA VTAM® resource log, indirect to CSSL.
CADO
AD resource log, indirect to CSSL.
CAIL
Autoinstall terminal model resource log, indirect to CSSL.
CCPI
CPI Communications message log, indirect to CSSL.
CCSE
C error data stream (stderr) log, indirect to CCSO.
CCSO
C output data stream (stdout) log,direct to COUT.
CCZM
Messages for CICS classes, indirect to CSSL.
CDB2
CICS DB2® message log, indirect to CSSL
CDBC
Database log, indirect to CSSL.
CDUL
Dump message log, indirect to CSSL.
CEJL
Enterprise bean message log, indirect to CSSL
CESE
Language Environment® error data stream (stderr), direct to CEEMSG.
CESO
Language Environment output data stream (stdout), direct to DD name CEEOUT.
CIEO
ECI over TCP/IP message log, indirect to CSSL.
CIIL
IIOP message log, indirect to CSSL.
CJRM
Java™ Remote Access Services message log, indirect to CSSL.
CMIG
Migration log to detect use of EXEC CICS ADDRESS CSA commands, indirect to CSSL.
CPLD
PL/I dumps, indirect to CPLI.
CPLI
PL/I SYSPRINT output, direct to DDname PLIMSG.
CRDI
RDO install log, indirect to CSSL.
CRPO
ONC/RPC message log, direct to DDname CRPO.
CSBA
CICS BTS message log, indirect to CSSL.
CSBR
Bridge message log, indirect to CSSL.
CSCC
CICS Client message log, indirect to CSSL.
CSCS
Signon/sign-off security log, indirect to CSSL.
CSDH
Document Domain message log, indirect to CSSL.
CSDL
CEDA command log, indirect to CSSL.
CSFL
File allocation message log, indirect to CSSL.
CSJE
JVM error data stream (stderr), indirect to CSSL.
CSJO
JVM output data stream (stdout), indirect to CSSL.
CSKL
Transaction and profile resource log, indirect to CSSL.
CSML
Signon/sign-off message log, indirect to CSSL.
CSMT
Terminal error message and transaction abend message log, indirect to CSSL.
CSNE
ZNAC-produced messages log, indirect to CSSL.
CSOO
Sockets message log, indirect to CSSL.
CSPL
Program resource log, indirect to CSSL.
CSQL
Transient data message log, indirect to CSSL
CSRL
Partner resource log, indirect to CSSL.
CSSH
Scheduler message log, indirect to CSSL.
CSSL
Message log, direct to DD name MSGUSR (all the other general CICS queues are defined as indirect queues to CSSL).
CSTL
Terminal I/O error log, indirect to CSSL.
CSZL
The queue used for Front End Programming Interface (FEPI) messages, indirect to CSSL. You do not have to define this queue if you do not have FEPI installed, but it is included in DFHDCTG.
CSZX
The queue used for Front End Programming Interface (FEPI) processing, indirect to CSSL. You do not have to define this queue if you do not have FEPI installed, but it is included in DFHDCTG.
CWBO
CICS Web support messages, indirect to CSSL.
Start of changeCWBWEnd of change
Start of changeHTTP warning headers on messages received by CICS Web support, indirect to CSSL.End of change

You should include in your CICS region all the queues that CICS uses. Although the omission of any of the queues does not cause a CICS failure, you lose important information about your CICS region if CICS cannot write its data to the required queue. Sample definitions of all the queues that CICS uses can be found in group DFHDCTG, which is included in list DFHLIST and is unlocked so that you can alter the definitions.

Note:
We recommend that you take a backup copy of the changes made to DFHDCTG in case maintenance is applied.

For information about the queues used by CICS, see the CICS Resource Definition Guide.

For information about the queues that CICS uses for RDO, see Multiple extents and multiple volumes.

For a way of printing these system messages on a local printer as they occur, see the transient data write-to-terminal sample program, DFH$TDWT. This sample program is supplied with the CICS pregenerated system in CICSTS31.CICS.SDFHLOAD, and the assembler source is in CICSTS31.CICS.SDFHSAMP. For programming information about DFH$TDWT, see the CICS Customization Guide.

[[ Contents Previous Page | Next Page Index ]]