Receiving Answer Area Information from a READ

When you invoke IXLLIST, list services return information related to your request in the answer area specified using the ANSLEN and ANSAREA parameters.

Under certain circumstances, answer area information is not valid. See Determining if the Answer Area is Valid for information on how to determine whether the answer area information is valid.

The following list describes the information returned when the answer area is valid. The answer area is mapped by the IXLYLAA macro, which is presented in z/OS® MVS™ Data Areas in the z/OS Internet library.

LAARETCODE

The return code from the IXLLIST service. Return code values are defined in the IXLYCON macro.

LAARSNCODE

The reason code associated with the return code from the IXLLIST service. Reason code values are defined in the IXLYCON macro.

LAALCTL

The list entry controls. The area is mapped by IXLYLCTL.

For a request that completes prematurely, the list entry controls for the list entry to be scanned next. When you reissue the READ_LIST request to continue the scan, designate this list entry as the starting entry by specifying the entry ID returned here with the ENTRYID parameter.
For a request that fails because the first list entry to be read is larger than the entire buffer, the list entry controls for the list entry that is too large.
For a request that fails because the starting entry specified was not on the specified list, returns the list entry controls of the specified starting list entry. Use the list controls to determine the correct list to specify for that starting entry.

LAALISTDESC

The user-specified description of the list. Returned for READ_LIST requests that failed because of an authority mismatch. Returned only for structures allocated in a coupling facility with CFLEVEL=1 or higher.

LAALISTAUTH

The list authority for the list. Returned for READ_LIST requests that failed because of an authority mismatch. Returned only for structures allocated in a coupling facility with CFLEVEL=1 or higher.

LAAREADCNT

The count of entries read by READ_LIST. This information is returned for both successful and premature request completion. If no scanned list entries met the criteria specified for selection to be read, the count is set to zero. If the request completed prematurely, there might be additional list entries that meet the selection criteria that have not yet been scanned.

LAACONID

For a READ_LIST request specifying the LOCKOPER parameter, LAACONID contains, under the following circumstances:

NOTHELD parameter specified and the request failed because the lock is held by another connection.
HELDBY parameter specified with or without the LOCKCOMP parameter and the lock was not held by the specified connection.

Either of the following:

The connection identifier of the lock owner, if the lock specified by the LOCKINDEX parameter is held
Zeros, if the lock specified by the LOCKINDEX parameter is free.

LAARLRMLCTLS

For a READ_LIST request specifying ECONTROLS on the TYPE parameter, the list entry controls of the first list entry read. This field is mapped by the IXLYLCTL macro and is valid whether the request completes successfully or prematurely.