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.


dfhs3_NQRNset_enqmodel.html | Timestamp icon Last updated: Monday, 5 June 2017