ISGLPRG — Purge a requestor from a latch set

Call the Latch_Purge service to purge all granted and pending requests for a particular requestor within a specific latch set. Recovery routines should call Latch_Purge when one or more errors prevent requestors from releasing latches. The following callable services are related to Latch_Purge:

ISGLCRT: Creates a latch set that an application can use to serialize resources.
ISGLOBT: Requests exclusive or shared control of a latch.
ISGLREL: Releases control of an owned latch or a pending request to obtain a latch.

In the following description of Latch_Purge, constants defined in the latch manager IDFs are followed by their numeric equivalents; you may specify either when coding calls to Latch_Purge.

Write the CALL as shown on the syntax diagram. You must code all parameters on the CALL statement in the order shown.

Assign values to the following parameters:

latch_set_token
requestor_ID

Latch_Purge returns a value in the return_code parameter.

CALL statement	Parameters
CALL ISGLPRG	(latch_set_token ,requestor_ID ,return_code)

The parameters are explained as follows:

latch_set_token: Specifies an 8-byte area that contains the latch_set_token previously returned by the Latch_Create service. The latch set token identifies the latch set from which latch requests are to be purged.
,requestor_ID: Specifies an 8-byte area that contains the requestor_ID originally specified on one or more previous calls to the Latch_Obtain service. The Latch_Purge service is to release all Latch_Obtain requests that specify this requestor_ID.
,return_code: A fullword integer that contains the return code from the Latch_Purge service.