General Information

CONSOLEID Subparameter

During system initialization, each console on the system is assigned a console identifier by z/OS. This identifier (xx) is a 2-digit number from 00 through 99 that corresponds to the position of the CONSOLE statement in member CONSOLxx in the SYS1.PARMLIB library.

Only commands issued from the specified console IDs can trigger the rule.

CONSOLE Subparameter

This is the name that is assigned to the console. A valid name contains 2 to 8 alphanumeric characters.

Only commands issued from the specified console name can trigger the rule.

SYSTEM Subparameter

The name specified by the SYSTEM subparameter is the unique system name of the z/OS image in the Sysplex environment.

When a system name is specified for the SYSTEM subparameter, commands issued by the specified system can trigger rules. However, if no system is specified, only commands originally issued on the current system are used.

Note: If the specified SYSTEM name does not match the system name where Control-O is currently running, Control-O does not trigger the rule. Conversely, Control-O will trigger such rules on the system where Control-O is currently running.

SMFID Subparameter

Each computer in a complex installation is assigned an SMF identifier of from 1 through 4 characters.

If SMFID is specified, only commands issued from the specified SMF IDs will trigger the rule.

Suppressing a LOGON command

Use an ON MESSAGE statement to suppress the LOGON messages appearing in the SYSLOG.

Example

Note:

BMC recommends that you not specify the following statements together in one rule:

ON COMMAND=LOGON

DO DISPLAY=SUPPRESS Y

This combination of statements can result in bringing TSO down because TSO issues an internal LOGON command to start a TSO user.

Dealias Feature

Most z/OS, JES2, and JES3 operator commands can be specified in more than one format:

• z/OS and JES3 commands:
  These commands usually have two formats – a full name format and a shorter format known as an alias. For example, the RESET z/OS command has the alias E.
• JES2 commands:
  These commands can contain embedded backspace characters.
• z/OS, JES2 and JES3 commands:
  These commands can contain a variable number of blank spaces between parameters.

Control-O provides a Dealias feature that recognizes and converts the various formats of a command. For a list of commands for which dealiasing is supported, see Appendix C, "List of Commands for Which Dealiasing Is Supported."

Example

A rule contains an ON COMMAND RESET * statement. If the operator enters the command alias E JOB1

• with the Dealias feature, the rule is triggered
• without the Dealias feature, the rule is not triggered

The Dealias feature can be enabled at time of installation. It converts commands to standardized format in the following ways:

• All z/OS JES3 operator commands and aliases are changed to their full name format. For example, E JOB1 becomes RESET JOB1. A list of z/OS JES3 commands and aliases can be found in List of Commands for Which Dealiasing Is Supported.
• Multiple spaces between a command and its operands are reduced to single spacing. For example, RESET  JOB1 becomes RESET JOB1.
• JES2 backspace characters, indicated here by the symbol <, are interpreted, and backspaced text is deleted from the command. For example, $PJ12345<<<<<1 becomes $PJ54321.

The Dealias feature edits commands in the following instances:

• during rule definition in Screen OR
  Any reference to a command in alias form is automatically changed to its full name in the ON COMMAND statement.
• when a table or rule is ordered or forced
  Any command in alias format is changed to the corresponding full name format command.
• when an operator command is intercepted by Control-O
  If it is in alias format, it is brought to its full name format before the rules are scanned.
• when an ID is specified as a show criteria in the Automation Log