System Debug Reference Manual (32650-90888)

Chapter 10 369
System Debug Standard Functions
func cisetvar
%cmdebug > wl btow (40002)
%120001
These examples assume the current CM registers displayed above. Note the huge DL area.
Limitations, Restrictions
none
func cisetvar
Sets a new value for the specified CI (MPE XL Command Interpreter) variable.
Syntax
cisetvar (
civarname newvalue
)
This function is implemented by calling the HPCIPUTVAR intrinsic. String variables are
stored as strings. They are not interpreted numerically.
Formal Declaration
cisetvar:bool (
civarname
:str
newvalue
:any)
Parameters
civarname
The name of the CI variable to be assigned a new value.
newvalue
The new value to be assigned to the specified CI variable.
Examples
$nmdebug > wl cisetvar ("testvar", #123);
TRUE
Assign the value decimal 123 to the CI variable named testvar. The result, TRUE, implies
that the assignment was successful.
$nmdebug > wl civar ("testvar"):"d"
123
$nmdebug > :showvar testvar
TESTVAR = 123
Confirm that the value was set by retrieving the value using the CIVAR function and by
executing a CI command to display the variable's value.
Limitations, Restrictions
none