CICS Resource Control Table

This chapter describes the DCT macro and JCT macro used by the previous version of CICS.

1. DCT Macro (DFHDCT)

The general syntax of the macro is as follows:

DFHDCT TYPE=type[,keywords…]

There are 8 DCT macro types: GROUP, FINAL, INITIAL, SDSCI, EXTRA, INDIRECT, INTRA, and REMOTE. Among them three types (EXTRA, INDIRECT, and INTRA) are used as the TYPE of TDQUEUE when being converted by the oscdct2rd tool.

The keywords that can be defined for each of the types will be explained in the following section.

GROUP

The Group to apply when converting DCT to TDQUEUE can be specified by using the oscdct2rd tool. All the TDQUEUEs defined between one GROUP and the next GROUP are defined as the GROUP name formerly defined during the migration process.

Syntax
```
DFHDCT TYPE=GROUP,
       GROUP=group_name
```
Element Description

GROUP

Specifies the group name up to 8 bytes. It will be used as the GROUP property during the conversion.

Element	Description
GROUP	Specifies the group name up to 8 bytes. It will be used as the GROUP property during the conversion.

FINAL

Indicates the end of the DCT macro. Not used in the oscdct2rd tool.

INITIAL

Indicates the start of the DCT macro. The remaining properties, excluding USERID, will not be used during the conversion with the oscdct2rd tool.

Syntax

DFHDCT TYPE=INITIAL,
       USERID=name

Element	Description
USERID	Specifies the user ID up to 8 bytes. Among the INTRA TDQUEUEs in the DCT, if a USERID for ATI is not specified, this element will be used as the default value for the USERID, during the conversion.

Element

Description

USERID

Specifies the user ID up to 8 bytes. Among the INTRA TDQUEUEs in the DCT, if a USERID for ATI is not specified, this element will be used as the default value for the USERID, during the conversion.

SDSCI

Defines the DCB (Data Control Block) for EXTRA TDQUEUE. DSCNAME is a required element and must be specified when defining the SDSCI type. The elements excluded from the table are properties that will be ignored during the conversion.

Syntax

DFHDCT TYPE=SDSCI,
       BLKSIZE=number,
       DSCNAME=name ,
       RECFORM={FIXUNB|FIXUNBA|FIXUNBM|FIXBLK|FIXBLKA|FIXBLKM|VARBLK|
                VARBLKA|VARBLKM|VARUNB|VARUNBA|VARUNBM},
       RECSIZE=number

Element	Description
BLKSIZE	Specifies the maximum value of data set block size. This element will be used as the BLOCKSIZE of EXTRA TDQUEUE during the conversion.
DSCNAME	Specifies the SDSCI name up to 8 bytes. Refer to DSCNAME of EXTRA TDQUEUE.
RECFORM	Specifies the record type of EXTRA TDQUEUE. This will be used for properties RECORDFORMAT, BLOCKFORMAT, and PRINTCONTROL of EXTRA TDQUEUE. The conversion rules are as follows: The first 3 bytes, FIX or VAR, will be converted to FIXED or VARIABLE of RECORDFORMAT respectively. The next 3 bytes, UNB or BLK, will be converted to UNBLOCKED or BLOCKED of BLOCKFORMAT. If the 7th byte is A or M, it will be converted to ASA of PRINTCONTROL or MACHINE of PRINTCONTROL respectively. If the 7th byte does not exist, the value for PRINTCONTROL will not be set.
RECSIZE	Specifies the record length. This element will be used as the RECORDSIZE element of EXTRA TDQUEUE.

Element

Description

BLKSIZE

Specifies the maximum value of data set block size. This element will be used as the BLOCKSIZE of EXTRA TDQUEUE during the conversion.

DSCNAME

Specifies the SDSCI name up to 8 bytes. Refer to DSCNAME of EXTRA TDQUEUE.

RECFORM

Specifies the record type of EXTRA TDQUEUE. This will be used for properties RECORDFORMAT, BLOCKFORMAT, and PRINTCONTROL of EXTRA TDQUEUE. The conversion rules are as follows:

