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:
| 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
| 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
| Field | Attribute name | Description |
|---|---|---|
| Destination type | ATIFACILITY | The type of destination the queue represents:
|
| 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:
|
| 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.
|
| 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):
|
| 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:
|
| Facility identifier | FACILITYID | A 4-character field that contains either:
|
| 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:
|
| Printer control | PRINTCONTROL | (Extrapartition queues only.) The control characters to be used:
|
| Printer number | PRINTERNUM | This attribute is obsolete. |
| Record format | RECORDFORMAT | Indicates whether the queue has fixed- or 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):
|
| 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:
|
| 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.
|
| Write a file tapemark | TAPEMARK | This attribute is obsolete. |
| Transient data queue (TDQ) type | TDQTYPE | The type of queue:
|
| 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:
|
| 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):
|
| 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:
|