NQRN gate, INQUIRE_ENQMODEL function
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).
Input Parameters
- ENQMODEL
- The 8-character identifier of the entry to be returned.
- NQRNAME
- Optional Parameter
- A buffer returning the 1 to 255 character name and length of the ENQ name or generic stem*
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ACQUIRE_LOCK_FAILED
- DIRECTORY_LOCATE_FAILED
- RELEASE_LOCK_FAILED
- The following values are returned when RESPONSE is EXCEPTION:
- ENQMODEL_NOT_FOUND
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- SCOPE
- Optional Parameter
- Returns the 4-character scope identifier for the resource. Four blanks indicates that the enqueue has local scope.
- STATE
- Optional Parameter
- Values for the parameter are:
- ENABLED
- Matching ENQ/DEQ requests should be processed.
- DISABLED
- Matching ENQ/DEQ requests should be rejected, and the issuing task abended abcode ENQ_DISABLED.
- WAITING
- There are INSTALL, CREATE, or DISCARD requests waiting to be processed. Matching ENQ/DEQ requests should be rejected, and the issuing task abended abcode ENQ_DISABLED.