Previous Topic: SESSION KeywordNext Topic: XCCMD Keyword


SET Keyword

The SET keyword creates and assigns a value to a status variable. You can also use the SET keyword to delete a status variable or update its value. You can use the SET keyword more than once in a rule.

This keyword has the following format:

SET(&varname=text)
&varname

Specifies the name of the status variable, which can contain up to 32 characters. An ampersand (&) must always precede the variable name.

text

Specifies the text string you want to assign to the status variable. A text string can contain characters, environmental variables, or other status variables. If the value of text is null, CA Automation Point deletes the status variable that you are trying to set. The maximum length of text is 256 characters (after expanding all variables).

Usage Note:

Storing values in status variables uses up memory. Therefore, if a rule references a variable only once or a few times and never uses that variable again, set the variable to null after the rule using it executes. Leave only frequently-used variables in memory.

Example:

The following rule creates a status variable called &JOB_START_TIME with the same value as the &HOSTTIME environmental variable:

MSGID(IEF490I), SET(&JOB_START_TIME=&HOSTTIME)