Guide to the latch manager callable services

This information introduces the latch manager services, describes the information you must provide when calling each service, and offers suggestions about when to use each service.

The latch manager provides the following callable services for all SAA high level languages:

Table 1. Latch Manager Services
Service Call Name Description
Latch_Create ISGLCRT Create a set of latches.
Latch_Create ISGLCR64 Create a set latches in 64-bit mode.
Latch_Identify ISGLID Identify a latch.
Latch_Identify ISGLID64 Identify a latch in 64-bit mode.
Latch_Obtain ISGLOBT Obtain exclusive or shared control of a latch.
Latch_Obtain ISGLOB64 Obtain exclusive or shared control of a latch in 64-bit mode.
Latch_Release ISGLREL Release ownership of an owned latch or a pending request to obtain a latch.
Latch_Release ISGLRE64 Release ownership of an owned latch or a pending request to obtain a latch in 64-bit mode.
Latch_Purge ISGLPRG Purge all granted and pending requests for a particular requestor within a specific latch set.
Latch_Purge ISGLPR64 Purge all granted and pending requests for a particular requestor within a specific latch set while in 64-bit mode.
The syntax for calling the latch manager callable services in assembler language is:
CALL routine_name,(parm1,parm2,...return_code)
Note: This information references equate symbols and associated numeric values that are defined in the latch manager interface definition files (IDFs). (IDFs define variables and values for the parameters used with latch manager services.) Each equate symbol is followed by its numeric equivalent; for example, "ISGLREL_COND (value of 1)" indicates the equate symbol ISGLREL_COND and its associated value, 1. You may specify either the equate symbol or its associated value when coding the latch manager callable services. For more information about latch manager IDFs, see Including a latch manager interface definition file (IDF).