Extrapartition destinations—DFHDCT TYPE=EXTRA

Destinations outside the CICS® region (but which are allocated to CICS) are specified in the DFHDCT TYPE=EXTRA macro. This macro must be generated once for every extrapartition destination.

Extrapartition destinations are used for: Extrapartition data is sequential and is managed by QSAM.
Read syntax diagramSkip visual syntax diagram
>>-DFHDCT--TYPE=EXTRA--,DESTID=name--,DSCNAME=name-------------->

>--+----------------+--+----------------------+----------------->
   '-,LENGTH=length-'  |         .-INITIAL--. |   
                       '-,OPEN=--+----------+-'   
                                 '-DEFERRED-'     

>--+---------------+--+---------------+------------------------><
   '-,RMTNAME=name-'  '-,SYSIDNT=name-'   

TYPE=EXTRA
Indicates an extrapartition destination.
DESTID=name
Code this with the symbolic name of the extrapartition destination. The symbolic name is used in the transient data operations to specify the destination.

Any DESTID of more than four characters is truncated on the right.

The DESTID should not start with the letter C, which is reserved for defining the destinations required by some CICS facilities. This applies to DFHDCT TYPE=EXTRA, TYPE=INDIRECT, and TYPE=INTRA.

Do not use special characters, lower case, or mixed case characters in a DESTID name.

DSCNAME=name
Code this with the same file name you used in DFHDCT TYPE=SDSCI.

If two or more extrapartition destinations refer to the same SDSCI, only one destination can be open at the same time.

If OPEN=INITIAL is specified for each of these destinations, the choice of destination to be opened is arbitrary. To avoid this, define one of the destinations as extrapartition and the others as indirect on the first.

LENGTH=length
Specifies, as a decimal value, the record length in bytes of fixed-length records in the queue. The length you specify must correspond to the RECSIZE length on the associated SDSCI entry in the DCT.

A CICS region that references a remote DCT entry requires the length of the record. If you do not specify it on the DCT entry, the application program must specify it on the WRITEQ and READQ requests

If you omit the SYSIDNT parameter, LENGTH is ignored.

OPEN={INITIAL∨DEFERRED}
Code this with the initial status of the data set.
INITIAL
The data set is to be opened by system initialization.
DEFERRED
The data set remains closed until you indicate that you want to open it by using the CEMT INQUIRE∨SET TDQUEUE command.
RMTNAME=name
code this with the 1- to 4-character name by which the destination is known in the CICS region in which the destination resides (the remote region).

If you omit this parameter, CICS uses the name specified on the DESTID parameter (that is, the local and remote names are the same).

This parameter is meaningful only when you specify the SYSIDNT parameter.

SYSIDNT=name
Identifies the CICS region in which the remote transient data queue resides. The 4-character alphanumeric name specified must match the SYSIDNT system initialization parameter specified on the region that "owns" the queue (the region in which the queue is a local resource).

If you omit SYSIDNT, the queue is treated as a local queue.