MPE/iX Intrinsics Reference Manual (32650-90875)

324 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPCIDELETEVAR
HPCIDELETEVAR
NM callable only.
Removes a valid variable name from the session-level variable table.
Syntax
CA I32
HPCIDELETEVAR(
varname , status );
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 HPCIDELETEVAR call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
encountered,
status is interpreted as:
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 represented by these bits
defines the subsystem that sets the status information. The subsystem
identifier for HPCIDELETEVAR is 166.
Related Information
Intrinsics HPCIPUTVAR, HPCIGETVAR
Commands SETVAR, DELETEVAR, SHOWVAR
Manuals Command Interpreter Access and Variables Programmer's Guide and
MPE/iX Commands Reference Manual