ADDRESS AXC Commands › Commands for Automation Tasks › SETVAR Command

SETVAR Command

The SETVAR command sets the contents of a CA Automation Point status variable to a given value, changes the value of a variable, or creates a new variable.

This command has the following format:

"SETVAR varname (value)"

varname

Specifies the name of the CA Automation Point variable to set.

value

Specifies the value to be assigned to the variable.

Usage Notes:

• SETVAR status variable names are case-sensitive in CA Automation Point. Use uppercase variable names consistently.
• When designing REXX programs that use the SETVAR command, split long data lines for storage in multiple status variables. The maximum length of a SETVAR command is 241 characters, after substituting values for & variables. If you exceed the 241-character limit, CA Automation Point truncates the extra characters and reports a return code.

Example:

Suppose that REXX is operating without errors and you want to create a CA Automation Point variable called REXX_STATUS with a value indicating the status of REXX processing. To do so, write this statement in your REXX program:

"SETVAR REXX_STATUS (NO ERRORS)"

When the SETVAR command executes, the value of the REXX_STATUS variable is set to NO ERRORS.