Additional usage notes for AOEXEC CMD

Output variables

Command output is placed in variables LINE.1 through LINE.nnnn, where nnnn is the last line (variable LINE.0 contains the value of nnnn). You can modify the stem name with the STEM( ) parameter.

Variables

The variable IMFCNAME contains the MVS console name that was used to issue the command.

The variable IMFRC contains the return code given by the MVS MGCRE macro (which is used to issue the command). This return code is meaningful only the EXEC issues the MVS START command. Do not inspect this variable if you are not issuing the MVS START command.

When the EXEC issues the MVS START command and if IMFRC is zero, the variable IMFCASID contains the ASID (in decimal format) of the started address space and IMFCSTKN contains the STOKEN (16 hexadecimal characters).

Console names

BMC AMI Ops Automation activates a console named ssid0000 for all AOEXEC and IMFEXEC MVS commands that do not require a response. You can rename the ssid0000 console by specifying a new name with the CONSQUAL parameter in BPARM member BBISSP00.

BMC AMI OpsA activates additional consoles named ssidqqnn where the number nn can range in value from 1 to the value specified by the CONSOLES parameter in BBPARM member BBISSP00.

For example if CONSOLES=4 is specified, BMC AMI OpsA activates the following response consoles named:

• ssid0001
• ssid0002
• ssid0003
• ssid0004

Using the COUNT keyword

BMC AMI OpsA always activates the 'no response' console named ssid0000. By default, all commands that specify COUNT(0) are issued from the ssid0000 console.

When you issue commands with COUNT(greater than zero) or allow COUNT to use the default value of 1, BMC AMI OpsA selects any one of the available response consoles named ssidnnnn, issues the command from it, and inspects WTOs sent to this console for responses to your command.