30.06.2013 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Receive <strong>Data</strong> <strong>Queue</strong> (QRCVDTAQ) API<br />

A field of at least the length of the value specified for the MAXLEN parameter on the Create <strong>Data</strong><br />

<strong>Queue</strong> (CRTDTAQ) command. This field contains the data received from the data queue.<br />

Note: If the length of this field is larger than the size of the message received, only the number of<br />

characters (beginning from the left) as defined by the message received from the data queue are<br />

changed. If the length of this field is smaller than the value specified for the MAXLEN parameter<br />

on the Create <strong>Data</strong> <strong>Queue</strong> (CRTDTAQ) command, and the actual length of this field is not specified<br />

in the size of data receiver parameter, unexpected results can occur.<br />

If the length of this field is specified in the size of data receiver parameter, the data received will be<br />

truncated if it is longer than the size specified.<br />

Wait time<br />

INPUT; PACKED(5,0)<br />

The amount of time to wait if no entries exist on the data queue.<br />

When no entries are on the data queue, the wait time parameter (in seconds) specifies the following:<br />

< 0<br />

Waits forever.<br />

0<br />

Continue processing immediately. If no entry exists, the call completes immediately with the<br />

length of data parameter set to zero.<br />

> 0<br />

The number of seconds to wait. The maximum is 99999 which allows a wait time of<br />

approximately 28 hours.<br />

Note: If the wait time value is less than or equal to 2, the job does not leave the activity level (for 2<br />

seconds). This is described as a short wait. For more details on activity levels and implementation<br />

applications, see the Work Management book.<br />

Optional Parameter Group 1<br />

Key order<br />

INPUT; CHAR(2)<br />

The comparison criteria between the keys of messages on the data queue and the key data<br />

parameter. When the system searches for the requested key, the entries are searched in ascending<br />

order from the lowest value key to the highest value key until a match is found. If there are entries<br />

with duplicate keys, the entry that was put on the queue first is received. Valid values are:<br />

GT<br />

Greater than<br />

LT<br />

Less than<br />

NE<br />

Not equal<br />

http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qrcvdtaq.htm (4 of 9) [10/4/1999 2:32:20 PM]

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!