The first 3 bytes, FIX or VAR, will be converted to FIXED or VARIABLE of RECORDFORMAT respectively.
The next 3 bytes, UNB or BLK, will be converted to UNBLOCKED or BLOCKED of BLOCKFORMAT.
If the 7th byte is A or M, it will be converted to ASA of PRINTCONTROL or MACHINE of PRINTCONTROL respectively. If the 7th byte does not exist, the value for PRINTCONTROL will not be set.

RECSIZE

Specifies the record length. This element will be used as the RECORDSIZE element of EXTRA TDQUEUE.

EXTRA

Defines the EXTRA TDQUEUE. The DESTID and the DSCNAME are required elements and must be specified when defining EXTRA type. The elements excluded in the table are properties that will be ignored during the conversion.

Syntax

DFHDCT TYPE=EXTRA,
       DESTID=name ,
       DSCNAME=name,
       RMTNAME=name,
       SYSIDNT=name

Element	Description
DESTID	Specifies the EXTRA TDQUEUE name, up to 4 bytes.
DSCNAME	Specifies the DSCNAME of SDSCI which will retrieve the DCB information related properties from the corresponding EXTRA TDQUEUE.
RMTNAME	Specifies the name in the remote region of remote TDQUEUE. If blank is specified, it is regarded as the same as the DESTID. This element is effective only when SYSIDNT is specified. If SYSIDNT is not specified, this element will be ignored during the conversion. This element will be used as REMOTENAME element of TDQUEUE during the conversion.
SYSIDNT	Specifies the SYSID of the remote region that has the corresponding TDQUEUE. If this element is specified, TYPE element will not be set during the conversion and all elements excluding RMTNAME and SYSIDNT will be ignored. This element will be used as the REMOTESYSTEM element of TDQUEUE during the conversion.

Element

Description

DESTID

Specifies the EXTRA TDQUEUE name, up to 4 bytes.

DSCNAME

Specifies the DSCNAME of SDSCI which will retrieve the DCB information related properties from the corresponding EXTRA TDQUEUE.

RMTNAME

Specifies the name in the remote region of remote TDQUEUE. If blank is specified, it is regarded as the same as the DESTID. This element is effective only when SYSIDNT is specified. If SYSIDNT is not specified, this element will be ignored during the conversion. This element will be used as REMOTENAME element of TDQUEUE during the conversion.

SYSIDNT

Specifies the SYSID of the remote region that has the corresponding TDQUEUE. If this element is specified, TYPE element will not be set during the conversion and all elements excluding RMTNAME and SYSIDNT will be ignored. This element will be used as the REMOTESYSTEM element of TDQUEUE during the conversion.

INDIRECT

Defines the INDIRECT TDQUEUE. All elements are required elements and must be specified when defining INDIRECT type.

Syntax

DFHDCT TYPE=INDIRECT ,
       DESTID=name,
       INDDEST=name

Element	Description
DESTID	Specifies the INDIRECT TDQUEUE name up to 4 bytes.
INDDEST	Specifies the TDQUEUE name up to 4 bytes to refer indirectly. The type of TDQUEUE does not matter. This element will be used as the INDIRECTNAME element of INDIRECT TDQUEUE during the conversion.

Element

Description

DESTID

Specifies the INDIRECT TDQUEUE name up to 4 bytes.

INDDEST

Specifies the TDQUEUE name up to 4 bytes to refer indirectly. The type of TDQUEUE does not matter. This element will be used as the INDIRECTNAME element of INDIRECT TDQUEUE during the conversion.

INTRA

Defines the INTRA TDQUEUE. The DESTID is a required element and must be specified when defining INTRA type. The elements excluded in the table are properties that will be ignored during the conversion.

Syntax

DFHDCT TYPE=INTRA,
       DESTID=name,
       DESTFAC={(TERMINAL [,trmid])|FILE},
       DESTRCV={NO|PH|LG},
       RMTNAME=name,
       SYSIDNT=name,
       TRANSID=name,
       TRIGLEV=number,
       USERID=name

