Implementing Processes › How to Define a Process › Set Macro Parameters

Set Macro Parameters

When you select a macro, it contains either no parameters or default parameters.

To set the parameters for a macro

1. Enter P next to the process step.

   A Macro Parameter Definition panel appears.

2. Change the parameters as required and press F3 (OK). The parameters required by each macro depend on the purpose of the macro.

Example: Set Macro Parameters

The following shows the parameters set for Step 1 in the previous example.

 PROD----- Automation Services : SYSCMD Macro Parameter Definition -------------
 Command ===>                                                    Function=UPDATE

 +- System Command ------------------------------------------------------------+
 |                                                                             |
 | Command ..... F CA7T,/LOGON MASTER_________________________________________ |
 |                                                                             |
 | Jobname ..... ________                                                      |
 |                                                                             |
 | Wait Time ... 30__  Wait Time Expiry Return Code ... 99_                    |
 +-----------------------------------------------------------------------------+
 +- Response Message Analysis -------------------------------------------------+
 |                                 D=Delete Extended Filter  S=Extended Filter |
 |           Message Text                                      Return Extended |
 |                                                             Code   Filter?  |
 |   ___     CA-7.023 - V3.0 (9106) OPERATOR IS LOGGED ON_     0__    NO       |
 |   ___     _____________________________________________     ___             |
 |   ___     _____________________________________________     ___             |
 |   ___     _____________________________________________     ___             |
 |   ___     _____________________________________________     ___             |
 |                                                                             |
 +-----------------------------------------------------------------------------+
  F1=Help      F2=Split     F3=OK
                            F9=Swap                               F12=Cancel

The parameters include:

• The system command issued
• The text of the expected response
• A processing return code of 0
• A wait time of 30 seconds
• A time-out return code of 99

You can also specify an extended filter for the analysis of the response message text. For example, a response can contain variable information and you want to accept the message only if it contains specific values.

Variable as a Macro Parameter

You can use a variable to hold the value of a macro parameter. You pass the value of any variables required by a process as parameters when you specify the process, for example, in a resource definition.

Important! Do not specify variable names that start with #, $, or Z.

Example: Use a Variable as a Macro Parameter

You have defined a process that contains the SYSCMD macro which issues the $DU,&PRT command. When you use the process, you supply the value of the &PRT variable by specifying the following parameter: PRT=printer-name. Specify the name of the variable only (without the &).