Description

A MOVE request allows you to perform one of the following types of operations:

Move an existing list entry from one list to another list or within the same list. In addition to moving the entry, you can also read or update that entry's data.
Create a new list entry (if the entry does not exist on a specified list), place it on either the same or another list, and write data to it.

Use the DATAOPER parameter to specify the operation to be performed:

DATAOPER=NONE Only the existing entry is moved.
DATAOPER=READ The existing entry is moved, and its data is read.
DATAOPER=WRITE
- ENTRYTYPE=OLD The existing entry is moved, and its data is updated.
- ENTRYTYPE=ANY If the designated entry exists, it is moved and its data is updated. If the entry does not exist, a new entry is created and data is written to it.

If this request creates a new entry (ENTRYTYPE=ANY must be specified) you must provide the list number (MOVETOLIST) on which the new entry will be placed. You can also provide additional identification for the new entry by specifying one of the following:

Entry name (ENTRYNAME)
Entry key (ENTRYKEY)

Note: You cannot assign an entry identifier (ENTRYID) to a new entry; the system assigns entry identifiers to all new entries.

A MOVE request allows you to read (DATAOPER=READ) or write (DATAOPER=WRITE) entry data and/or adjunct data. Entry data is read from or written to the data entry segment of an entry, while the adjunct data is read from or written to the adjunct data area segment. The following describes from where each type of data is written (if DATAOPER=WRITE) or where each type of data is returned (if DATAOPER=READ):

A buffer (BUFFER) or list of buffers (BUFLIST) holds entry data. If neither BUFFER nor BUFLIST is specified, no entry data is read or written.
An adjunct area (ADJAREA) holds adjunct data. If ADJAREA is not specified, no adjunct data is read or written.

If you specify DATAOPER=WRITE, you can assign the number of data elements comprising the data entry segment of the existing or new entry by specifying ELEMNUM.

Additionally, you can perform locking functions with a MOVE request by specifying LOCKINDEX. The lock entry 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 MOVE request:

You can specify that a list entry be moved only if the list authority value for the list associated with the entry is of a certain 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.
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.
There are additional list cursor options. You can update the list cursor conditionally, and you can set the list cursor to point to the current entry instead of the previous or next entry.