Creating a New List Entry as Part of a MOVE Request

If you specify ENTRYTYPE=ANY, your request might cause a new list entry to be created. You can either provide the information necessary to create and position the new list entry or have the list service position the new list entry according to its default values.

For a list structure with entry names: You must provide a list entry name (ENTRYNAME) for the list service to use if it creates a new list entry for you.

The list service uses the value of LISTPOS to determine whether to place the new list entry at the head or tail of the target list.

For a list structure with entry keys: If you specify the MOVETOKEY parameter, the new list entry is assigned the key specified by MOVETOKEY. If you omit the MOVETOKEY parameter but specify the ENTRYKEY parameter, the new list entry is assigned the key specified by ENTRYKEY. If you omit both MOVETOKEY and ENTRYKEY, the new list entry is assigned a key based on the value of MOVETOPOS. If MOVETOPOS=HEAD, the key is set to binary zeros. If MOVETOPOS=TAIL, the key is set to binary ones.

For a keyed list structure in a CFLEVEL=3 or higher coupling facility: If your MOVE request specifies DATAOPER=WRITE and ENTRYTYPE=ANY for a keyed list structure in a CFLEVEL=3 or higher coupling facility and the target sublist is empty,

The target sublist transitions to nonempty
The system queues all EMCs associated with the target sublist to the respective users' event queues.

For list structures allocated in a CFLEVEL=1 or higher coupling facility, you can use the list key value associated with the list to set the list entry key. See Understanding List Entry Key Assignment.

See Figure 1 for a flowchart illustrating some key assignment rules.

For More Information

The following information discussed under WRITE: Writing to a List Entry also applies to REQUEST=MOVE with DATAOPER=WRITE:

Specifying the Size of the Data Entry to Hold the Data