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

208 Chapter6
NRJE Manager Intrinsics
NRJEUpdWel
NRJEUpdWel
Updates the NRJE subsystem welcome message.
Syntax
BA I IA
NRJEUpdWel ( Message , MessageLen , Result )
Parameters
Message An input byte array. The Message parameter
contains the message to be broadcast to any NRJE
subsystem command interpreter user. The maximum
Message length is 1920 characters.
Separate each line of text by a carriage return
character and a line feed character. A carriage return is
%15, or !0D; a line feed is %12, or !0A.
MessageLen An input integer. The MessageLen parameter
contains the length of the text in the
Message array.
The maximum
MessageLen value is 1920 characters.
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 Chapter 5 , “User Intrinsics.”
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
Use the NRJEUpdWel intrinsic to revise the whole NRJE subsystem
welcome message. The welcome message is broadcast every time any
user or manager enters the subsystem; however, it is not broadcast
when any user invokes the NRJE subsystem command to change from
one default workstation to another.
The text of the welcome message is input in
Message . The length of the
welcome message text is input in
MessageLen . After NRJEUpdWel
returns control to your program, test the first element of
Result .