Apply Data Queue Journal Entry (APYDTAQXCL)
The Apply Data Queue Journal Entry (APYDTAQXCL) command applies a data queue journal entry to a data queue.
This function is also available with command APYDTAQE 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 *ADD authority to the data queue.
- The data queue must be a local data queue.
| Keyword | Description | Choices | Notes |
| DTAQ |
Data queue |
Qualified object name |
Optional, Positional 1 |
| Qualifier 1: Data queue |
Name |
| Qualifier 2: Library |
Name, *LIBL, *CURLIB |
| DTA |
Data |
Character value |
Optional, Positional 2 |
| DTALEN |
Data length |
Decimal number |
Optional |
Data queue (DTAQ)
Specifies the qualified name of the data queue to be used.
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.
Data (DTA)
Specifies the CL variable containing the journal entry associated with a data queue entry.
This is a required parameter.
- character-value
- Specify the CL variable containing the journal entry.
Data length (DTALEN)
Specifies the length of the journal entry identified by the DTA parameter. The length value must be obtained from the journal entry. The length could be longer than the maximum entry length of the data queue.
This is a required parameter.
- decimal-number
- Specify the length of the DTA parameter.
Examples for APYDTAQXCL
Example 1: Simple Command Example
ApyDtaQXCL DtaQ(MyLib/MyQueue) Dta(&JEntry) DtaLen(&Size)
This command applies the journal entry found in CL variable &JEntry, with a size of &Size, to the data queue MyQueue in library MyLib. The &Size parameter value is determined by the journal entry. The &Size value is not determined by the maximum length defined for entries on data queue MyQueue in library MyLib.
Error messages for APYDTAQXCL
*ESCAPE Messages
- XCL501D
- DTALEN(&1) is greater than defined length of DTA parameter.
- 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.
|
