SET ATOMSERVICE
Enables or disables an ATOMSERVICE definition.
Syntax
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).
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.
Options
- ENABLESTATUS(cvda)
- Sets the ATOMSERVICE definition to enabled or disabled status. CVDA values are:
- DISABLED
- The ATOMSERVICE definition cannot be accessed by applications. An ATOMSERVICE definition has to be disabled before it can be reinstalled or discarded. If you disable an ATOMSERVICE resource definition, CICS® returns an HTTP response to the Web client with a 503 (Service Unavailable) status code.
- ENABLED
- The ATOMSERVICE definition can be accessed by applications.
Conditions
- INVREQ
- RESP2 values:
- 9
- Invalid ENABLESTATUS value.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
- 101
- The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.
- NOTFND
- RESP2 values:
- 3
- The ATOMSERVICE cannot be found.