HP 3000 Manuals

SNA NRJE User/Programmer Reference Manual

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.

                  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.

Text Reference 

The WELCOME command also updates the NRJE subsystem welcome message.  See
the SNA NRJE Node Manager's Guide for more information on this command.

The NRJEWelcome intrinsic retrieves the text of the welcome message.  See
Chapter 5, "User Intrinsics."

MPE/iX 5.0 Documentation