Transient data queue definition attributes

The transient data queue definition attribute descriptions are:

Atifacility (intrapartition queues only)
specifies the type of destination the queue represents.
FILE
The transient data queue is to be used as a file of data records that are not associated with a particular terminal or system. ATI does not require a terminal to be available.
SYSTEM
The transient data queue is to be associated with the specified system identifier. The system must be defined to the local CICS® system using an RDO CONNECTION definition.

Specifying Atifacility=System initiates a distributed transaction processing (DTP) session. For more information about DTP considerations in application programming, see the CICS Application Programming Guide.

TERMINAL
The transient data queue is to be associated with the terminal. The terminal must be defined to CICS. If you do not specify TERMINAL, it defaults to the value of FACILITYID. If ATI is used, as specified in the TRANSID and TRIGGERLEVEL attributes, the transaction that is initiated is associated with the specified terminal, which must be available before the transaction can be initiated.
Blockformat (extrapartition queues only)
specifies the block format of the data set. There is no default. If you specify the record format (RECORDFORMAT attribute) as undefined (or allow it to default), you cannot specify anything for the BLOCKFORMAT attribute.
BLOCKED
Blocked record format.
UNBLOCKED
Unblocked record format.
NOTAPPLIC
No block format is defined for this datat set.
blank
The block format will be derived from the associated data set.
Blocksize (extrapartition queues only)
specifies the length of the block, in bytes. The block length should be in the range 0 through 32767. If you leave this field blank, CICSPlex® SM uses the default value for your CICS environment, if there is one.
Databuffers (extrapartition queues only)
specifies the number of buffers to be provided, up to a maximum of 255. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
Dname
specifies a 1-to 8-character value that may refer to a data set defined in the startup JCL.
Description
(Optional.) Specifies a 1- to 30-character description of the resource.
Disposition (extrapartition queues only)
specifies the disposition of the data set.
MOD
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.
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.
(extrapartition queues only)
specifies the name of the QSAM data set that is to be used to store records written to this extrapartition queue.
Erroroption (extrapartition queues only)
specifies the action to be taken if an I/O error occurs. This can be one of the following:
IGNORE
The block that caused the error is accepted.
SKIP
The block that caused the error is skipped.
Facilityid (intrapartition queues only)
specifies a 4-character field that contains either:

If you do not specify anything in the FACILITYID field, it defaults to the name of the queue in each case.

If ATIFACILITY(FILE) is specified, the FACILITYID field must be left blank.

Indirectname (indirect queues only)
specifies the name of a transient data queue. The queue can be intrapartition, extrapartition, remote, or indirect.
Opentime (extrapartition queues only)
specifies the initial status of the data set. The initial status can be one of the following:
DEFERRED
The data set remains closed until you indicate that you want to open it by using the CEMT INQUIRE|SET TDQUEUE command.
INITIAL
The data set is to be opened at install time.
Printcontrol (extrapartition queues only)
specifies the control characters to be used. There is no default.

ASA
ASA control characters.
MACHINE
Machine control characters.
N/A
The Printcontrol value does not apply to this definition and should not be validated.
blank
The control characters will be derived from the associated data set.
Recordformat (extrapartition queues only)
specifies the record format of the data set.
FIXED
Fixed records. If you specify RECORDFormat(Fixed), you must also specify a block format.
VARIABLE
Variable records. If you specify RECORDFormat(Variable), you must also specify a block format.
UNDEFINED
Record format not defined.
blank
The record format will be derived from the associated data set.
Recordsize (extrapartition and remote queues)
specifies the record length in bytes, in the range 0 through 32767. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
Recovstatus (intrapartition queues only)
specifies the recoverability attributes of the queue in the event of an abnormal termination of either CICS or the transaction that is processing the queue. The recoverability attributes are:
LOGICAL
This queue is logically recoverable.
NO
This queue is not recoverable.
PHYSICAL
This queue is physically recoverable.
Remotename (remote queues only)
(Optional.) specifies, if the transient data queue resides on a remote system, the 4-character name by which the queue is known in the system or region on which the queue resides.
Remotelength (remote queues only)
(Optional.) specifies the length in bytes, in the range 1 through 32767. The default value is 1. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
Remote Sysid

