Enqueue Domain (NQ)

The NQ domain provides UOW based locking services. This is provided to the local clients FC, TD and TS. It also services the EXEC CICS® ENQ/DEQ requests.

The most common functions provided by the NQ domain are:

CREATE_ENQUEUE_POOL
This function creates a separate enqueue pool for the caller. A token is returned which the caller specifies on all requests associated with that pool.
DEACTIVATE
This function converts an active enqueue into retained state. The caller must already own the enqueue.
REACQUIRE_ENQUEUE
NQ domain doesn't recover enqueues over a CICS restart. Instead resource owners use this function to reacquire enqueues that were held by inflight and indoubt UOWs.
ENQUEUE
This functions obtains an enqueue from the specified enqueue pool in active state.
DEQUEUE
This functions releases an active enqueue owned by the current UOW from the specified enqueue pool.
INQUIRE_NQRNAME
This function calls INQ_NQRNAME to see if an enqueue name entry exists in NQRNAME_LIST. If the name is either an exact or generic match, INQUIRE_NQRNAME returns the 4-character SCOPE name, enqmodel STATE and ann OK RESPONSE. Otherwise it returns an EXCEPTION REASON(NQRNAME_NOT_FOUND).
ADD_REPLACE_ENQMODEL
This function adds an enqmodel definition to both the NQRN directory (keyed by enqmodel name, and to the NQRNAME_LIST (keyed by the variable length NQRNAME). If the enqmodel already exists the entry is replaced.
DISCARD_ENQMODEL
Remove an enqmodel definition from both the NQRN directory and from the NQRNAME_LIST. If the enqmodel is not installed, exception 'ENQMODEL_NOT_FOUND' is returned.
INQUIRE_ENQMODEL
Uses directory DDLO_LOCATE to retrieve information about a specified enqmodel definition in the NQRN directory.

If found, it returns the 1 to 255 character NQRNAME, the 4-character SCOPE name, the enqmodel STATE and ann OK RESPONSE. Otherwise it returns an EXCEPTION REASON(ENQMODEL_NOT_FOUND).

SET_ENQMODEL
This function uses directory DDLO_LOCATE to see if an enqmodel entry exists in the NQRN directory. If found, it enables or disables the entry. Otherwise it returns an EXCEPTION REASON(ENQMODEL_NOT_FOUND).
[[ Contents Previous Page | Next Page Index ]]