Parameters for Facilities › Automate-related Parameters › ATMCMDCHAR Parameter

ATMCMDCHAR Parameter

The ATMCMDCHAR parameter specifies the command character used to issue Automate commands to CA OPS/MVS. The OPAMCMCH rule, which is enabled during CA OPS/MVS initialization, intercepts and performs these Automate commands.

For information about how CA OPS/MVS defines ATMCMDCHAR to the z/OS Command Prefix Facility (CPF), see the Administration Guide. For general rules for defining CPF strings, see Characters That Can Be Used in z/OS Commands in the chapter “Using This Reference.”

Note: CA OPS/MVS automatically defines the command prefix to the CPF during product initialization and attempts to delete the prefix from the CPF during termination. If some other subsystem is already using this prefix, the prefix will not be defined to the CPF and the following message will be issued during product initialization:

OPS0100W CPF DEFINE OF ATMCMDCHAR FAILED, RC=X'00000008', REASON CODE=X'00000008'

Reason codes of X'0000000C' and X'00000010' are also indicators of this type of problem since the prefix specified may be either a subset or superset of a prefix that is already defined.

If you change the value of ATMCMDCHAR while CA OPS/MVS is active, the CPF prefixes will not be updated and the following message will be issued during product termination:

OPS0100W CPF DELETE OF ATMCMDCHAR FAILED, RC=X'00000008', REASON CODE=X'00000004'

Notes:

• The value you specify for the ATMCMDCHAR parameter must be different than the Automate command character specified on the Automate CMDCHAR parameter, unless Automate is no longer active on the same z/OS image. Using the same value for both parameters causes unpredictable results.
• If you have not converted from Automate or if you no longer use Automate operator commands, you should set the ATMCMDCHAR parameter to a single blank to avoid wasting a z/OS command prefix (for example, OPSPRM('SET','ATMCMDCHAR',' ').

Important! The ATMCMDCHAR parameter can only contain characters from the table shown in Characters That Can Be Used In z/OS Commands in the chapter “Using This Reference.”

Default value

(

Other possible values

Any valid z/OS command recognition character that is not being used by another subsystem; if necessary, you may specify a 2-byte character.

Set or modify this value...

At initialization

Example: ATMCMDCHAR

This function sets the ATMCMDCHAR to !:

OPSPRM('SET','ATMCMDCHAR','!')