NQRN gate, SET_ENQMODEL function
This function uses directory DDLO_LOCATE to see if an enqmodel entry exists in the NQRN directory. If found, it calls SET_ENQMODEL to enable or disable the entry. Otherwise it returns an EXCEPTION REASON(ENQMODEL_NOT_FOUND).
Enqmodels forming nested generic nqrnames must be enabled in order, from the most to the least specific. I.e. A more specific enqmodel may not be enabled if a less specific enqmodel is enabled. If attempted, msg NQ0107 is issued and EXCEPTION 'DUPLICATE_ENABLED' is returned to the caller.
You cannot enable/disable an enqmodel which is in the waiting state. If attempted, EXCEPTION 'ENQMODEL_WAITING' is returned to the caller.
Input Parameters
- ENQMODEL
- The 8-character identifier of the entry to be enabled/disabled.
- STATE
- The intended state of the ENQMODEL.
- Values for the parameter are:
- DISABLED
- ENABLED
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ACQUIRE_LOCK_FAILED
- CATALOG_UPDATE_FAILED
- DIRECTORY_LOCATE_FAILED
- RELEASE_LOCK_FAILED
- The following values are returned when RESPONSE is EXCEPTION:
- DUPLICATE_ENABLED
- ENQMODEL_NOT_FOUND
- ENQMODEL_WAITING
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.