Managing destination definitions - IBM - AS/400

Each destination control table (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 entry to define whether or not an intrapartition TD queue may be used for automatic transaction initiation (ATI).

Using the ADDCICSDCT command
Flowchart

Using the ADDCICSDCT command Flowchart

Using the ADDCICSDCT command Flowchart

Using the ADDCICSDCT command Flowchart

Notes:

  1. The DESTSTS parameter is not valid when TYPE(*INDIRECT) is specified.
  2. The RECOVER parameter and TRGLVL parameter are valid only when TYPE(*INTERNAL) is specified.
  3. The TRANSID parameter and DEVTYPE parameter are not valid when TRGLVL(0) is specified.
  4. The CICSDEV parameter is valid only when DEVTYPE(*TERMINAL) is specified.
  5. The FILE parameter, MBR parameter, OPENOPTION parameter, RCDFMT parameter, and SSTGDEV parameter are valid only when TYPE(*EXTERNAL) is specified.
  6. The FILE parameter is required when TYPE(*EXTERNAL) is specified.
  7. The RMTDEST parameter, SYSID parameter, and LENGTH parameter are valid only when TYPE(*REMOTE) is specified.
  8. The SYSID parameter is required when TYPE(*REMOTE) is specified.
  9. The PHYDEST parameter is valid, and required, only when TYPE(*INDIRECT) is specified.
  10. All parameters preceding this point can be specified positionally.

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

Required parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 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.
  3. Group (GROUP)
  4. 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 $, @, or #.
  5. Destination (DEST)
  6. 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. If you are defining the CSMT log, this parameter must be CSMT.
    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 $, @, or #.
  7. Type (TYPE)
  8. Enter the type of the transient data queue.
    Possible values are:
    *INTERNAL: Indicates an intrapartition destination,that is a destination within the CICS/400 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 outside, but allocated to, the CICS/400 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. This type is not valid if you are defining the CSMT log.

Optional parameters

  1. Status (DESTSTS)
  2. Indicates whether or not the destination identifier can be used. This parameter is not valid for indirect destinations, that is when the
    Type (TYPE) parameter contains *INDIRECT.
    Possible values are:
    *ENABLED: This destination identifier can be used. If the Type (TYPE) parameter contains *EXTERNAL, then this transient data queue will be opened when the runtime system is installed.
    *DISABLED: This destination identifier cannot be used. If the Type TYPE) parameter contains *EXTERNAL, then this transient data queue will not be opened when the runtime system is installed.
  3. Recoverable (RECOVER)
  4. Indicates whether or not the transient data queue associated with the destination identifier is recoverable. The parameter is valid only for an internal destination, that is when the Type (TYPE) parameter contains *INTERNAL.
    Note: If this DCT entry is defining the CSMT log, this field value must be *NO.
    Possible values are:
    *NO: The transient data queue is not recoverable.
    *YES: The transient data queue is recoverable.
  5. ATI trigger level (TRGLVL)
  6. 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 (TYPE) parameter 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 32 767.
  7. Transaction (TRANSID)
  8. Enter the name of the transaction to be started when the number of records in the queue reaches the trigger level. This parameter is not valid if the Trigger level (TRGLVL) parameter 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 should be enclosed in apostrophes. Blanks are accepted but, when the entry is defined to the control region, anything after the blank is ignored. Characters may be entered in hexadecimal format, in the form X’A1A2A3A4’. Any value will be accepted but non-printable characters will be rejected when the entry is defined to the control region.
  9. CICS device indicator (DEVTYPE)
  10. 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 (TRGLVL) parameter contains 0.
    Possible values are:
    *TERMINAL: A terminal identifier will be associated with the transaction identifier.
    *FILE: No terminal identifier will be associated with the transaction identifier.
  11. CICS device (CICSDEV)
  12. Enter the identifier of the terminal to be used to run the ATI transaction. This parameter is valid only when the CICS device indicator (DEVTYPE) parameter 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 $,@, or #.
  13. File (FILE)
  14. 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 (TYPE) parameter contains *EXTERNAL.
    Possible library values are:
    *LIBL: The library list for the job that is associated with the control region is used to locate the file.
    *CURLIB: The current library for the job that is associated with the 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.
  15. Member (MBR)
  16. 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
  17. Type (TYPE)
  18. parameter contains *EXTERNAL.
    Possible values are:
    *FIRST: No member is specified. The first member is used.
    member-name:Specify the name of the member.
  19. File processing (OPENOPTION)
    • A read-forward only input file
    • A write-only output file
    • A read-backward only input file
  20. Indicates how the file is to be processed, namely:

    This parameter is valid only for extrapartition destinations, that is when the Type (TYPE) parameter 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 backward.

  21. Record format (RCDFMT)
  22. Indicates the record format of the file. This field is valid only for extrapartition destinations, that is when the Type (TYPE) parameter 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.
  23. Device (STGDEV)
  24. Indicates the storage medium of the file. This parameter is valid only for extrapartition destinations, that is when the Type (TYPE) parameter 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.
  25. Remote destination (RMTDEST)
  26. 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 (TYPE) parameter 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 $, @, or #.
  27. CICS system (SYSID)
  28. Enter the remote system identifier. The system must have an entry in the remote TCS. This field is required only for a remote destination, that is when the
  29. Type (TYPE)
  30. parameter contains *REMOTE. If this parameter contains the ID of the local system, the entry will be treated as if *NONE has been entered.
    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 $, @, or #.
  31. Maximum record length (LENGTH)
  32. 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 32 767.
  33. Indirect destination (PHYDEST)
  34. 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 (TYPE) parameter 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 $, @, or #.

