Add CICS DCT Entry (ADDCICSDCT)
Where allowed to run:
|
Parameters Examples Error messages |
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).
| Top |
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 library that contains the group. Possible values are:
- *LIBL: The library list is used to locate the first 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 library that contains the group.
| Top |
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 #.
| Top |
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 #.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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 #.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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 #.
| Top |
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 #.
| Top |
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.
| Top |
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 #.
| Top |
Examples
None| Top |
Error messages
Unknown| Top |