(Optional.) specifies, if the transient data queue resides on a remote system, the name of the connection that links the target (local) system to the related (remote) system where the transient data queue resides. If this attribute is not supplied, RemoteSystem is derived directly from the CICS system id of the related system, and the connection that links the target system to the related system must have the same name as the CICS system id of the related system.

RESGROUP
(Optional.) Specify the name of an existing resource group to which the definition is to be automatically added.
Rewind (extrapartition queues only)
specifies the disposition of a tape data set. The disposition can be one of the following:
LEAVE
The current tape is positioned at the logical end of the data set.
REREAD
The current tape is positioned at the logical start of the data set.
Sysoutclass (extrapartition queues only)
Instead of allocating an extrapartition queue to a physical data set, you can allocate it to a system output data set (referred to as SYSOUT).

Use the SYSOUTCLASS 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 MVS™ system on which the CICS job is to run.
*
This is the default class. SYSOUTCLASS defaults to an asterisk (*) if you leave the DSNAME attribute blank and specify OUTPUT for the Typefile field.
blank
SYSOUTCLASS defaults to a blank character if you leave the DSNAME attribute blank and specify INPUT or RDBACK for the Typefile attribute.
Transid (intrapartition queues only)
specifies the name of the transaction that is to be automatically initiated when the trigger level is reached.
Triggerlevel (intrapartition queues only)
specifies the number of records to be accumulated before a task is automatically initiated to process them. (This number is known as the trigger level.)

If you specify the TRANSID attribute, TRIGGERLEVEL defaults to 1. Specify a trigger level of 0 if you want to disable ATI processing. If you do not specify a transaction id, the trigger level is ignored. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.

Type
specifies the following types of transient data queue:
EXTRA
A queue that is outside the CICS region is allocated to CICS.
INDIRECT
An indirect queue is a queue that does not point to an actual data set, but to another queue. An indirect queue can be extrapartition, intrapartition, remote, or even another indirect queue.
INTRA
A queue for data that is to be stored temporarily.
REMOTE
A queue that is located on a remote system.
Typefile
specifies the type of data set the queue is to be associated with.
INPUT
An input data set.
OUTPUT
An output data set.
RDBACK
An input data set that is to be read backward.
Note:
This is appropriate only for data sets that have been defined on magnetic tape.
Userid (intrapartition queues only)
specifies the userid you want CICS to use for security checking when verifying the trigger-level transaction specified in the TRANSID field.
Wait (intrapartition queues only)
specifies whether an in-doubt unit of work (UOW) that has modified a logically recoverable queue should wait for resynchronization with its coordinator to determine whether to commit or back out the changes.
NO
The UOW is not to wait. Any changes made to recoverable resources are to be backed out or committed, as specified by the ACTION attribute on the TRANSACTION resource definition.
YES
The UOW is to wait, and any action required while waiting is determined by the WAITACTION attribute.
N/A
The Wait field does not apply to this definition.
Waitaction (intrapartition queues only)
specifies the action CICS is to take for an in-doubt unit of work (UOW) if the definition for this queue specifies WAIT(YES). The possible actions are:
QUEUE
The UOW is in-doubt and waiting; any locks held by the UOW for this queue remain active until the final state of the UOW is known. This means that tasks are suspended rather than receiving the LOCKED response. When the final state of the UOW is known, any changes that it has made are committed or backed out. Until then, any further requests of the following types that need one of the active locks must wait:
  • READQ, if the in-doubt UOW had issued READQ or DELETEQ requests.
  • WRITEQ, if the in-doubt UOW had issued WRITEQ or DELETEQ requests.
  • DELETEQ, if the in-doubt UOW had issued READQ, WRITEQ or DELETEQ requests.
REJECT
The UOW is in-doubt and is waiting. Any lock held by the UOW for this queue is retained until the final state of the UOW is known. When the final state is known, any changes the UOW has made are committed or backed out. Until then, any further request that needs one of the retained locks is rejected, and a LOCKED response is returned. WAITACTION=REJECT causes LOCKED to be raised in exactly the same circumstances as those in which QUEUE causes a transaction to wait.
N/A
The Waitaction field does not apply to this definition and should not be validated.

Related concepts
Transient data queue resource definitions
CICS Resource Definition Guide
Related tasks
Accessing BAS transient data queue definitions
Working with the TDQDEF view
Defining transient data queues using BAS
Installing BAS transient data queue definitions
[[ Contents Previous Page | Next Page Index ]]