Examples

ADDCICSDCT

LIB ( CICSWORK )

GROUP ( ACCT )

DEST ( SAMA)

TYPE ( *INTERNAL )

TRGLVL ( 55 )

RANSID ( ACCT04 )

This command adds a DCT entry called SAMA to group ACCT in OS/400 library CICSWORK, with an internal queue type. The transaction ACCT04 will run when the number of records on the queue (the trigger level) reaches 55.

ADDCICSDCT

LIB ( CICSWORK )

GROUP ( ACCT )

DEST ( BETA )

TYPE ( *EXTERNAL)

FILE ( AACXTRA )

This command adds a DCT entry called BETA to group ACCT in OS/400 library CICSWORK, with an external queue type. The queue maps to physical file AACXTRA.

ADDCICSDCT

LIB ( CICSWORK )

GROUP ( ACCT )

DEST ( RMT1 )

TYPE ( *REMOTE )

SYSID ( SYS1 )

LENGTH ( 512 )

This command adds a DCT entry called RMT1 to group ACCT in OS/400 library CICSWORK, with a remote queue type. The remote system identifier is SYS1 and the remote record length is 512 bytes.

ADDCICSDCT

LIB ( CICSWORK )

GROUP ( ACCT )

DEST ( IND1 )

TYPE ( *INDIRECT )

PHYDEST ( RMT1 )

This command adds a DCT entry called IND1 to group ACCT in OS/400 library CICSWORK, with an indirect queue type. The indirect destination identifier is RMT1, which has already been defined in the DCT.

Using the CHGCICSDCT command
Flowchart

Using the CHGCICSDCT command Flowchart

Using the CHGCICSDCT command Flowchart

Using the CHGCICSDCT command Flowchart
Notes:

  1. The DESTSTS parameter is not valid when TYPE(*INDIRECT) is specified.
  2. The RECOVER parameter and TRGLVL parameter are valid only when TYPE(*INTERNAL) is specified.
  3. The TRANSID parameter and DEVTYPE parameter are not valid when TRGLVL(0) is specified.
  4. The CICSDEV parameter is valid only when DEVTYPE(*TERMINAL) is specified.
  5. The FILE parameter, MBR parameter, OPENOPTION parameter, RCDFMT parameter, and STGDEV parameter are valid only when TYPE(*EXTERNAL) is specified.
  6. The FILE parameter is required when TYPE(*EXTERNAL) is specified.
  7. The RMTDEST parameter, SYSID parameter, and LENGTH parameter are valid only when TYPE(*REMOTE) is specified.
  8. The SYSID parameter is required when TYPE(*REMOTE) is specified.
  9. The PHYDEST parameter is valid, and required, only when TYPE(*INDIRECT) is specified.
  10. All parameters preceding this point can be specified positionally.

Function
Use the Change CICS/400 Destination Control Table (CHGCICSDCT) command to change a DCT entry.

Required parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 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.
  3. Group (GROUP)
  4. Enter the name of the group containing 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 $, @, or #.
  5. Destination (DEST)
  6. 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. If you are defining the CSMT log, this parameter must be CSMT.
    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 $, @, or #.

