MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 7 325
Command Definitions (HP32208-HPLOACNMPROC)
HPCIGETVAR
HPCIGETVAR
NM callable only.
Retrieves a valid variable name from the session-level variable table and returns the
current value and/or attributes.
Syntax
CA I32 U32V *
HPCIGETVAR(
varname , status [, itemnum,item ] [...])
NOTE You can specify up to six itemnum / item pairs.
Parameters
varname character array (required)
Passes the name of a session-level variable whose value is to be retrieved.
The name must begin with either an alphabetic character or the
underscore character. It must consist of alphanumeric or underscore
characters. The name is delimited by a nonalphanumeric, nonunderscore
character, and can be up to 255 characters long. The name is not
case-sensitive.
status 32-bit signed integer by reference (optional)
Returns the status of the HPCIGETVAR call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represents the subsystem
that set the status information. The subsystem identifier for HPCIGETVAR
is 166.
itemnum 32-bit unsigned integer by value (optional)
Passes a number indicating the
item , refer to Table 7-5., “HPCIGETVAR
Itemnum/Item Values,” on page 326.
item type varies (optional)
Returns variable information as specified in
itemnum , refer to Table 7-5.,
“HPCIGETVAR Itemnum/Item Values,” on page 326.