HP 3000 Manuals HP 3000 Manuals
NRJEWelcome
Obtains the contents of the NRJE welcome message.
Syntax
__________________________________________________
| |
| |
| I I BA IA |
| NRJEWelcome ( MaxLen, ActLen, Msg, Result )|
| |
__________________________________________________
Parameters
MaxLen An input integer variable. The MaxLen parameter specifies the
maximum text length that can be returned in Msg.
The maximum length of the NRJE welcome message is 1912 characters.
(This includes the carriage return and the line feed.)
ActLen An output integer variable. The ActLen parameter contains the actual
number of characters of the NRJE welcome message returned to you in
the Msg array.
Msg An output byte array. The Msg array contains the text of the NRJE
welcome message.
Result An eight-element integer output array (required). The Result array
contains error codes that occurred during execution of this
intrinsic.
The first element of the Result array is set to zero if no errors
took place. The structure of the Result array is described in
"Parameters Common to NRJE Intrinsics" in the introduction to this
chapter.
Always test the first element of Result immediately after you call
this intrinsic. If the first element of Result is not zero, test the
other elements of Result to determine the nature of the problem that
has occurred.
Description
NRJEWelcome is used to obtain the text of an NRJE welcome message. You
must provide an array large enough to hold all of the welcome message
text. Specify the message array size when you call NRJEWelcome. NRJE
can accept lines up to 80 characters long and adds a carriage return and
a line feed at the end of each line. The maximum total number of
characters that can be included in the welcome file is 1912. The actual
message length is returned by the intrinsic. When NRJEWelcome returns
control to your program, you should test Result.
Text Reference
NRJE welcome messages are output immediately after the product
identification banner when the subsystem command interface is used.