gtps1m3nSystem Macros

LEMIC-Lock Entry Management Interface

Use this system macro to issue one or more service requests to a coupling facility (CF) that you are using as an external locking facility (XLF).

Format




label1
A symbolic name can be assigned to the macro statement.

BLOCK
This specifies the block of storage that is mapped by the ICFLP DSECT and must reside in a single page, and that is passed to the service routine. The format of the BLOCK parameter is:

(reg)
A register containing the address of the storage area where the data is placed.

OPERATION
The type of service request being performed:

CLEARUSER
Clears all locks, any held lock requests, or any queued lock requests for a particular user from a CF.

DELETE
Removes one or more held locks from a CF.

DELETESET
Removes a set of locks associated with a particular CF list structure from a CF.

LOCATELOCK
Locates a CF and list number where each lock resides for one or more lock names.

LOCATEMOD
Locates a CF and the starting and ending list numbers that are used for locking by a particular module.

MANAGE
Sends one or more set, release, or withdraw lock commands, in any combination, to a CF.

MONITOR
Registers a user for lock granted and contention notification.

READ
Reads one or more locks in a CF.

READUSER
Reads all locks that are held by a particular user on a CF.

VERIFYCF
Verifies the connectivity between a processor and a CF.

ERROR=label2
This label specifies the symbolic name of an error routine in which to branch if any error indicators were set.

Entry Requirements

See the ICFLP DSECT to determine the required input fields and the information included on return in the ICFLP_DATA control area.

Return Conditions

Programming Considerations

Examples

None.