Optional parameters

  1. Type (TYPE)
  2. 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 within the CICS/400 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 outside, but allocated to, the CICS/400 control region.
    *REMOTE: Indicates a remote destination; that is a destination on another system or region. This type is not valid if you are defining the CSMT log.
  3. Status (DESTSTS)
  4. Indicates whether or not the destination identifier can be used. This field is not valid for indirect destinations, that is when the Type (TYPE) parameter contains *INDIRECT.
    Possible values are:
    *SAME: Keep the value currently specified in the DCT entry.
    *ENABLED: This destination identifier can be used. If the Type (TYPE) parameter contains *EXTERNAL, then this transient data queue will be opened when the runtime system is installed.
    *DISABLED: This destination identifier cannot be used. If the Type (TYPE) parameter contains *EXTERNAL, then this transient data queue will not be opened when the runtime system is installed.
  5. Recoverable (RECOVER)
  6. 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 (TYPE) parameter contains *INTERNAL.
    Note: If this DCT entry is defining the CSMT log, this field value 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.
  7. ATI trigger level (TRGLVL)
  8. 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 (TYPE) parameter 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 32 767.
  9. Transaction (TRANSID)
  10. Enter the name of the transaction to be started when the number of records reaches the trigger level. This parameter is not valid if the Trigger level (TRGLVL) parameter 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 should be enclosed in apostrophes. Blanks are accepted but, when the entry is defined to the control region, anything after the blank is ignored. Characters may be entered in hexadecimal format, in the form X’A1A2A3A4’. Any value will be accepted but non-printable characters will be rejected when the entry is defined to the control region.
  11. CICS device indicator (DEVTYPE)
  12. Indicates whether or not a terminal identifier is to be associated with the ATI transaction identifier. This parameter is not valid when the Trigger level (TRGLVL) parameter 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.
  13. CICS device (CICSDEV)
  14. Enter the identifier of the terminal to be used to run the ATI transaction. This parameter is valid only when the CICS device indicator (DEVTYPE) parameter 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 $, @, or #.
  15. File (FILE)
  16. 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 (TYPE) parameter 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 with the control region is used to locate the file.
    *CURLIB: The current library for the job that is associated with the 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.
  17. Member (MBR)
  18. 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 (TYPE) parameter 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.
  19. File processing (OPENOPTION)
    • A read-forward only input file
    • A write-only output file
    • A read-backward only input file
  20. Indicates how the file is to be processed, namely:

    This parameter is valid only for extrapartition destinations, that is when the Type (TYPE) parameter 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.

  21. Record format (RCDFMT)
  22. Indicates the record format of the file. This field is valid only for extrapartition destinations, that is when the Type (TYPE) parameter 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.
  23. Device (STGDEV)
  24. Indicates the storage medium of the file. This field is valid only for extrapartition destinations, that is when the Type (TYPE) parameter 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.
  25. Remote destination (RMTDEST)
  26. 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 (TYPE) parameter 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 $, @, or #.
  27. CICS system (SYSID)
  28. Enter the remote system identifier. The system must have an entry in the remote TCS. This field is required only for remote destinations, that is when the Type (TYPE) parameter contains *REMOTE. If this parameter contains the ID of the local system, the entry will be treated as if *NONE has been entered.
    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 $, @, or #.
  29. Maximum record length (LENGTH)
  30. 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 32 767.
  31. Indirect destination (PHYDEST)
  32. 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 (TYPE) parameter 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 $, @, or #.

Examples

CHGCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

DEST(SAMA)

TRGLVL(10)

This command changes the internal DCT entry called SAMA in group ACCT in OS/400 library CICSWORK. The transaction ACCT04 will now run when the number of records on the queue (the trigger level) reaches 10.

CHGCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

DEST(BETA)

DESTSTS(*DISABLED)

This command changes the external DCT entry called BETA to group ACCT in OS/400 library CICSWORK. The queue has been disabled and is not available for use.

CHGCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

DEST(RMT1)

RMTDEST(PRL1)

This command changes the remote DCT entry called RMT1 in group ACCT in OS/400 library CICSWORK. The remote destination identifier has been added to the definition.

ADDCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

DEST(IND1)

PHYDEST(SAMA)

This command changes the indirect DCT entry called IND1 in group ACCT in OS/400 library CICSWORK. The indirect destination identifier is now SAMA, which has already been defined in the DCT as an internal destination.

Using the DSPCICSDCT command
Flowchart

