HP C/iX Library Reference Manual (30026-90004)

34 Chapter4

HP C/iX Library Header Descriptions

Header File Contents

second 16 bits contain the subsystem number. The errno.h> header ﬁle lists

the symbolic names used for intrinsics and gives a type deﬁnition for

_mpe_status(t_mpe_status).

The following is a list of the _mpe_intrinsic symbolic names and their

values.

I_CREATEPROCESS (1) CREATEPROCESS system intrinsic

I_FCLOSE (3) FCLOSE system intrinsic

I_FCONTROL (4) FCONTROL system intrinsic

I_FFILEINFO (5) FFILEINFO system intrinsic

I_FPOINT (7) FPOINT system intrinsic

I_FREAD (8) FREAD system intrinsic

I_FRENAME (9) FRENAME system intrinsic

I_FWRITE (10) FWRITE system intrinsic

I_HPCIGETVAR (11) HPCIGETVAR system intrinsic

I_HPFOPEN (14) HPFOPEN system intrinsic

I_PRINT (15) PRINT system intrinsic

P_HEAP (16) PASCAL HEAP manager

The three global variables, _mpe_intrinsic, _mpe_errno, and

_mpe_status, are set only when an error occurs and only when errno is

set to ESYSERR. These variables are not cleared on a successful intrinsic

call. The _mpe_status variable is provided to give you direct access to the

error text of a failing intrinsic. You can obtain this information by calling

the intrinsic HPERRMSG with _mpe_status.word as the input. The

HPERRMSG intrinsic can write the error message to the screen or to a buffer.

NOTE

When a P_HEAP error occurs, the value of _mpe_status does not return a

valid error text when used as input to HPERRMSG because the PASCAL

HEAP error messages are not in the system catalog. The

_mpe_status.decode.subsys_num variable is set to the Pascal subsystem

number, and _mpe_status.decode.error_num is the error number returned

by the failing HEAP routine.

Example

#pragma intrinsic HPERRMSG

#include <errno.h>

/*****************************************************************/

/* These are the definitions included from errno.h: */

struct _status_word {

short error_num; /* error number */