Display Data Queue (DSPDTAQXCL)
The Display Data Queue (DSPDTAQXCL) command displays data queue entries, entry key values if the data queue is created as keyed, information related to the sending of the entry, and attributes of the data queue.
Restrictions:
- You must have *EXECUTE authority to the library where the data queue is located.
- You must have *OBJOPR and *READ authority to the data queue.
| Keyword | Description | Choices | Notes |
| DTAQ |
Data queue |
Qualified object name |
Required, Positional 1 |
| Qualifier 1: Data queue |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| TYPE |
Initial type of information |
*HEADER, *ENTRIES, *KEYS, *SENDINFO |
Optional, Positional 2 |
Data queue (DTAQ)
Specifies the qualified name of the data queue to be displayed.
This is a required parameter.
Qualifier 1: Data queue
- *LIBL
- The library list for the job is used.
- *CURLIB
- The current library for the job is used. If no current library entry exists in the library list, QGPL is used.
- name
- Specify the name of the library.
Initial type of information (TYPE)
Specifies the type of information that is to be initially displayed.
- *HEADER
- General attributes of the data queue are shown.
- *ENTRIES
- Specific entries on the data queue are to be displayed starting with the first entry. 'First' entry is determined based on the type of data queue. For *FIFO queues the oldest entry is the first entry. For *LIFO queues the most recent entry is the first entry. For *KEYED queues the first entry is determined by the entry with the lowest hex key value.
- *KEYS
- Specific key values on the data queue are displayed starting with the first entry. The first entry is determined by the entry with the lowest hex key value.
This special value is only valid for data queues created as *KEYED.
- *SENDINFO
- Information concerning the sending of specific entries on the data queue are to be displayed starting with the first entry. 'First' entry is determined based on the type of data queue. For *FIFO queues the oldest entry is the first entry. For *LIFO queues the most recent entry is the first entry. For *KEYED queues the first entry is determined by the entry with the lowest hex key value.
Examples for DSPDTAQXCL
Example 1: Simple Command Example
DspDtaQXCL DtaQ(MyQueue)
This command displays the general attributes of data queue MYQUEUE. The library list of the current job is used to locate the queue.
Example 2: Dirctly Displaying Data Queue Entries
DspDtaQXCL DtaQ(MyQueue) Type(*Entries)
This command displays the first 11 entries currently on the data queue MYQUEUE.
Error messages for DSPDTAQXCL
*ESCAPE Messages
- XCL501E
- Distributed data management (DDM) data queues not supported by DSPDTAQXCL.
- XCL501F
- Data queue &1 in library &2 is not keyed.
- XCL9002
- Function did not complete. See previously listed messages related to possible user errors.
- XCL9003
- Function did not complete. See previously listed messages for possible cause.
- XCL9004
- Function did not complete. See previously listed messages for possible cause.
- XCL9005
- Function did not complete. Contact your service provider.
|