NQRN gate, ADD_REPLACE_ENQMODEL function

This function adds an ENQMODEL resource definition to both the NQRN directory (keyed by enqmodel name) and to the NQRNAME_LIST (keyed by the variable length NQRNAME).

If the ENQMODEL resource already exists, the entry is replaced. The replace is a discard, then add operation.

If an attempt is made to create a deep enqmodel nesting, or if another enqmodel with the same nqrname is already installed, then message DFHNQ0106 is issued and a 'DUPLICATE_NQRNAME' exception is returned.

Input Parameters

CALLER
COLDINST, RDOINST or RESTART indicating A cold start, An online install or The input is in the MODEL_TOKEN respectively.
Values for the parameter are:
  • COLDINST
  • RDOINST
  • RESTART
CATALOG
Indicates whether the record should be cataloged.
Values for the parameter are:
  • NO
  • YES
ENQMODEL
The 8-character identifier of the resource to be added.
MODEL_TOKEN
The address of the record obtained from the catalog to be restored.
NQRNAME
Optional Parameter
A buffer giving the 1 to 255 character name and length of the ENQ name or stem* to be added.
SCOPE
Optional Parameter
The 4-character scope identifier for the resource. If omitted or specified as blanks, matching ENQs will have LOCAL scope.
STATE
Optional Parameter
The state in which to install the ENQMODEl resource. If omitted, ENABLED is assumed.
Values for the parameter are:
  • DISABLED
  • ENABLED

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ACQUIRE_LOCK_FAILED
  • CATALOG_WRITE_FAILED
  • DIRECTORY_ADD_FAILED
  • DIRECTORY_DELETE_FAILED
  • GETMAIN_FAILED
  • RELEASE_LOCK_FAILED
The following values are returned when RESPONSE is EXCEPTION:
  • DUPLICATE_ENABLED
  • DUPLICATE_NQRNAME
The following values are returned when RESPONSE is INVALID:
  • INVALID_PARAMETERS
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
ENQMODEL_OUT
Optional Parameter
The name of an existing resource that is already installed, and not disabled, that prevents the successful completion of this operation.


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