!
!	Alan L. Zirkle	  Naval Surface Warfare Center
!			  Code K53
!	(703) 663-8023	  Dahlgren, Virginia  22448
!
!	
1 NOTIFY
!
Command for sending a message:

    *  From a batch job to your terminal (Format 1)
    *  From an interactive command procedure to your terminal (Format 1)
    *  To a system manager's or operator's terminal (Formats 2 and 3)

Formats:

    1.  NOTIFY "message"
    2.  NOTIFY /OPERATORS "message"
    3.  NOTIFY /USER=username "message"
    4.  NOTIFY /SOS=category "mesage"
!
2 Message
!
The message to be sent must must be enclosed in quotation marks.

Example:
          $ NOTIFY "This is the message"

When the message is displayed on the screen, it is in bold reverse vid-
eo, and the terminal's bell is rung four times.

When format 1 is used, the message is truncated to 80 characters.  When
other formats are used,  your username is added to the message, and the
actual message is truncated to  ( 72 - U )  characters,  where U is the
length of your username.
!
2 /QUIET
!
If the qualifier /QUIET is used on any of the NOTIFY formats, then the
ringing of the terminal's bell is not done.

Example:
          $ NOTIFY /QUIET "This is the message"
!
2 Format_1
!
When used in a batch job,  this format prints the message  in the batch
log,  and also sends  the message  to all terminals  at which the batch
job's submitter is logged in.

When used in an interactive command procedure, the message is displayed
on the terminal  running the procedure.  The message  is shown  in bold
reverse video and the bell is rung four times.

Example:
          $ NOTIFY "The XXX Procedure Aborted"
!
2 Formats_2_3_4
!
Format 2 sends a message to all SGS Operators who are currently logged
in.   These messages should be kept to a minimum, and only used in im-
portant situations.

Example:
          $ NOTIFY /OPERATORS "Message"

Format 3  sends a message  to the specified user,  if the user is cur-
rently logged in.   The only users  to whom you can send messages  are
the SGS System Managers and Operators.   It is strongly requested that
this format only be used in emergencies.

Example:
          $ NOTIFY /USER=JAY "Message"

Format 4 sends a message to those users who are logged in and who are
registered as being  responsible for resolving SOS problem reports of
the specified category.  If the category is misspelled, no message is
sent and no diagnostic is issued.  This is designed to be used by SOS
procedures, and should not be used otherwise.

Example:
          $ NOTIFY /SOS=HARDWARE "Message"
!
2 Restricted_formats
!
There are other formats of NOTIFY which can only be used by those users
who have OPER privilege.

Formats:

    3.  NOTIFY /USER=username "message"  (to any logged-in user)
	NOTIFY /USERS=(us1,us2,...) "message"

    4.  NOTIFY /TERMINAL=termname "message"
	NOTIFY /TERMINALS=(tn1,tn2,...) "message"

    5.  NOTIFY /ALL "message"

These three formats can also use the qualifier /URGENT or /SHUTDOWN.
!
3 Format_3
!
If you have OPER privilege, you can send send a message to any logged-
in user or set of users.

Examples:

          $ NOTIFY /USER=SULU "Ahead Warp Factor 7"

          $ NOTIFY /USERS=(USERA,USERB) "Message"

The parentheses are required if more than one username is specified.
!
3 Format_4
!
This format sends a message to the specified terminal(s), even if there
is nobody logged in there.  You cannot use this format unless you have
OPER privilege.

Examples:

          $ NOTIFY /TERMINAL=TTA0 "Message"

          $ NOTIFY /TERM=(TTA0,TTB2) "Message"

The parentheses are required if more than one terminal is specified.  A
leading underscore or trailing colon is optional in terminal names.
!
3 Format_5
!
This format sends a message to all terminals connected to the system,
whether anyone is logged in on them or not.  You cannot use this format
unless you have OPER privilege.

Example:

          $ NOTIFY /ALL "Going down in 5 minutes"
!
2 /VERSION
!
When this qualifier is used, NOTIFY displays its current version number,
and does not perform any other function.
!
