Control-O/COSMOS Command Prefix

Version 6.1.00 handles this situation by requiring you to define a 3-character command prefix for each Control-O/COSMOS instance during ICE installation, using the PROCPRFO parameter of that instance. You use these defined prefixes in place of the regular COS prefixes for each Control-O/COSMOS command.

Each Control-O/COSMOS instance has a set of Control-O/COSMOS rules beginning with the ??? prefix. These rules implement the Control-O/COSMOS commands that use the defined command prefixes. For example, the rules ???INI and ???UP implement the commands that correspond to the COSINI and COSUP commands, respectively. These ???-prefixed rules check whether the prefix of a Control-O/COSMOS command matches the prefix of the Control-O/COSMOS instance specified in its PROCPRFO parameter.

When you enter a prefixed Control-O/COSMOS command, all Control-O/COSMOS instances in the IOA environment receive that command. Each instance compares the Control-O/COSMOS command with the %%COSPREFIX variable, which was initialized with the value of the PROCPRFO parameter by the ON RULE USRCLEAR rule in the $COSMOSU table. If the defined prefix and command prefix do not match, command processing is terminated for that Control-O/COSMOS instance. Otherwise, the command is executed normally. If the prefix does not match that of any Control-O/COSMOS instances, the command is not executed.

When using the ??? prefix, note the following:

• If a rule with the ??? prefix triggers a Control-O/COSMOS command, that command will use the same prefix as the triggering command.
• Control-O/COSMOS commands are now trapped by the ON COMMAND rules that use the ??? prefix. These ON COMMAND rules check the prefix and, if there is a match, pass control to the corresponding ON RULE rules.

Example:

Two Control-O/COSMOS instances are running on a CPU, for which you specified PR1 and PR2 as the prefixes, respectively. To run the COSINI command (described in COSINI Command – Starting Control-O/COSMOS) on both instances, and the COSUP (described in Shortcuts for the COSCMD Command) on the second (PR2) instance, use the following set of commands:

PR1INI

PR2INI

PR2UP