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.

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.

LAALISTDESC

The user-specified description of the list. Returned for READ_MULT requests that fail 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_MULT requests that fail 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_MULT. 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.

LAARESTOKEN

The restart token for the request. Returned if ALLOWAUTO=NO was specified or defaulted to on IXLCONN to connect to the structure and the READ_MULT request completed prematurely.

LAAEXTRESTOKEN

The extended restart token for the request. Returned if ALLOWAUTO=YES was specified on IXLCONN to connect to the structure and the READ_MULT request completed prematurely.

LAACONID

For a READ_MULT 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_MULT 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.