Change CICS DCT Entry (CHGCICSDCT)
Where allowed to run:
- Batch job (*BATCH)
- Interactive job (*INTERACT)
- Batch program (*BPGM)
- Interactive program (*IPGM)
- Batch REXX procedure (*BREXX)
- Interactive REXX procedure (*IREXX)
- Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
|
Parameters
Examples
Error messages |
Use the Change CICS Destination Control Table (CHGCICSDCT) command to change an entry DCT.
Each DCT entry defines a destination to which data may be sent. In CICS systems, a destinations 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
The DCT also defines whether or not an intrapartition TD queue can be used for automatic transaction initiation (ATI).
| 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 |
*SAME, *EXTERNAL, *INDIRECT, *INTERNAL, *REMOTE |
Optional, Positional 4 |
| DESTSTS |
Status |
*SAME, *ENABLED, *DISABLED |
Optional, Positional 5 |
| RECOVER |
Recoverable |
*SAME, *NO, *YES |
Optional, Positional 6 |
| TRGLVL |
ATI trigger level |
0-32767, *SAME |
Optional, Positional 7 |
| TRANSID |
Transaction |
Character value, *SAME |
Optional, Positional 8 |
| DEVTYPE |
CICS device indicator |
*SAME, *TERMINAL, *FILE |
Optional, Positional 9 |
| CICSDEV |
CICS device |
Communications name, *SAME, *DEST |
Optional, Positional 10 |
| FILE |
File |
Qualified object name |
Optional, Positional 11 |
| Qualifier 1: File |
Name, *SAME |
| Qualifier 2: Library |
Name, *SAME, *LIBL, *CURLIB |
| MBR |
Member |
Name, *SAME, *FIRST |
Optional, Positional 12 |
| OPENOPTION |
File processing |
*SAME, *INPUT, *OUTPUT, *READBACK |
Optional, Positional 13 |
| RCDFMT |
Record format |
*SAME, *FIXED, *VARIABLE |
Optional, Positional 14 |
| STGDEV |
Device |
*SAME, *DASD, *TAPE, *DISKETTE, *PRINTER |
Optional, Positional 15 |
| RMTDEST |
Remote destination |
Communications name, *SAME, *DEST |
Optional, Positional 16 |
| SYSID |
Remote CICS system |
Communications name, *SAME |
Optional, Positional 17 |
| LENGTH |
Maximum record length |
0-32767, *SAME |
Optional, Positional 18 |
| PHYDEST |
Indirect destination |
Communications name, *SAME |
Optional, Positional 19 |
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 belongs the DCT entry to be changed.
- 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 transient data queue.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- *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.
Status (DESTSTS)
Indicates whether or not the destination identifier can be used. This field is not valid for intrapartition destinations, that is when the type field contains *INTERNAL.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- *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. This parameter is valid only for an intrapartition 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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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 intrapartition destinations, that is when the type field contains *INTERNAL.
The transaction identifier is specified in the transaction identifier field.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- 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 reaches the trigger level. This field is not valid if the trigger level field contains 0.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- 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 field is not valid when the trigger level field contains 0.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- *TERMINAL: A terminal identifier is associated with the ATI transaction identifier.
- *FILE: No terminal identifier is associated with the ATI 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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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.
Possible file name values are:
- *SAME: Keep the value currently specified in the DCT entry.
- 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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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 field is valid only for extrapartition destinations, that is when the type field contains *EXTERNAL.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- *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:
- *SAME: Keep the value currently specified in the DCT entry.
- *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 remote destinations, that is when the type field contains *REMOTE.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- 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:
- *SAME: Keep the value currently specified in the DCT entry.
- 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.
Possible values are:
- *SAME: Keep the value currently specified in the DCT entry.
- 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 #.