Using the DSPCICSDCT command Flowchart
Notes:

  1. All parameters preceding this point can be specified positionally.

Function
Use the Display CICS/400 Destination Control Table (DSPCICSDCT) command to display a DCT entry. You can only view this entry; you can neither make changes to it nor delete it.

Optional parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 group.
    Possible values are:
    *LIBL: The library list is used to locate the first OS/400 library that contains the CICS/400 group.
    *CURLIB: The current library contains the CICS/400 group. If no library is specified as the current library, the QGPL library is used.
    library-name:Specify the name of the OS/400 library that contains the group.
  3. Group(GROUP)
  4. Enter the name of the group containing the DCT entry to be displayed.
    Possible values are:
    *FIRST: No CICS/400 group is specified. The first CICS/400 group found is used.
    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 $, @, or #.
  5. Destination (DEST)
  6. Enter the destination identifier of the DCT entry to be displayed.
    Possible values are:
    *FIRST: Display the first DCT entry.
    *ALL: Display all the DCT entries.
    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 $, @, or #.
    generic*-dest:Specify the generic name of the destination identifier. A generic name is a string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all DCT entries with an identifier that begins with the generic name are displayed. If an asterisk is not included with the generic name, the system assumes the value to be the complete destination identifier.
  7. Location of output (OUTPUT)
  8. Enter the location of the output from this command.
    Possible values are:
    *: The output is either displayed (if requested by an interactive job) or printed with the job spool output (if requested by a batch job).
    *PRINT: The output is printed with the job spool output.

Examples

DSPCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

DEST(*ALL)
This command displays all DCT entries located in group ACCT in OS/400 library CICSWORK.

Using the RMVCICSDCT command
Flowchart

Using the RMVCICSDCT command Flowchart
Notes:

  1. All parameters preceding this point can be specified positionally.

Function
Use the Remove CICS/400 Destination Control Table (RMVCICSDCT) command to delete an entry from the DCT.

Required parameters

  1. Library (LIB)
  2. Enter the name of the OS/400 library that contains the CICS/400 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.
  3. Group (GROUP)
  4. Enter the name of the group containing the DCT entry to be removed.
    Possible values are:
    *FIRST: No CICS/400 group is specified. The first CICS/400 group found is used.
    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 $, @, or #.
  5. Destination (DEST)
  6. Enter the name of the DCT entry to be removed.
    Possible values are:
    *FIRST: Remove the first DCT entry.
    *ALL: Remove all the DCT entries.
    destination:The maximum length is four characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or $, @, or #. generic*-dest: Specify the generic name of the destination identifier. A generic name is a string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all DCT entries with identifiers that begin with the generic name are removed. If an asterisk is not included with the generic name, the system assumes the value to be the complete destination identifier.

Examples
RMVCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

DEST(ABC*)
This command removes all DCT entries that start with ABC and end with anything, located in group ACCT in OS/400 library CICSWORK.

Using the WRKCICSDCT command
Flowchart

Using the WRKCICSDCT command
Notes:

  1. All parameters preceding this point can be specified positionally.

Function
Use the Work with CICS/400 Destination Control Table (WRKCICSDCT) command to list entries in the DCT. You can change, remove, copy, or display entries, or add new entries to the list.

Optional parameters

  1. Library (LIB)
  2. 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 CICS/400 group.
    *CURLIB: The current library contains the CICS/400 group. If no library is specified as the current library, the QGPL library is used.
    library-name:Specify the name of the OS/400 library that contains the group.

    Notes:
    1 All parameters preceding this point can be specified positionally.

  3. Group (GROUP)
  4. Enter the name of the group containing the DCT entries to be listed.
    Possible values are:
    *FIRST: No group is specified. The first group found is used.
    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 $, @, or #.
  5. Destination (DEST)
  6. Enter the name of the DCT entries to be listed. This name is also the destination identifier that will be used in EXEC CICS transient data queue commands.
    Possible values are:
    *ALL: List all DCT entries.
    *FIRST: List the first DCT entry.
    destination:The destination 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 $, @, or #.
    generic*-dest:Specify the generic name of the destination identifier. A generic name is a string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, then all DCT entries that begin with the generic name are listed. If an asterisk is not included with the generic name, the system assumes the value to be the complete destination identifier.

Examples
WRKCICSDCT

LIB(CICSWORK)

GROUP(ACCT)

This command lists all DCT entries located in group ACCT in OS/400 library CICSWORK.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM - AS/400 Topics