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. The area is mapped
by IXLYLCTL.
For a successful DELETE request, the list entry controls
for the list entry that was deleted. This area is mapped by IXLYLCTL.
For
a DELETE 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 for the list entry that failed
to meet the selection criterion.
For a DELETE request with
DATAOPER=READ that failed because the buffer was too small to hold
the data to be read, the list entry controls for the list entry that
caused the operation to fail.
- LAALISTDESC
- The user-specified description of the list. Returned for DELETE
requests that failed because of a list 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 DELETE requests
that failed because of a list 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 DELETE 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 DELETE 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