Transient data queue definitions - TDQDEF

The Transient data queue definition (TDQDEF) views display information about intrapartition, extrapartition, indirect and remote transient data destination definitions.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > Transient data queue definitions

Table 1. Views in the supplied Transient data queue definitions (TDQDEF) view set
View Notes
Transient data queue definitions

EYUSTARTTDQDEF.ADDTOGRP

Add one or more transient data queue definitions to a resource group.
Transient data queue definitions

EYUSTARTTDQDEF.CREATE

Create a transient data queue definition and add it to the data repository.
Transient data queue definitions

EYUSTARTTDQDEF.DETAILED

Detailed information about a selected transient data queue definition.
Transient data queue definitions

EYUSTARTTDQDEF.INSTALL

Install a transient data queue definition in an active system.
Transient data queue definitions

EYUSTARTTDQDEF.REMOVE

Remove a transient data queue definition from the data repository.
Transient data queue definitions

EYUSTARTTDQDEF.TABULAR

Tabular information about all transient data queue definitions for the current context.

Actions

Table 2. Actions available for TDQDEF views
Action Description
ADDTOGRP Add one or more transient data queue definitions to a resource group.
CREATE Create a transient data queue definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a transient data queue definition in an active system.
REMOVE Remove a transient data queue definition from the data repository.
UPDATE Update a transient data queue definition in the data repository.

Fields

Table 3. Fields in TDQDEF views
Field Attribute name Description
Destination type ATIFACILITY The type of destination the queue represents:
  • 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.
  • 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.
Block option BLOCKFORMAT (Extrapartition queues only) 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. Options are:
  • BLOCKED - Blocked record format.
  • UNBLOCKED - Unblocked record format.
  • NOTAPPLIC - No block format is defined for this data set.
Block size BLOCKSIZE (Extrapartition queues only.) 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.
Number of buffers BUFNO The number of buffers to be provided. Any number up to 255 may be used.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification.
Time created CREATETIME The local date and time when the definition was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Number of buffers DATABUFFERS 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.
DD name DDNAME A 1 to 8 character value that refers to the data definition (DD) statement associated with the extrapartition TD queue. If a DD statement of this name is not coded in the JCL of the CICS region, then this name will be used to dynamically allocate the data set or sysout file.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the transient data queue definition.
Device file name DEVFILENAME This attribute is obsolete.
Open at initalization DEVICEINIT This attribute is obsolete.
Type of device DEVICETYPE This attribute is obsolete.
Disposition DISPOSITION The disposition of the data set (extrapartition queues only):
  • 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
DS name DSNAME A 1 to 44 character value that identifies the data set (DS) name to be dynamically allocated to the extrapartition TD queue. This value will be ignored if the DD name value specified is coded as a DD statement in the JCL of the CICS region.
Error option ERROROPTION The action to be taken if an I/O error occurs (extrapartition queues only). 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.
Facility identifier FACILITYID A 4-character field that contains either:
  • The system identifier for an intrapartition queue that specifies ATIFACILITY as SYSTEM.
  • The terminal identifier where ATIFACILITY is TERMINAL.
If you do not specify anything in the FACILITYID field, it defaults to the name of the queue in each case. This field must be left blank if FILE is specified for the ATIFACILITY attribute.
Write a standard label FILELABEL This attribute is obsolete.
Indirect transient data queue (TDQ) name INDIRECTNAME The name of a transient data queue. The queue can be intrapartition, extrapartition, remote, or indirect.
Name NAME The name of the transient data queue definition.
Data set open time OPENTIME (Extrapartition queues only.) The initial status of the data set. Options are:
  • 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.
Printer control PRINTCONTROL (Extrapartition queues only.) The control characters to be used:
  • ASA - ASA control characters.
  • MACHINE - Machine control characters.
  • N/A - The Printcontrol value does not apply to this definition and should not be validated.
Printer number PRINTERNUM This attribute is obsolete.
Record format RECORDFORMAT Indicates whether the queue has fixed- or variable-length records:
  • FIXED - The queue has fixed-length records.
  • UNDEFINED - The queue is not open or is not extrapartition.
  • VARIABLE - The queue has variable-length records.
Record size RECORDSIZE The record length (in bytes) for queues having fixed-length records, or the maximum record length for queues having variable-length records. This field applies only to extrapartition queues; for others, -1 is returned.
Recovery option RECOVSTATUS The type of recovery defined for the queue (intrapartition queues only):
  • LOGICAL - The queue is logically recoverable. If a transaction that accessed this queue was in-flight at the time of abnormal termination, or in the subsequent emergency restart or dynamic transaction backout, the queue is restored to the status it was in before the in-flight UOW modified it.
  • NOTAPPLIC - The queue is not intrapartition.
  • NO - The queue is not recoverable.
  • PHYSICAL - The queue is physically recoverable. If emergency restart occurs, this queue is to be recovered to its status at the time CICS terminated.
Remote length REMOTELENGTH (Optional.) 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 transient data queue (TDQ) name REMOTENAME the 4-character name of this queue in the remote CICS region in which the queue is defined (from the RMTNAME option in its definition). REMOTENAME applies only to queues defined as remote; for other queues the value returned is blanks.
System identifier of remote destination REMOTESYSTEM (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, it 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.
Queue is resident or non-resident RESIDENT Identifies whethe or not the queue is resident.
Reuse control intervals REUSE This attribute is obsolete.
Tape disposition REWIND The disposition of a tape data set (extrapartition queues only). 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.
  • NOTAPPLIC - This is not applicable for this resource.
Resource security value RSL This attribute is obsolete.
System output (SYSOUT) class SYSOUTCLASS 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 z/OS 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.
Write a file tapemark TAPEMARK This attribute is obsolete.
Transient data queue (TDQ) type TDQTYPE The type of 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.
Terminal name TERMID The ID of the terminal.
Transaction started at trigger level TRANSID The name of the transaction that is to be automatically initiated when the trigger level is reached. Transactions are initiated in this way to read records from the queue. If the TRANSID attribute is not specified (or if 0 is specified for the TRIGGERLEVEL attribute), you must use another method to schedule transactions to read records from transient data queues.
Trigger level TRIGGERLEVEL The number of records to be accumulated before a task is automatically initiated to process them. 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.
Data set type TYPEFILE 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.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User ID on the triggered transaction USERID The user ID you want CICS to use for security checking when verifying the trigger-level transaction specified in the TRANSID field (intrapartition queues only).
Wait for UOW resynchronization WAIT 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 (intrapartition queues only):
  • 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.
In-doubt UOW wait action WAITACTION The action CICS is to take for an in-doubt unit of work (UOW) if the definition for this queue specifies WAIT(YES) (intrapartition queues only). 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 - This field does not apply to this definition and should not be validated.


eyua7cr9.html | Timestamp icon Last updated: Sunday, 4 June 2017