MPE/iX Intrinsics Reference Manual (32650-90875)

328 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPCIPUTVAR
HPCIPUTVAR
NM callable only.
Sets the value of a session-level variable.
Syntax
CA I32 U32V *
HPCIPUTVAR(
varname , status [, itemnum,item ] [...])
NOTE Up to three itemnum/item pairs can be specified.
Parameters
varname character array (required)
Passes the name of a session-level variable for which the value needs to be
set. This name must begin with either an alphabetic character or the
underscore character and consists of alphanumeric or underscore
characters. The name is delimited by a nonalphanumeric, nonunderscore
character, and must be <= 255 characters long. The name is not
case-sensitive.
NOTE It is not a good practice to define CI variables with the same names as JCW's
(job control words). Defining CI variables with the same names as JCW's may
cause unpredictable results.
status 32-bit signed integer by reference (required)
Returns the status of the HPCIPUTVAR 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 HPCIPUTVAR
is 166.
itemnum 32-bit unsigned integer by value (optional)
Passes an item number indicating the
item . Refer to Table 7-6.,
“HPCIPUTVAR Itemnum/Item Values,” on page 329.
item type varies by reference (optional)