SET ENQMODEL

Change the status of an ENQMODEL definition.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

SET ENQMODEL

Conditions: INVREQ, NOTAUTH, NOTFND

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations. For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

This command is threadsafe.

Description

The SET ENQMODEL command allows you to ENABLE or DISABLE ENQMODEL resources installed on the local system. An ENQMODEL must be enabled to allow matching EXEC ENQ requests to be processed. It must be disabled to allow a more specific ENQMODEL to be enabled.

ENQMODELs forming nested generic enqnames must be enabled in order, from the most to the least specific. For example, enable ABCD* then ABC* then AB*. If you attempt to enable a more specific ENQMODEL when a less specific enqmodel is already enabled, the result is that msg NQ0107 is issued and INVREQ is returned to the caller.

In this case you may need to disable one or more less specific ENQMODELs to allow a more specific ENQMODEL to be enabled. You will then be able to enable the less specific ENQMODELs again.

You cannot enable/disable an ENQMODEL which is in the waiting state. If attempted, INVREQ is returned to the caller.

Options

ENQMODEL(data-value)

specifies the 8-character identifier of the resource definition.

STATUS(cvda)

specifies the action to be taken on the ENQMODEL. CVDA values are:

ENABLED: If the ENQMODEL is DISABLED, it is ENABLED. Once enabled, matching ENQ requests are processed in the normal way.
DISABLED: The ENQMODEL is put into the WAITING state until there are no enqueues in the local system which match the ENQNAME pattern. It will then be DISABLED. Once disabled, matching ENQ requests will be rejected, and the issuing task is abended.

Conditions

INVREQ

RESP2 values:

2: The attempt to enable/disable an ENQMODEL failed, because a more generic ENQMODEL is enabled.
3: STATE has an invalid CVDA value.
4: The ENQMODEL is in the WAITING state

NOTAUTH

RESP2 values:

100: The user of the issuing task is not authorized to use this command.

NOTFND

RESP2 values:

1: The specified ENQMODEL is not installed on this system.