SNA NRJE User/Programmer Reference Manual (30292-90006)

140 Chapter5
User Intrinsics
NRJEErrMsg
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 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