HP 3000 Manuals

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