Description

A WRITE request writes entry data and/or adjunct data to an existing or new list entry depending on the value specified for ENTRYTYPE. Entry data is written to the data entry segment of a list entry, while the adjunct data is written to the adjunct data area segment. Before issuing the request, the data to be written to the entry should be stored as follows:

Use the BUFFER or BUFLIST parameter to identify the storage containing the data to be placed in the data entry.
Use the ADJAREA parameter to identify the storage containing the data to be placed in the adjunct area.

Note: If the structure supports entry data and BUFFER and BUFLIST are not specified, then the created list entry does not contain any entry data. If the structure supports adjunct data and ADJAREA is not specified, then the created list entry contains binary zeros in the adjunct area.

If you are writing entry data to the structure, you can specify the number of data elements comprising the data entry segment of an existing or new entry by using ELEMNUM.

Additionally, you can perform locking functions with a WRITE request by specifying LOCKOPER. The lock designated by LOCKINDEX will be operated on as specified by LOCKOPER.

With a coupling facility of CFLEVEL=1 or higher, the following additional functions are supported for a WRITE request:

You can specify that a list entry is to be written only after a successful comparison of the list authority value for the target list with a user-specified value. You specify the list authority comparison requirements using AUTHCOMP and AUTHCOMPTYPE. If the request is successful, you also can update the list authority value to a new value that you specify with NEWAUTH.
Several options are available for updating the list cursor, based on request completion.
Version number comparison is enhanced to allow for an additional equal-or-less-than-equal comparison operation.
The system can assign an entry key value automatically from a list control list key value.

When the request successfully completes, list entry controls, the number of elements or entries residing on the list, and the total number of allocated entries in the structure are returned in the answer area (ANSAREA) if specified (mapped by IXLYLAA).

See z/OS MVS Programming: Sysplex Services Guide for more information on how to use the IXLLIST REQUEST=WRITE request.