HPlogo LU 6.2 API Application Programmer's Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5  Intrinsic Descriptions

MCErrMsg

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Provides the message corresponding to a status info value that was returned in a previous intrinsic call.

Syntax

              I32V         CA             I16        I32
 MCErrMsg(OldStatus, MessageBuffer, MessageLength, Status);

Parameters

OldStatus

Required; 32-bit signed integer by value; input. The status info value for which a corresponding message is desired. This is a value that was returned in the Status parameter of a previous intrinsic call. MCErrMsg returns the message that corresponds to the value in this parameter.

MessageBuffer

Required; character array; output. A 256-byte character array in which the error message is returned.

MessageLength

Required; 16-bit signed integer; output. An integer representing the length, in bytes, of the message returned in MessageBuffer.

Status

Required; 32-bit signed integer; output. This status info value contains information about the execution of the MCErrMsg intrinsic. See the "Status Parameter" section, earlier in this chapter, for more information.

Description

The MCErrMsg intrinsic gives you the message that corresponds to the status info value you received in a previous intrinsic call. The MCErrMsg intrinsic obtains only local information; it will not return messages generated on the remote side.

MCErrMsg can be called from any conversation state, and it does not change the state of the conversation.

Status Info Values

 0     Successful Completion.
-1     Intrinsic called with parameter out of bounds.
-16    Unable to open catalog file.
-17    GENMESSAGE failed. (MPE V)
-17    CATREAD failed. (MPE XL)
-20    Not enough stack space for intrinsic to run.
-28    Invalid 'OldStatus' passed to error message intrinsic.
-90    An internal error in Presentation Services has occurred.
-91    An internal error in the APPC subsystem has occurred.
-1002  An internal error at the mapped conversation level has occurred.
-1003  Required parameter missing.
Feedback to webmaster