Element	Description
DESTID	Specifies the INTRA TDQUEUE name up to 4 bytes.
DESTFAC	Specifies the facility that is integrated with TDQUEUE. If trmid is given, this element will be used as the FACILITYID element. This element will be used as the ATIFACILITY element of INTRA TDQUEUE during a conversion.
DESTRCV	Decides whether to recover when an error occurs. NO: NO PH: PHYSICAL LG: Converts to LOGICAL This element will be used as the RECOVSTATUS element of INTRA TDQUEUE during conversion.
RMTNAME	Specifies the name in the remote region of remote TDQUEUE. If blank is specified, it is regarded as the same as DESTID. This element is effective only when SYSIDNT is specified. If SYSIDNT is not specified, this element will be ignored during the conversion. This element will be used as REMOTENAME element of TDQUEUE during the conversion.
SYSIDNT	Specifies the SYSID of the remote region which has the corresponding TDQUEUE. If this element is specified, TYPE element will not be set during the conversion and all elements excluding RMTNAME and SYSIDNT will be ignored. This element will be used as the REMOTESYSTEM element of TDQUEUE during the conversion.
TRANSID	Specifies the transaction ID started through ATI. This element will be used as the TRANSID element of INTRA TDQUEUE during the conversion.
TRIGLEV	Specifies the number of records required before ATI is generated. This element will be used as the TRIGLEVEL element during the conversion.
USERID	Specifies the user ID for security check of the transaction started through ATI. This element will be used as the USERID of INTRA TDQUEUE during the conversion.

Element

Description

DESTID

Specifies the INTRA TDQUEUE name up to 4 bytes.

DESTFAC

Specifies the facility that is integrated with TDQUEUE. If trmid is given, this element will be used as the FACILITYID element. This element will be used as the ATIFACILITY element of INTRA TDQUEUE during a conversion.

DESTRCV

Decides whether to recover when an error occurs.

NO: NO
PH: PHYSICAL
LG: Converts to LOGICAL

This element will be used as the RECOVSTATUS element of INTRA TDQUEUE during conversion.

RMTNAME

Specifies the name in the remote region of remote TDQUEUE. If blank is specified, it is regarded as the same as DESTID. This element is effective only when SYSIDNT is specified. If SYSIDNT is not specified, this element will be ignored during the conversion. This element will be used as REMOTENAME element of TDQUEUE during the conversion.

SYSIDNT

Specifies the SYSID of the remote region which has the corresponding TDQUEUE. If this element is specified, TYPE element will not be set during the conversion and all elements excluding RMTNAME and SYSIDNT will be ignored. This element will be used as the REMOTESYSTEM element of TDQUEUE during the conversion.

TRANSID

Specifies the transaction ID started through ATI. This element will be used as the TRANSID element of INTRA TDQUEUE during the conversion.

TRIGLEV

Specifies the number of records required before ATI is generated. This element will be used as the TRIGLEVEL element during the conversion.

USERID

Specifies the user ID for security check of the transaction started through ATI. This element will be used as the USERID of INTRA TDQUEUE during the conversion.

REMOTE

Defines the REMOTE TDQUEUE. In the case of the REMOTE type, the TYPE property will not be specified during the conversion. The DESTID and the SYSIDNT are required elements and must be specified when defining REMOTE type.

Syntax

DFHDCT TYPE=REMOTE,
       DESTID=name,
       RMTNAME=name,
       SYSIDNT=name

Element	Description
DESTID	Specifies the REMOTE TDQUEUE name up to 4 bytes.
RMTNAME	Specifies the name in the remote region of remote TDQUEUE. If blank is specified, it is regarded as same as the DESTID. This element will be used as the REMOTENAME element of TDQUEUE during the conversion.
SYSIDNT	Specifies the SYSID of the remote region which has the corresponding TDQUEUE. This element will be used as the REMOTESYSTEM element of TDQUEUE during the conversion.

Element

Description

DESTID

Specifies the REMOTE TDQUEUE name up to 4 bytes.

RMTNAME

Specifies the name in the remote region of remote TDQUEUE. If blank is specified, it is regarded as same as the DESTID. This element will be used as the REMOTENAME element of TDQUEUE during the conversion.

