Clear Data Queue (CLRDTAQXCL)
The Clear Data Queue (CLRDTAQXCL) command clears all entries from a data queue. If the data queue was created with AUTORCL(*YES) on the CRTDTAQ command then the storage allocated to the data queue will also be reduced to the storage necessary for the initial number of entries defined for the data queue.
This function is also available with command CLRDTAQ in library VC2XCL. Any use of this alternative command name should be library qualified in case the i operating system were to use this command name in a future release.
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 |
Data queue (DTAQ)
Specifies the qualified name of the data queue to be cleared.
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.
Examples for CLRDTAQXCL
Example 1: Simple Command Example
ClrDtaQXCL DtaQ(QTEMP/TEST)
This command clears the data queue TEST in library QTEMP of all entries.
Error messages for CLRDTAQXCL
*ESCAPE Messages
- 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.
|
