MESSAGE

Send message to specific user task

Component:	BS2000
Functional area:	not allocated
Domain:	not allocated
Privileges:	OPERATING
Routing code:	E

The MESSAGE command is being replaced by the INFORM-JOB command. MESSAGE continues to be supported to ensure backwards compatibility, but INFORM-JOB should be used for new applications. All that follows is a brief overview of the command’s function, syntax and return codes.

Function

The MESSAGE command enables the operator to send a message to a specific batch or interactive job. The system adds the date and time of day to the operator message. The message is written to SYSOUT.

If the job has already terminated, or has not yet been started, the MESSAGE command will not be executed and the operator will be informed.  

Restrictions

The command is available in ISP format only; in other words, there are no SDF functions (such as syntax analysis or help).
The format has been subdivided into two subformats:

• Format 1: Send message to terminal

• Format 2: Send message to batch or interactive task

   
Note

The precise output format of the message is controlled by the NBMESLG system parameter (applies to both syntax formats).

Format 1

MESSAGE	Alias: MSG
TERM = (<processor 1..8>,<station 1..8>) ,<text 1..151>

Format 2

MESSAGE	Alias: MSG
TSN = <alphanum-name 1..4> ,<text 1..151>

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	EXC0064	Warning. Specified task has temporarily suppressed message function
1	1	EXC0240	Syntax error
2	64	EXC0080	Specified task does not exist
3	64	EXC0062	Specified task cannot receive message
4	64	EXC0081	Invalid task type
5	64	EXC0109	Semantic error; command ignored
	130	EXC0061	Insufficient class 4 memory; command aborted

Example

Operator input:

/MES TSN=0FC3, PLEASE CALL OPERATOR

Output on terminal of interactive task 0FC3:

%MESS PLEASE CALL OPERATOR :16:23:38 :12-01-26026