Running in a Batch Environment › Submitting a Batch Job Stream › Using CA Ideal Commands in Batch

Using CA Ideal Commands in Batch

The first CA Ideal command required in any job stream is the SIGNON command. If your site uses an external security system to control access to CA Ideal, do not include this command.

This command is followed by any sequence of CA Ideal commands. If an error is encountered while executing one of the commands, the transaction containing the error is ended and the next command is executed.

Note: If the SET OUTPUT DESTINATION statement is included in either the signon member or the batch input statements, the destination specified in the SET OUTPUT command overrides the usual batch output destination of AUXPRINT.

The command OFF must be the last command entered. You can use the following set of IF, ELSE, ENDIF commands in the job stream to execute subsets of commands in the job stream based on the value of the return code.

The commands appear in the following syntax:

                  {GE}
                  {GT}
                  {LE}
IF [$RETURN‑CODE] {LT}   nnn
   [$RC         ] {EQ}
                  {NE}

    CA Ideal commands

ELSE

    [CA Ideal commands  ]

ENDIF

The value nnn is tested against the current return code using the specified relational operator. The relational operator must be in the form shown above and is required.

The ELSE clause is optional. If the condition evaluates True, all commands are executed until the ELSE or ENDIF command is encountered, and all commands after ELSE are bypassed. If the condition is False, no commands are executed until either an ELSE or an ENDIF is encountered.

You cannot nest the IF‑ELSE‑ENDIF command series in other sets of IF‑ELSE‑ENDIF commands.

You can use the SET $RETURN‑CODE command in the job stream to override the condition codes set by previous commands in the session.

For commands other than RUN (which can set any value for $RC), the following table shows how $RC values are associated with warning or error messages.