HPlogo SNA NRJE User/Programmer Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5 User Intrinsics

NRJEErrMsg

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Obtains and writes an NRJE error message string.

Syntax

                IA      I       BA       I       I    
NRJEErrMsg ( Error, FileNum, Message, OutLen, Result )

Parameters

Error

An input integer array. The Error array is the result of another NRJE intrinsic call for which ASCII text is desired.

The structure of the Error array is the same as the Result array. See "Parameters Common to NRJE Intrinsics" in the introduction to this chapter.

FileNum

An input integer variable. The FileNum parameter identifies a file to which you want the contents of the Message parameter written.

Obtain the value for the FileNum parameter by calling the FOPEN intrinsic.

If the value of FileNum is zero, no output takes place; however, information is returned in the Message parameter.

Message

An output byte array. The Message array contains one or more messages associated with the Error array.

The Message array must be 370 bytes long. Multiple line error messages are separated by ASCII carriage return and line feed characters.

Messages are listed and described in the Installing and Troubleshooting SNA NRJE manual or the SNA NRJE Node Manager's Guide.

OutLen

An output integer. The OutLen parameter contains the total number of all characters in the Message array.

Result

An output integer variable. The Result parameter contains error codes that occurred during execution of this intrinsic.

The Result parameter is set to zero if no errors took place. Always test Result immediately after you call this intrinsic. If Result is not zero, a problem has occurred. See "Result Codes and Messages," in the Installing and Troubleshooting SNA NRJE manual or the SNA NRJE Node Manager's Guide.

Description

Use NRJEErrMsg to obtain and write messages that correspond with Result arrays of calls to other NRJE intrinsics. Information associated with Error is returned in Message. Find out the actual size of Message from OutLen. Set FileNum=0 if you want to prevent NRJEErrMsg from writing the contents of Message. After NRJEErrMsg has returned control to your program, test the first element of Result.

Text Reference

See the Installing and Troubleshooting SNA NRJE manual or the SNA NRJE Node Manager's Guide, for the messages you receive in Message.

Feedback to webmaster