Add CICS DCT Entry (ADDCICSDCT)

Use the Add CICS Destination Control Table (ADDCICSDCT) command to add an entry to the DCT.

Each DCT entry defines a destination to which data may be sent. In CICS systems, a destination is a transient data (TD) queue. There are four types of destination:

Intrapartition, which exists in the local CICS region
Extrapartition, which exists outside the local CICS region
Remote, which exists on another CICS system
Indirect, which points to a destination controlled by another DCT entry

Create one DCT entry for each transient data queue.

Also use the DCT to define whether or not an intrapartition TD queue may be used for automatic transaction initiation (ATI).

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Communications name, LIBL, CURLIB	Required, Positional 1
GROUP	Group	Communications name	Required, Positional 2
DEST	Destination	Communications name	Required, Positional 3
TYPE	Type	EXTERNAL, INDIRECT, INTERNAL, REMOTE	Required, Positional 4
DESTSTS	Status	ENABLED, DISABLED	Optional, Positional 5
RECOVER	Recoverable	NO, YES	Optional, Positional 6
TRGLVL	ATI trigger level	0-32767, 0	Optional, Positional 7
TRANSID	Transaction	Character value, ' '	Optional, Positional 8
DEVTYPE	CICS device indicator	TERMINAL, FILE	Optional, Positional 9
CICSDEV	CICS device	Communications name, *DEST	Optional, Positional 10
FILE	File	Qualified object name	Optional, Positional 11
	Qualifier 1: File	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
MBR	Member	Name, *FIRST	Optional, Positional 12
OPENOPTION	File processing	INPUT, OUTPUT, *READBACK	Optional, Positional 13
RCDFMT	Record format	FIXED, VARIABLE	Optional, Positional 14
STGDEV	Device	DASD, TAPE, DISKETTE, PRINTER	Optional, Positional 15
RMTDEST	Remote destination	Communications name, *DEST	Optional, Positional 16
SYSID	Remote CICS system	Communications name	Optional, Positional 17
LENGTH	Maximum record length	0-32767, 0	Optional, Positional 18
PHYDEST	Indirect destination	Communications name	Optional, Positional 19

Top

Library (LIB)

Enter the name of the OS/400 library that contains the group. Possible values are:

*LIBL: The library list is used to locate the first OS/400 library that contains the group.
*CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
library-name: The name of the OS/400 library that contains the group.

Group (GROUP)

Enter the name of the group to which this destination control table entry is to be added.

group-name: The group name may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Destination (DEST)

Enter the destination identifier. This identifier will be used in EXEC CICS commands to access transient data queues. This identifier is also the name that will be used to identify this DCT entry.

destination: The destination identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Type (TYPE)

Enter the type of the transient data queue.

Possible values are:

*INTERNAL: Indicates an intrapartition destination, that is a destination that is within the CICS control region.
*INDIRECT: Indicates an indirect destination, that is a logical destination that points to another destination, which is defined in the DCT as an internal, external, or remote destination. This allows several logical destinations to be merged into one physical destination.
*EXTERNAL: Indicates an extrapartition destination, that is a destination that is outside, but allocated to, the CICS control region.
*REMOTE: Indicates a remote destination, that is a destination on another system or region, where it is defined in the DCT as an internal destination.

Status (DESTSTS)

Indicates whether or not the destination identifier can be used. This parameter is not valid for internal destinations, that is when the type field contains *INTERNAL.

Possible values are:

*ENABLED: This destination identifier can be used. If the type field contains *EXTERNAL, then this transient data queue will be opened when the run time system is installed.
*DISABLED: This destination identifier cannot be used. If the type field contains *EXTERNAL, then this transient data queue will not be opened when the run time system is installed.

Recoverable (RECOVER)

Indicates whether or not the transient data queue associated with the destination identifier is recoverable or not recoverable. The field is valid only for an internal destination, that is when the type field contains *INTERNAL.

Note: If this DCT entry is defining CSMT, this field must be *NO.

Possible values are:

*NO: The transient data queue is not recoverable.
*YES: The transient data queue is recoverable.

ATI trigger level (TRGLVL)

Enter the number of records to accumulate in the queue in order to start automatically the transaction to process them. This is known as automatic transaction initiation (ATI). This field is valid only for internal destinations, that is when the type field contains *INTERNAL.

The transaction identifier is specified in the transaction identifier field.

Possible values are:

