Get List Entries (QGYGTLE) API


  Required Parameter Group:


  Default Public Authority: *USE

  Threadsafe: No

The Get List Entries (QGYGTLE) API allows requests to get entries from previously opened lists. A list will exist if an initial request has already been made and the list was not closed using the Close List (QGYCLST) API.

Initial requests are made by calling the following APIs:


Authorities and Locks

None.


Required Parameter Group

Receiver variable
OUTPUT; CHAR(*)

The receiver variable that receives the information requested. You can specify the size of the area to be smaller than the format requested as long as you specify the length parameter correctly. As a result, the API returns only the data that the area can hold.

Length of receiver variable
INPUT; BINARY(4)

The length of the receiver variable provided. The length of receiver variable parameter may be specified up to the size of the receiver variable specified in the user program. If the length of receiver variable parameter specified is larger than the allocated size of the receiver variable specified in the user program, the results are not predictable. The minimum length is 8 bytes.

Request handle
INPUT; CHAR(4)

The handle of the request. The value of this determines from which user space to retrieve the information.

List information
OUTPUT; CHAR(80)

Information about the list from which entries are being returned. For a description of the layout of this parameter, see Open list information format.

Number of records to return
INPUT; BINARY(4)

The number of records in the list (starting with the record indicated in the starting record parameter) to take from the user space and put into the receiver variable. This value must be greater than or equal to zero.

If the value zero is specified, then only the list information is returned and no actual list entries are returned.

Starting record
INPUT; BINARY(4)

The entry in the list that will be the first entry to be put into the receiver variable. The value must be greater than zero or one of the special values of 0 or -1.

The special value of 0 indicates that the list information should be returned to the caller immediately. The special value 0 is only allowed when the number of records to return parameter is zero.

The special value of -1 indicates that the whole list should be built before the list information is returned to the caller.

The following table shows how the number of records to return and the starting record parameters interact with each other. The record parameter is represented by an X. The number of records to return parameter is represented by a Y.



Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Format of Receiver Variable

The format of the receiver variable was specified when the list was originally created.


Error Messages



API introduced: V3R6

[ Back to top | Process Open List APIs | APIs by category ]