Command Processing

SA z/OS displays the Command Processing panel (Figure 1) if you enter the action code CMD in the Cmd column on the Message Processing panel.

Use this panel to enter commands that are executed when the application issues the specified message. If you specify one of the automation commands that are provided by SA z/OS (see IBM System Automation for z/OS Operator's Commands), they should be queued using the NetView CMD LOW command. This ensures that task global variables that are in use by the calling automation procedure are not changed by the calling command.

For a list of runtime variables that can be substituted into each command prior to execution, see ACFCMD in IBM System Automation for z/OS Programmer's Reference.

For a full description of using line commands, refer to Line Commands on Message Processing Panels in How to View Long Input Fields in Full Length.

The value that you enter in the Ps/Select field defines when the command or reply should be issued, as follows:

Mixed case

Specify whether the value entered in the Command Text field remains unchanged (YES) or is translated to upper case characters automatically (NO).

Ps/Select

Enter a number from 1 through 99 or an asterisk (*) in this field to specify a pass value. During the automation control file build, this value is prefixed with PASS to create the selection criterion for the command and reply entry.

For more information about pass processing see the description of the PASSES parameter for the ISSUEACT generic routine in IBM System Automation for z/OS Programmer's Reference.

An expression other than a pass value is considered a selection value and is not altered during the build process. A selection value can be a blank or any name that does not begin with a number or contain imbedded blanks, commas, quotes, or parentheses.

Note: For commands issued by SA z/OS during startup or shutdown, an attempt is made to issue only the commands that are relevant to the particular start or stop type. SA z/OS looks for command definitions with a selection field that matches the start or stop type. Commands that are defined without a selection value are issued or selected for each start or stop type. Where appropriate, the AAO AOFSTATUSCMDSEL is taken into consideration.

AutoFn/*

Enter the name of the automated function that the command is to run under. The AT entry that is generated does not reflect the automated function that you enter, however the execution of the command is routed internally to the automated function that you specify. If you leave the field blank, the function defaults to the one currently running the command list. SA z/OS automated functions are mapped to NetView automation operators.

Entering * enables return-code checking for the specified command. This means that processing continues if the command returns a return code of 0. In all other cases processing is stopped immediately. If you are running in LOG assist mode, return code checking has no effect because the commands are not executed.

Command Text

Enter the command or command list to be issued. You must preface a system command with MVS™.

Pass or selection values can be repeated for several text entries. Each set of entries with the same pass or selection value forms a command group.

To process this message, an entry in the NetView automation table is generated that uses the ISSUEACT generic routine. For more details, see ISSUEACT in IBM System Automation for z/OS Programmer's Reference.

IF (GROUP:INGCICS) MSGID = 'DFHAC2236'         
& ATF('ING$QRY APPL') ¬= '' THEN              
EXEC(CMD('EVEERTRN') ROUTE(ONE %AOFOPGSSOPER%));

IF (GROUP:INGCICS) MSGID = 'DFHAC2236'           
& ATF('ING$QRY APPL') ¬= '' THEN                 
EXEC(CMD('EVEERTRN') ROUTE(ONE %AOFOPGSSOPER%))  
EXEC(CMD('ISSUEACT') ROUTE(ONE %AOFOPGSSOPER%));