The IXLLSTE and IXLLSTM services provide options for the user to locate the list entry or list entries to be processed. The options are comparable to those used by the IXLLIST service and are described in Referencing List Entries. Some options provide additional capabilities for specifying the list entry, such as by comparing the entry name or key values. See Enhancement to List Services Entry Key and Secondary Key Comparison for a description of the comparator options available with the IXLLSTE, IXLLSTM, and IXLLSTC services.

LOCATOR=CURSOR

Use the list cursor to designate the list entry. See also Understanding the List Cursor.

LOCATOR=ENTRYID

Use the ENTRYID to designate the list entry. Note that for list structures allocated in a coupling facility of CFLEVEL=8 or higher, the ENTRYID can be either system-assigned or user-assigned.

LOCATOR=ENTRYNAME

Use the ENTRYNAME (if the structure was allocated to use named entries) to designate the list entry.

LOCATOR=UNKEYPOS

Use LISTNUM and DIRECTION to designate the list entry at either the head or the tail of the list. Note that for IXLLIST services, the keyword LISTPOS is analogous to DIRECTION.

LOCATOR=KEYPOS

Use LISTNUM, DIRECTION, and the key specified by KEYTYPE (entry key or secondary key) to designate the list entry. Note that secondary keys are valid only in list structures that have been allocated with the appropriate attributes in coupling facilities of CFLEVEL=9 or higher.

Note that LOCATOR=KEYPOS is the only method of locating an existing list entry by secondary key. Use KEYTYPE=SECONDARY and specify SKEYREQTYPE to designate how a comparison is to be performed to find the list entry. SKEYREQTYPE provides comparison values of EQUAL, LESSOREQUAL, and GREATEROREQUAL, in addition to RANGE for multiple requests.