Receiving Answer Area Information from a MOVE Request

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 MOVE request, the list entry controls for the list entry that was moved or created. This area is mapped by IXLYLCTL.

For a MOVE 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 MOVE request that failed because the entry name (ENTRYNAME) specified for the new list entry already existed, the list entry controls for the list entry already having the specified name.

For a MOVE 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 MOVE 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 MOVE requests that failed because of an authority mismatch. Returned only for structures allocated in a coupling facility with CFLEVEL=1 or higher.

LAALISTKEY

The current value of the list key from the list controls. Returned for MOVE requests that failed because the maximum list key value would be exceeded. Returned only for structures allocated in a coupling facility with CFLEVEL=1 or higher.

LAAMAXLISTKEY

The current value of the maximum list key from the list controls. Returned for MOVE requests that failed because the maximum list key value would be exceeded. 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 to which the list entry was moved or the list which received the new list entry if DATAOPER=WRITE was specified with ENTRYTYPE=ANY and an entry was created. 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 MOVE 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.

LAAENTRYCREATED

Flag to indicate that the request created a new entry. Returned for successful MOVE requests when DATAOPER=WRITE is specified. Returned only for structures allocated in a coupling facility with CFLEVEL=1 or higher.