Add destination control table (DCT) entries

The CEECDCT member in the SCEESAMP sample library contains the necessary input to create the transient data queues as extrapartition data queues.

Entries for the transient data queues used by Language Environment are required in the destination control table. Language Environment uses the following transient data queues:

CESE: messages, dumps, and reports are written to this queue. Each record written to the CESE queue has a header with terminal ID, transaction ID, date, and time. This queue is also used by C/C++ for stderr output and by PL/I for stream output data.
CESO: C/C++ stdout stream output is written to this queue. The definition for this queue is required only if you use C/C++. Each record written to the CESO queue has a header with terminal ID and transaction ID.
CIGZ: COBOL side file support for CEEDUMPs and Debug Tool. The definition for this queue is required only if you run COBOL programs compiled with the SEPARATE suboption of the TEST compiler option and you want to process side files using the CICS® Extrapartition Transient Data Queue (TDQ) interface. This is an input-only queue.

In order to use the COBOL side file support on CICS for COBOL programs compiled with the TEST(,SYM,SEPARATE) compiler option, you must define a transient data queue with the name CIGZ. Do not specify a DD for the CIGZ transient data queue in your CICS startup job. The DD will be dynamically allocated and deallocated as needed.

The following example is the source that can be used to define CIGZ in the DCT:

 IGZDBGIN DFHDCT TYPE=SDSCI,        COBOL Side File Support
                DSCNAME=IGZDBGIN,
                TYPEFLE=INPUT
 CIGZ     DFHDCT TYPE=EXTRA,        COBOL Side File Support
                DESTID=CIGZ,
                DSCNAME=IGZDBGIN,
                OPEN=DEFERRED

Figure 1 illustrates the format for the output transient data queues.

Figure 1. Format of an output transient data queue

ASA: The American National Standard carriage-control character
Terminal ID: A 4-character terminal identifier
Transaction ID: A 4-character transaction identifier
sp: A space
Timestamp: The date and time displayed in the same format as that returned by the CEELOCT service
Message: The message identifier and message text

These queues can have intrapartition, extrapartition, or indirect destinations. The record length for the transient data queue CESE must be at least 161.

We recommend that you put the required Language Environment entries in the CSD as TDQUEUE resource definitions (introduced in the CICS Transaction Server for z/OS). The Language Environment TD queues are included in the CICS-supplied CSD group called DFHDCTG, which is added to the DFHLIST automatically when initializing or upgrading a CSD. The following are the Language Environment entries created in the DFHDCTG:

  DEFINE TDQUEUE (CESO)         GROUP(DFHDCTG)
         DESCRIPTION(LE/370 OUTPUT QUEUE)
         TYPE(EXTRA)            TYPEFILE(OUTPUT)
         RECORDSIZE(133)        BLOCKSIZE(137)
         RECORDFORMAT(VARIABLE) BLOCKFORMAT(UNBLOCKED)
                                DDNAME(CEEOUT)
  *
  DEFINE TDQUEUE (CESE)         GROUP(DFHDCTG)
         DESCRIPTION(LE/370 ERROR QUEUE)
         TYPE(EXTRA)            TYPEFILE(OUTPUT)
         RECORDSIZE(161)        BLOCKSIZE(165)
         RECORDFORMAT(VARIABLE) BLOCKFORMAT(UNBLOCKED)
                                DDNAME(CEEOUT)
  *
  DEFINE TDQUEUE (CIGZ)         GROUP(DFHDCTG)
         DESCRIPTION(COBOL SIDE FILE INPUT QUEUE)
         TYPE(SDSCI)            TYPEFILE(INPUT)
                                DDNAME(IGZDBGIN)

See CICS Transaction Server for z/OS System Definition Guide for information provided by CICS about installing Language Environment support.

Use the DFHDCT macro to define the entries for CESE, CESO and CIGZ.

In addition to defining the transient data queues in the DCT, you must make sure that there is a DD statement in the CICS startup job for the transient data queues.

Note: Do not specify a DD for the CIGZ TDQ. It will be dynamically allocated and deallocated as needed.

If you define the CESE and CESO transient data queues as separate extrapartition data queues, the following example shows what you would specify in your CICS startup JCL:

     //CEEMSG   DD DSN=CUSTOMER.CEEMSG,DISP=SHR
     //CEEOUT   DD DSN=CUSTOMER.CEEOUT,DISP=SHR

For more information about the DFHDCT macro and the definitions of the queues and associated buffers, seeCICS Transaction Server for z/OS® System Definition Guide.

Figure 2. Example of DFHDCT macro

CEEMSG DFHDCT  TYPE=SDSCI, Language Environment messages, dumps, reports
               DSCNAME=CEEMSG,                              X
               BLKSIZE=165,                                 X
               RECSIZE=161,                                 X
               RECFORM=VARUNBA,                             X
               TYPEFLE=OUTPUT,                              X
               BUFNO=1
CESE   DFHDCT  TYPE=EXTRA,                                  X
               DESTID=CESE,                                 X
               DSCNAME=CEEMSG
CEEOUT DFHDCT  TYPE=SDSCI, C/C++ STDOUT stream              X
               DSCNAME=CEEOUT,                              X
               BLKSIZE=137,                                 X
               RECSIZE=133,                                 X
               RECFORM=VARUNBA,                             X
               TYPEFLE=OUTPUT,                              X
               BUFNO=1
CESO   DFHDCT  TYPE=EXTRA,                                  X
               DESTID=CESO,                                 X
               DSCNAME=CEEOUT
IGZDBGIN DFHDCT  TYPE=SDSCI, COBOL Side File Support        X
               DSCNAME=IGZDBGIN,                            X
               TYPEFLE=INPUT
CIGZ   DFHDCT  TYPE=EXTRA, COBOL Side File Support          X
               DESTID=CIGZ,                                 X
               DSCNAME=IGZDBGIN                             X
               OPEN=DEFERRED

Note: Xs are in column 72.

When DFHDCT encounters the entry names CESE, CESO, CIGZ, CEEMSG, and CEEOUT, it might generate messages stating that queue names beginning with the letter C are reserved for CICS. It is normal to receive these messages, and they do not indicate errors.