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 the list entry that was read. Returned
for a successful READ request. The area is mapped by IXLYLCTL.
For
a READ request that failed because insufficient buffer storage was
provided to hold the data, the list entry controls for the entry whose
data couldn't fit in the buffer.
For a READ request that failed
because the target list entry did not meet the list number or version
number criteria specified by LISTNUM or VERSCOMP, the list entry controls
of the failing entry.
- LAALISTDESC
- The user-specified description of the list. Returned for READ
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 requests that
failed because of an authority mismatch. Returned only for structures
allocated in a coupling facility with CFLEVEL=1 or higher.
- LAATOTALCNT
- The total number of list entries in use in the structure. Returned
for requests that completed successfully.
- LAATOTALELECNT
- The total number of data elements in use in the structure. Returned
for requests that completed successfully.
- LAALISTCNT
- The number of list entries or data elements on the list that was
the target of the read operation. Returned for requests that completed
successfully. The value specified for LISTCNTLTYPE on the IXLCONN
macro when the list structure was allocated determines whether this
field represents a count of list entries or data elements.
- LAACONID
- For a READ request specifying the LOCKOPER parameter, LAACONID
contains, under the following circumstances:
- HELDBY parameter specified and the lock was not held by the connection
specified by LOCKCOMP or taken as the default.
- NOTHELD parameter specified with LOCKMODE=COND and the request
failed because the lock is held by another connection.
- NOTHELD parameter specified with LOCKMODE=UNCOND and the request
failed because the lock is held by a failed persistent connection.
- SET parameter specified with LOCKMODE=COND and the request failed
because the lock is held by another connection.
- SET parameter specified with LOCKCOMP and the lock was not held
by the specified connection.
- SET parameter specified with LOCKMODE=UNCOND and the request failed
because the lock is held by a failed persistent connection.
- RESET parameter specified without LOCKCOMP and the request failed
because you do not hold the lock.
- RESET parameter specified with LOCKCOMP 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