1. Application Runtime for CICS Reference Guide
  2. CICS Runtime Configuration Files
  3. TD Queue Extra Partition Configuration File

3.9 TD Queue Extra Partition Configuration File

The following table lists and defines extra partitions TD queues available to the CICS application.

The filename is tdqextra.desc.

Table 3-7 TD Queue Parameters

Field Name Type Values Description
TDQUEUE X(4) Mandatory Specifies the 1- to 4-character name of a transient data queue.
GROUP X(10) Mandatory The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION X(60) Optional A small textual zone for description of the resource.
DDNAME X(8) Mandatory Specifies a 1-to 8-character value that may refer to a data set defined in the startup JCL.
DISPOSITION X(3) Optional Specifies the disposition of the data set.
  • MOD: ART-CICS first assumes that the data set exists. For an existing sequential data set, MOD causes the read/write mechanism to be positioned after the last record in the data set. The read/write mechanism is positioned after the last record each time the data set is opened for output. If ART-CICS cannot find volume information for the data set:
    • On the DD statement.

    A data set allocated dynamically in this way is deleted when the queue is closed, and all records are lost. For a new data set, MOD causes the read/write mechanism to be positioned at the beginning of the data set.

  • OLD: The data set existed before this job step.
  • SHR: The data set existed before this job step and can be read by other concurrent jobs.
ERRORPTION X(1) I | S UNSUPPORTED

Specifies the action to be taken if an I/O error occurs. This can be one of the following:

  • I = IGNORE: The block that caused the error is accepted.
  • S = SKIP: The block that caused the error is skipped.
OPENTIME X(1) D | I UNSUPPORTED

Specifies the initial status of the data set. The initial status can be one of the following:

  • D = DEFERRED: The data set remains closed until you indicate that you want to open it by using the CEMT INQUIRE|SET TDQUEUE command.
  • I = INITIAL: The data set is to be opened at install time. However, if the DSNAME attribute is not specified, and the data set name is not specified in the DD statement in the startup JCL, the transient data queue is allocated to JES during CICS startup.
RECORDFORMAT X(1) F | V Specifies the record format of the data set.
  • F= FIXED: Fixed records. If you specify RECORDFORMAT FIXED, you must also specify a block format.
  • V= VARIABLE: Variable records. If you specify RECORDFORMAT VARIABLE you must also specify a block format.
PRINTCONTROL X(1) A | UNSUPPORTED

Specifies the control characters to be used. There is no default. If you allow RECORDFORMAT to default to blank, you cannot specify anything in the PRINTCONTROL field. The control characters that can be used are:

  • A= ASA: ASA control characters.
  • blank: No control characters are to be used.
RECORDSIZE 9(4) COMP Optional Specifies the record length in bytes, in the range 0 through 32767.
TYPEFILE X(6) Optional Specifies the type of data set the queue is to be associated with:
  • INPUT: An input data set.
  • OUTPUT: An output data set
DSNAME X(80) Optional Specifies the name of the file that is to be used to store records written to this extra partition queue.

This file must exist even if empty.
SYSOUTCLASS X(1) Optional UNSUPPORTED

Instead of allocating an extra partition queue to a physical data set, you can allocate it to a system output data set (referred to as SYSOUT). Use the SYSOUT CLASS attribute to specify the class of the SYSOUT data set.

A..Z|0..9 A single alphabetic or numeric character that represents an output class that has been set up on the z/OS system on which the CICS Runtime job is to run.
TRT X(1) S | I New optional CICS Runtime argument, allowing integrators and customers to make their own specific implementation of extra partition queues.

No value or S (for Standard) will invoke normal CICS Runtime TDQueue functionalities

Setting the value I, will trigger the call to a function td_extra_actions_int, which must be provided by the integrator.

INTRDR X(1) Y | N Specifies whether to define the TDQ as internal reader for JCL.
  • Y: The extra TDQ is internal reader for JCL.
  • N or Not specified: Normal TDQ.
BLOCKFORMAT X(1) B | U Specifies the BLOCK format:
  • B: Block format
  • U: Unblocked format

Parent topic: CICS Runtime Configuration Files