Syntax
$RECALL |
SERVICE=SET CLASS=VARIABLE NAME='VARNAME=variable-name' PARMS='VALUE=new-value' [DESC=value-description] |
Use
Use this API to set the value of an EventView variable.
Operands
|
Operand |
Description |
|---|---|
|
SERVICE=SET |
A value is to be set. |
|
CLASS=VARIABLE |
The value to be set is an EventView variable. |
|
NAME='VARNAME=variable-name' |
Identifies the EventView variable. variable-name can be up to eight characters long. |
|
PARMS='VALUE=new-value' |
The new value to be set for the specified variable. |
|
DESC=value-description |
Optional entry to describe the variable value. |
Returned Variable
|
Variable |
Description |
|---|---|
|
&SYSMSG |
Contains the message returned by $RECALL. |
Return Codes
The following return codes indicate the success or failure of command processing:
|
&RETCODE |
Meaning |
|---|---|
|
0 |
Processing was successful. |
|
8 |
Processing failed. |
|
16 |
Error occurred in call syntax. |
Example
The following example sets the value of TEST:
&VALUE = &ZQUOTE Test's value at &TIME &DESC = &ZQUOTE Why Test was changed &PARMS = &ZQUOTE VALUE=&VALUE DESC=&DESC &CALL PROC=$RECALL + PARMS=(SERVICE=SET,+ CLASS=VARIABLE,+ NAME='VARNAME=TEST',+ PARMS=&PARMS)