HPCIDELETEVAR

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