Previous Topic: Access Process Definitions

Next Topic: Set Macro Parameters


How to Define a Process

From the Process List panel, press F4 (Add) to add a process definition. A Process Definition panel is displayed.

To define a process, first decide what you want the process to do, then break it down into steps, each step representing an action. Specify a macro for each step. A macro is an NCL procedure that performs the processing for that step. Authorized users can use the Register Macros option to register new macros.

Step processing can be conditional on the processing result of an earlier step. In the following example, STEP2 runs if STEP1 processing returns a code of 0. STEP3 runs if STEP1 processing returns a code greater than 0.

Condition StepName Step/RC Opr RC STEP1 STEP1 STEP2 STEP1 = 0 STEP3 STEP1 > 0

When you define a process on the Process Definition panel, complete the following fields:

If you want to find out what macros are available, enter ? in a Macro field to display the list of available macros.

Important! $NCL is the name of a special process definition. Do not use this name when you add process definitions.

Conditions are optional. Use relational operators in the Opr fields to set the conditions. Enter ? in an Opr field to identify the valid relational operators.

You can repeat and delete steps, and insert blank lines.

Press F11 (Right) to display the parameters for each step.

The return code from a process is the return code from the last executed process step.

Example: Issue Multiple System Commands

The following shows an example of a process that issues multiple system commands.

PROD----------- Automation Services : Process Definition ----------Function=Add Command ===> Scroll ===> PAGE + Process Definition ---------------------------------------------------------+ | System Name .. PROD Version .. 0001 Last Updated By | | Name ......... TEST PROC at on | | Description .. ISSUE SYSTEM COMMANDS | +-----------------------------------------------------------------------------+ + Process Steps --------------------------------------------------------------+ | | | D=Delete I=Insert P=Parms R=Repeat | | Condition | | StepName Step/RC Opr RC Macro Description | | STEP1 SYSCMD EXECUTE A COMMAND | | STEP2 STEP1 = 0 SYSCMD EXECUTE A COMMAND | | STEP3 STEP2 = 0 SYSCMD EXECUTE A COMMAND | | STEP4 STEP1 = 99 SYSCMD EXECUTE A COMMAND | | | | | | | | | | F1=Help F2=Split F3=File F4=Save | | F7=Bkwd F8=Forward F9=Swap F11=Right F12=Cancel | +-----------------------------------------------------------------------------+

If STEP1 completes successfully, STEP2 executes the next shutdown command. If STEP2 completes successfully, STEP3 issues the final shutdown command.

If STEP1 fails, STEP4 executes and issues a CANCEL command.