Creating a List Entry

Use IXLLSTE ENTRYTYPE=ANY with REQUEST=WRITE or IXLLSTE ENTYTYPE=NEW to create a new list entry. ENTRYTYPE=ANY provides the option for creating a new list entry if the designated entry does not currently exist.

At structure allocation by IXLCONN, the following attributes of the list structure are established:

Whether list entry identifiers are system-assigned or user-assigned (IXLCONN ENTRYIDTYPE parameter)
Whether named entries or keyed entries (entry keys or secondary keys) are used to reference list entries.

When creating a new list entry, specify whether the list entry is to be assigned an entry name, entry key, or list key with the ASSIGN keyword. The initial allocation of the structure determines which ASSIGN value can be used.

ASSIGN=NAME
Assign the name specified for ENTRYNAME to the list entry. If a list entry already exists with the specified ENTRYNAME, a new list entry is not created and the IXLLSTE request is terminated. The newly created list entry is placed on the list specified by LISTNUM at the head or the tail specified by DIRECTION.
ASSIGN=KEY
Assign the entry key specified for ENTRYKEY to the list entry. If the structure was allocated to use secondary keys, assign the secondary key value specified by SECONDARYKEY to the list entry. If SECONDARYKEY is not supplied, the secondary key value is set to all binary zeros.
If a keyed list entry already exists with either the specified ENTRYKEY or SECONDARYKEY, a new list entry is created. The list entry is placed on the list as follows:
- If there exists a sublist of one or more entries with a matching key on the list, the target position is at the head or the tail of the sublist, as specified by DIRECTION.
- If all existing list entries have a key greater than that specified by ENTRYKEY, the target position is at the head of the list.
- If all existing list entries have a key less than that specified by ENTRYKEY, the target position is at the tail of the list.
The list entry is placed on the list as follows:
- If there exists a sublist of one or more entries with a matching secondary key on the list, the target position is at the head or tail of the sublist as specified by SKEYTARGETDIR.
- If all existing list entries have a secondary key greater than that specified by SECONDARYKEY, the target position relative to secondary key ordering is at the head of the list.
- If all existing list entries have a secondary key less than that specified by SECONDARYKEY, the target position is at the tail of the list.
If no matching entry key exists or if ENTRYKEY or SECONDARYKEY is neither the greatest nor least among the entry keys or secondary key, the target position for the newly created list entry is determined according to the entry key and secondary key sequence for the list.
ASSIGN=LISTKEY
Assign the current list key value to the newly created list entry. The list key and maximum list key values can be set with IXLLSTC REQUEST=WRITE_LCONTROLS. If the request specifies a list key value greater than the maximum list key value, the IXLLSTE request is terminated.

If the list structure was allocated with secondary keys, assign the value of SECONDARYKEY to the list entry. The position relative to secondary key ordering is based on the LISTNUM specified and the value of SKEYTARGETDIR.

If ASSIGN=NONE is explicitly specified or defaulted to, and the structure was allocated to use keyed entries, the entry key value is assigned as follows:

If DIRECTION=HEADTOTAIL, the list entry is assigned an entry key value of all binary zeros.
If DIRECTION=TAILTOHEAD, the list entry is assigned an entry ket value of all binary ones.

When creating a new list entry with a user-assigned ENTRYID, specify the user ID value with the ENTRYID keyword. If a list entry already exists with the specified ENTRYID, a new list entry is not created and the IXLLSTE request is terminated. ENTRYID can be specified if and only if the initial allocation of the structure specified IXLCONN ENTRYIDTYPE=USER and the structure is allocated in a coupling facility of CFLEVEL=8 or higher.