SYSIDNT

Specifies the SYSID of the remote region which has the corresponding TDQUEUE. This element will be used as the REMOTESYSTEM element of TDQUEUE during the conversion.

DCT macro file example

An actual DCT macro file example is as follows:

DFHDCT TYPE=INITIAL
         DFHDCT TYPE=SDSCI,DSCNAME=SDSCI01,                            X
                RECFORM=FIXUNB
         DFHDCT TYPE=EXTRA,DSCNAME=SDSCI01,                            X
                DESTID=EXTR
         DFHDCT TYPE=INTRA,DESTID=INTR,TRIGLEV=5,                      X
                DESTFAC=TERMINAL,TRANSID=AUTO
         DFHDCT TYPE=INDIRECT,DESTID=INDR,INDDEST=BETA
         DFHDCT TYPE=REMOTE,DESTID=REMT,RMTNAME=INDR,                  X
                SYSIDNT=CICA
         DFHDCT TYPE=FINAL
         END

The converted TDQUEUE resource definition result is as follows:

DEFINE  TDQUEUE(EXTR)
        GROUP(OSCGROUP)
        TYPE(EXTRA)
        RECORDFORMAT(FIXED)
        BLOCKFORMAT(UNBLOCKED)

DEFINE  TDQUEUE(INTR)
        GROUP(OSCGROUP)
        TYPE(INTRA)
        ATIFACILITY(TERMINAL)
        TRANSID(AUTO)
        TRIGGERLEVEL(5)

DEFINE  TDQUEUE(INDR)
        GROUP(OSCGROUP)
        TYPE(INDIRECT)
        INDIRECTNAME(BETA)

DEFINE  TDQUEUE(REMT)
        GROUP(OSCGROUP)
        REMOTENAME(INDR)
        REMOTESYSTEM(CICA)

2. JCT Macro

This section describes the JCT macro used by a previous version of CICS.

The general syntax of the macro is as follows:

DFHDCT TYPE=type[,keywords…]

There are three JCT macro types: FINAL, INITIAL, and ENTRY.

The keywords that can be defined for each type are described in the following.

FINAL

Indicates the end of the JCT macro. Not used in the oscjct2rd tool.

INITIAL

Indicates the start of the JCT macro. Not used in the oscjct2rd tool.

ENTRY

Defines ENTRY for each journal. The elements excluded in the table are ignored during the conversion. If FORMAT key word is specified, the oscjct2rd tool sets the TYPE element of JOURNALMODEL resource definition to SMF, otherwise it sets it to MVS. For the JCT ENTRY where the TYPE element is converted to MVS, the STREAMNAME element must be set manually in the resource definition file.

Syntax

DFHDCT TYPE=ENTRY,
       JFILEID=name,
       FORMAT=SMF

Element	Description
JFILEID	Specifies SYSTEM or a number with the range of 2 and 99. This element will be used as the JOURNALNAME element of JOURNALMODEL during the conversion.
FORMAT	Specifies whether to write journal records to the SMF data set. This element will be used as the TYPE element of JOURNALMODEL during the conversion.

Element

Description

JFILEID

Specifies SYSTEM or a number with the range of 2 and 99. This element will be used as the JOURNALNAME element of JOURNALMODEL during the conversion.

FORMAT

Specifies whether to write journal records to the SMF data set. This element will be used as the TYPE element of JOURNALMODEL during the conversion.

JCT macro file example

An actual JCT macro file example is as follows:

DFHJCT TYPE=INITIAL
         DFHJCT TYPE=ENTRY,                                            X
                JFILEID=4,                                             X
                JTYPE=TAPE2,                                           X
                FORMAT=SMF,                                            X
                BUFSIZE=1500
         DFHJCT TYPE=FINAL
         END

The converted JOURNALMODEL resource definition result is as follows. The value of JOURNALMODEL is generated automatically by the oscjct2rd tool. The [-g] option is used to specify GROUP.

DEFINE  JOURNALMODEL(DFHJM04)
        GROUP(OSCGROUP)
        JOURNALNAME(DFHJ04)
        TYPE(SMF)