Data Queue APIs--Categories - FTP Directory Listing - IBM

Receive Data Queue (QRCVDTAQ) API
use this API to receive a message from a data queue that exists on a remote AS/400. However, using this
API to receive messages without removing them from the data queue is not supported for DDM data
queues.
Authorities and Locks
Data Queue Authority
*OBJOPR and *READ
Data Queue Library Authority
*EXECUTE
Data Queue Lock
*EXCLRD
Required Parameter Group
Data queue name
INPUT; CHAR(10)
The name of the data queue to receive the data from.
Library name
INPUT; CHAR(10)
The name of the library where the data queue resides.
You can use these special values for the library name:
*LIBL
The library list
*CURLIB
The job's current library.
Note: To improve data queue performance, the data queue APIs remember addressing information
for the last data queues used. This occurs when a specific (not *LIBL or *CURLIB) value is
provided for the library name.
Because the addressing information is saved, users of this API should be aware of the following
scenarios.
Scenario 1
If,
❍
❍
❍
a job references a library-specific data queue,
the data queue is moved using the Move Object (MOVOBJ) command or renamed using the
Rename Object (RNMOBJ) command, and
a new data queue is created with the same name and library as the data queue that was
renamed or moved,
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qrcvdtaq.htm (2 of 9) [10/4/1999 2:32:20 PM]