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 ]]