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.