!
!	Program:  SEND -  message sending utility between terminals
!
!	The send routine is made up of a fortran program that sends
! messages to other terminals by port name, user name, or process id.
!
!	The utility uses the command line interpreter (CLI) to
! parse and return the parameters and qualifiers on the command line.
!
!	It also uses GETJPI and BRDCST system services and is a handy
! reference on implementing those functions.
!
!			Dave Cook
!		Ball Aerospace Systems Division
!			3-Sept-82
!
1 SEND

	The SEND utility enables a user to send a message to
	another user who is currently logged in. This utility
	is most useful for users who do not have a VT-100 type
	terminal since it is simply a message broadcaster, not
	a screen mode conversational system. It has the follow-
	ing form:

	SEND [/qualifiers] [Destination] ["Message"]

2 /BELL

	BELL/[NO]BELL

	This qualifier allows you to supress the bell alerting
	the other user of your message. Default is BELL.

2 /DIALOG

	DIALOG/[NO]DIALOG

	This qualifier allows you to go into continuous dialog
	mode with the remote terminal. Default is NODIALOG.

	Use a CTRL Z to get out of dialog mode.

2 /IDENTIFICATION

	IDENTIFICATION = Process ID

	This qualifier allows you to specify the remote user
	by process ID, rather than terminal name or user name.
	Process ID specification overrides terminal or user
	name specification.

	Default is NOIDENTIFICATION.

2 Parameters		

	The SEND utility has the following forms:

	SEND [/qualifiers] [Destination] ["Message"]

	SEND/ID=process_ID [/other_qualifiers] ["Message"]

3 Terminal

	The destination terminal may be expilicitly identified
	by either logical or physical device name such as TTA5:
	or OPA0:.

3 Username

	The destination user may be specified by username such
	as SYSMGR, OPERATOR, or RAUL. The current processes on
	the system are scanned for a username match and the
	terminal name of the first one found is substitued
	for the destination specification.

	Therefore, if the destination user is logged onto the
	system from more than one terminal, it would be wise
	to specify the terminal expilicitly, rather than by
	username.

3 Message

	If the message is included on the initial command line,
	it must be inclosed by quote's ("). Once you are in
	SEND either in dialog, continuation, or prompt mode,
	the quotes are not required.

	Note that if you use the /IDENTIFICATION qualifier,
	the terminal specification is overridden and the
	second parameter on the command line becomes the
	message specification.

2 Destination

	The destination parameter may be specified either by
	terminal name, user name, or process identification
	number. Note that using the process ID qualifier
	overrides the terminal or user name specification
	parameter. Refer also to HELP SEND PARAMETERS.

3 Terminal

	The destination terminal may be expilicitly identified
	by either logical or physical device name such as TTA5:
	or OPA0:.

3 Username

	The destination user may be specified by username such
	as SYSMGR, OPERATOR, or RAUL. The current processes on
	the system are scanned for a username match and the
	terminal name of the first one found is substitued
	for the destination specification.

	Therefore, if the destination user is logged onto the
	system from more than one terminal, it would be wise
	to specify the terminal expilicitly, rather than by
	username.

2 Message

	If the message is included on the initial command line,
	it must be inclosed by quote's ("). Once you are in
	SEND either in dialog, continuation, or prompt mode,
	the quotes are not required.

	Note that if you use the /IDENTIFICATION qualifier,
	the terminal specification is overridden and the
	second parameter on the command line becomes the
	message specification.

3 Continuation

	If the user ends his command line with a "+",
	the utility will send the first line to the
	specified terminal and then request another
	line of message from the user.

3 Conversation	

	If the user ends his command line with a "*",
	his terminal will be placed in dialog mode to
	the specified terminal.

	This enables a dialog between two terminals
	(both terminals must be running SEND).
	Use a CTRL Z to get out of dialog mode.

2 Examples

	Here are a few of the forms which can be used
	to initiate a SEND message:

	SEND TTA5: "Hello Bill..."

	SEND BILL "Hello again."

	SEND/NOBELL BILL
	Message: Hello again.

	SEND/ID=00A50037 "Hello again."

	SEND
	To: TTA5:
	Message: Hello Bill+
	Message: Hello again.

	SEND/DIALOG BILL "Hello again."
	Terminal in dialog mode to TTA5: use ^ Z to exit.
	Message: I am quitting now.
	Message: ^Z

