HP 3000 Manuals HP 3000 Manuals
NRJEErrMsg
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 appendix A, "Result Codes and
Messages," 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 appendix A, "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 Appendix A, "Result Codes and Messages," in the Installing and
Troubleshooting SNA NRJE manual or the SNA NRJE Node Manager's Guide, for
the messages you receive in Message.