HP 3000 Manuals

System Debug Reference Manual

func civar 

Returns the current value of a CI (MPE XL Command Interpreter) variable.

Syntax 

      civar (civarname [stropt])

This function is implemented by calling the HPCIGETVAR intrinsic.

Formal Declaration 

      civar:any (civarname:str [stropt:str="NOEV"])

Parameters 

 civarname       The name of the CI variable.

 stropt          A string that determines whether the CI should attempt
                 to evaluate the named variable.

                 EVALUATE         Evaluate the CI variable
                 NOEVALUATE       Do not evaluate the CI variable
                                  (Default)

                 This string parameter can be abbreviated.

Examples 

     $nmdebug > wl civar ("hpgroup"); 
     DEMO

     $nmdebug > wl civar ("hpaccount"); 
     TELESUP

Display the current value of the CI variables named HPGROUP and
HPACCOUNT.

     $nmdebug > wl civar( "hpusercapf" ) 
     SM,AM,AL,GL,DI,OP,CU,UV,LG,PS,NA,NM,CS,ND,SF,BA,IA,PM,MR,DS,PH

Display the current value of the CI variable HPUSERCAPF.

     $nmdat > :showvar one 
     ONE = !TWO
     $nmdat > :showvar two 
     TWO = 2

     $nmdat > wl civar("one") 
     !TWO
     $nmdat > wl civar("one" "EVAL") 
     2

Two CI variables have already been defined.  Variable one references
variable two which is assigned the value of 2.

The first use of the function CIVAR defaults to NOEVALUATE, and as a
result the value of one is returned as !TWO.

In the second use of the function CIVAR, the stropt is explicitly
specified as EVALUATE, and so the MPE XL CI evaluates the value of one,
which indirectly references the variable two, and the final result of 2
is returned.

Limitations, Restrictions 

none

MPE/iX 5.0 Documentation