Extrapartition - EXTRATDQ

The Extrapartition transient data queues (EXTRATDQ) views display information about currently installed extrapartition transient data queues.

Supplied views

To access from the main menu, click:

CICS operations views > Transient data queue (TDQ) operations views > Extrapartition

Table 1. Views in the supplied **Extrapartition transient data queues** (EXTRATDQ) view set
View	Notes
Extrapartition transient data queues EYUSTARTEXTRATDQ.CLOSE	Close a queue.
Extrapartition transient data queues EYUSTARTEXTRATDQ.DETAIL1	Detailed information about the resource signature.
Extrapartition transient data queues EYUSTARTEXTRATDQ.DETAILED	Detailed information about a selected extrapartition transient data queue
Extrapartition transient data queues EYUSTARTEXTRATDQ.DISABLE	Disable a queue. Note: Transient data queues that have names beginning with C are supplied by CICS and cannot be disabled. A disabled queue cannot be accessed by applications, though it can still be open.
Extrapartition transient data queues EYUSTARTEXTRATDQ.DISCARD	Discard a queue. Note: Transient data queues that have names beginning with C are supplied by CICS and cannot be discarded. The transient data queue must be disabled and closed before it can be discarded.
Extrapartition transient data queues EYUSTARTEXTRATDQ.ENABLE	Enable a queue.
Extrapartition transient data queues EYUSTARTEXTRATDQ.OPEN	Open a queue.
Extrapartition transient data queues EYUSTARTEXTRATDQ.SET	Set attributes according to the new values specified in input fields.
Extrapartition transient data queues EYUSTARTEXTRATDQ.TABULAR	Tabular information about extrapartition transient data queues

Actions

Table 2. Actions available for EXTRATDQ views
Action	Description
CLOSE	Close a queue.
DISABLE	Disable a queue. Note: Transient data queues that have names beginning with C are supplied by CICS and cannot be disabled. A disabled queue cannot be accessed by applications, though it can still be open.
DISCARD	Discard a queue. Note: Transient data queues that have names beginning with C are supplied by CICS and cannot be discarded. The transient data queue must be disabled and closed before it can be discarded.
ENABLE	Enable a queue.
OPEN	Open a queue.
SET	Set attributes according to the new values specified in input fields.

Fields

Table 3. Fields in EXTRATDQ views
Field	Attribute name	Description
BAS resource definition version	BASDEFINEVER	The BAS version number of this definition.
Block format	BLOCKFORMAT	Indicates whether the queue is blocked or unblocked. A value of NOTAPPLIC is returned if the queue is not open.
Block length (bytes)	BLOCKSIZE	Indicates the length of the block in bytes.
Last modification agent	CHANGEAGENT	The change agent identifier that made the last modification. CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command. CSDBATCH - The resource was last changed by a DFHCSDUP job. DREPAPI - The resource was last changed by a CICSPlex SM BAS API command. DREPBATCH - The resource was last changed by a CICSPlex SM utility. SYSTEM - The resource was last changed by the CICS or CICSPlex SM system. CREATESPI - The resource was last changed by an EXEC CICS CREATE command. NOTAPPLIC - This is not applicable for this resource.
Last modification agent release	CHANGEAGREL	The CICS release level of the agent that made the last modification to the resource definition.
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 to the resource definition.
Number of data buffers to be used	DATABUFFERS	Indicates the number of buffers to be used by the transient data queue.
DD name on JCL statement defining data set	DDNAME	The identifier that may refer to a data set name used in the start up JCL.
Source of the resource definition	DEFINESOURCE	The source of the definition, depending on which agent made the last change.
Creation time	DEFINETIME	The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Data set disposition	DISPOSITION	Indicates the disposition of the data set as MOD, OLD or SHARE. NOTAPPLIC is returned if the queue is not open.
Name of data set	DSNAME	Specifies the name of the associated QSAM data set or DUMMY data set.
Empty status	EMPTYSTATUS	Indicates the state of the queue: FULL - The queue is full. EMPTY - The queue is empty. NOTEMPTY - No operation against the queue has indicated that it is either empty or full. NOTAPPLIC - The queue is not open.
Enabled status	ENABLESTATUS	Indicates whether the queue can be accessed by applications. Input Values: ENABLED, DISABLED
CICS action for I/O error	ERROROPTION	Indicates the action CICS should take if an I/O error is encountered. Valid values: IGNORERR - The block that caused the error is accepted. SKIP - The block that caused the error is skipped. NOTAPPLIC - The action is not applicable to this queue.
Installation agent	INSTALLAGENT	The install agent identifier that made the installation. CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command. CREATESPI - The resource was installed by an EXEC CICS CREATE command. GRPLIST - The resource was installed by GRPLIST INSTALL. SYSTEM - The resource was last installed by the CICS or CICSPlex SM system.
Installation time	INSTALLTIME	The local date and time when the definition was installed.
Installation user ID	INSTALLUSRID	The user ID that installed the resource definition.
I/O type	IOTYPE	Indicates whether the queue was defined for INPUT, OUTPUT, or RDBACK, which means the queue can be read backwards.
Member name	MEMBER	This indicates the member name of a partitioned data set. However if the QSAM data set is not a partitioned data set then this field will be blank..
Open status	OPENSTATUS	Indicates whether the queue is open, closed, or in an intermediate state: OPENING - The queue is in the process of being opened. OPEN - The queue is open. CLOSING - The queue is in the process of being closed. CLOSED - The queue is closed. SWITCHING - The queue is unavailable, undergoing volume (extent) switching. Input Values: OPEN, CLOSED
Number of READ and WRITE requests	OUTCNT	The number of WRITEs to the output data set or READs from the input data set.
Print control type	PRINTCONTROL	Indicates what type of print control applies to the records on this queue: ASACTL or ASA - ASA control character MCHCTL or MCH - Machine control character NOCTL or NOC - No print control NOTAPPLIC or NOT - The queue is not open.
Record format	RECORDFORMAT	Indicates whether the queue has fixed-length (FIXED) or variable-length (VARIABLE) records. A value of NOTAPPLIC is returned if the queue is not open.
Record length (bytes)	RECORDLENGTH	For queues with variable-length records (VARIABLE), the maximum record length in bytes. For queues with fixed-length records (FIXED), the actual record length in bytes. A value of N/A means the record length could not be determined because the queue is closed.
Rewind action when data set on tape closed	REWIND	Indicates that the current tape is positioned to the logical end of the data set (LEAVE) or positioned to reprocess the data set (REREAD). NOTAPPLIC will be used if REWIND is not applicable for this resource.
SYSOUT class if spool file	SYSOUTCLASS	Indicates the class attribute of the associated SYSOUT data set.
Queue ID	TDQUEUE	The name of the transient data queue.