HPCIDELETEVAR [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation
MPE/iX Intrinsics Reference Manual
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
(32650-90066, 32650-90152, and 32650-90368) 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 (32650-90011) and MPE/iX
Commands Reference Manual Volumes 1 and 2
(32650-90003 and 32650-90364)
MPE/iX 5.0 Documentation