0: There is no ATI for this destination.
trigger-level: Enter a number in the range 0 through 32767.

Transaction (TRANSID)

Enter the name of the transaction to be started when the number of records in the queue reaches the trigger level. This field is not valid if the trigger level field contains 0.

transaction-identifier: The transaction identifier may have a maximum length of 4 characters. Any characters on the keyboard can be entered, but lowercase letters and special characters should be enclosed in apostrophes.
When there is not enough space to enter the apostrophes, then enter an ampersand (&) in the first character position to get an extended field size that allows for the entry of additional characters. Blanks are accepted but, when the entry is defined to a control region, anything after the blank is ignored. For example, 'ab g' will be treated as 'ab' in the control region.

Hexadecimal characters should be enclosed in apostrophes and preceded by an uppercase X, for example X'A1A2A3A4'. Any hexadecimal value will be accepted, but, if the value is not a printable character, the entry will be rejected when it is defined to a control region.

CICS device indicator (DEVTYPE)

Indicates whether or not a terminal identifier is to be associated with the ATI transaction identifier. This parameter is not valid if the trigger level field contains 0.

Possible values are:

*TERMINAL: A terminal identifier will be associated with the transaction identifier.
*FILE: No terminal identifier will be associated to the CICS transaction identifier.

CICS device (CICSDEV)

Enter the identifier of the terminal to be used to run the ATI transaction. This field is valid only when the device type field contains *TERMINAL.

Possible values are:

*DEST: The identifier entered in the destination field will be used as the terminal identifier.
terminal-identifier: The terminal identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

File (FILE)

Enter the name of the file that will be used by the destination identifier. This field is valid only for an extrapartition destination, that is when the type field contains *EXTERNAL.

Possible library values are:

*LIBL: The library list for the job that is associated to the CICS control region is used to locate the file.
*CURLIB: The current library for the job that is associated to the CICS control region is used to locate the file. If no library is specified as the current library, the QGPL library is used.
library-name: Specify the name of the library where the file is located.

file-name: Specify the name of the file.

Member (MBR)

Enter the name of the member that will be used by the destination identifier. This field is valid only for extrapartition destinations, that is when the type field contains *EXTERNAL.

Possible values are:

*FIRST: No member is specified. The first member is used.
member-name: Specify the name of the member.

File processing (OPENOPTION)

Indicates how the file is to be processed, namely:

A read-forwards only input file
A write-only output file
A read-backwards only input file.

This parameter is valid only for extrapartition destinations, that is when the type field contains *EXTERNAL.

Possible values are:

*INPUT: The file is to be used for input that will only be read forward.
*OUTPUT: The file is used for output.
*READBACK: The file is used for input that will only be read backwards.

Record format (RCDFMT)

Indicates the record format of the file. This field is valid only for extrapartition destinations, that is when the type field contains *EXTERNAL.

Possible values are:

*FIXED: All records in the file have the same length.
*VARIABLE: The records in the file are of variable lengths.

Device (STGDEV)

Indicates the storage medium of the file. This parameter is valid only for extrapartition destinations, that is when the type field contains *EXTERNAL.

Possible values are:

*DASD: The file is located on disk storage.
*TAPE: The file is located on magnetic tape.
*DISKETTE: The file is located on diskette.
*PRINTER: The file is written to a printer.

Remote destination (RMTDEST)

Enter the identifier by which the destination is known on the remote system. This field is valid only for remote destinations, that is when the type field contains *REMOTE.

Possible values are:

*DEST: The identifier entered in the destination identifier field will be used.
remote-destination: The destination identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Remote CICS system (SYSID)

Enter the remote system identifier. The system must have an entry in the remote TCS. This field is valid only for a remote destination, that is when the type field contains *REMOTE.

system-identifier: The system identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.

Maximum record length (LENGTH)

Enter the maximum length in bytes of the records in the transient data queue. This value must be the same as that specified for the queue in the remote system. This field is valid only for remote queues, that is when the type field contains *REMOTE.

Possible values are:

0: The LENGTH parameter will be specified in EXEC CICS READQ TD or WRITEQ TD commands within an application program.
length: Enter a number in the range 0 through 32767.

Indirect destination (PHYDEST)

Enter the identifier of the destination to which this DCT entry points. This identifier should have a DCT entry defining the queue as *INTERNAL, *EXTERNAL, or *REMOTE. This field is valid only for indirect destinations, that is when the type field contains *INDIRECT.

indirect-destination: The identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.