HPlogo SNA NRJE User/Programmer Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 6 NRJE Manager Intrinsics

NRJEUpdWel
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

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.

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”



NRJETrace
  		 


Chapter 7 MPE Support Utilities and Commands  
Feedback to webmaster