HPlogo MPE/iX Intrinsics Reference Manual > Chapter 5 Command Definitions (FCONTROL - FLOCK)

FERRMSG

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Returns a message corresponding to an FCHECK error number and enables error messages to be displayed from a program.

Syntax



           I16          CA         I16
  FERRMSG (fserrorcode, msgbuffer, msglength);

Parameters


fserrorcode

16-bit signed integer by reference (required)

Passes an error code returned by the FCHECK intrinsic indicating which message to return in msgbuffer.

msgbuffer

character array (required)

Returns the error message identified with fserrorcode. To contain the longest possible message, msgbuffer must be >= 72 bytes long.

msglength

16-bit signed integer by reference (required)

Returns the length of the error message in msgbuffer. The length is returned in positive bytes.

Condition Codes


CCE (2)Request granted.
CCG (0)Request denied. No error message exists for this fserrorcode.
CCL (1)Request denied. The msgbuffer address was out of bounds, msgbuffer was not large enough, or msglength was out of bounds.

Related Information


Intrinsics FCHECK, PRINTFILEINFO
Manuals Accessing Files Programmer's Guide




FDEVICECONTROL


FFILEINFO