INFORM-JOB

Send message to specific user task

Component:	BS2000
Functional area:	Operator terminal control
Domain:	JOB
Privileges:	OPERATING TSOS
Routing code:	E

Function

The INFORM-JOB command enables systems support to send a message to a specific batch or interactive job. The system adds the date and time of day to the message. The message is written to SYSOUT.

If the job has not yet been started (queue type 1) or has already terminated, the INFORM-JOB command will not be executed and the command submitter will be informed.

Note

The precise output format of the message is controlled by the NBMESLG system parameter.

Format

INFORM-JOB                                                                                                                                               

MSG = <c-string 1..151 with-low>
,JOB-IDENTIFICATION = *TSN (...) / *TERMINAL(...)
	*TSN (...)
		|	TSN = <alphanum-name 1..4>
	*TERMINAL(...)
		|	PROCESSOR = <name 1..8>
		|	,STATION = <name 1..8>

Operands

MSG = <c-string 1..151 with-low>
This operand represents the message to be transmitted.
Its maximum length is 151 characters. This length limitation does not apply to the date and time of day, which are added by the system.

JOB-IDENTIFICATION = *TSN(...) / *TERMINAL(...) 
Specifies where the message is to be sent. The message can be sent either to a job identified by its task sequence number (TSN) or to an interactive task identified by processor and station name.

JOB-IDENTIFICATION = *TSN(...)
The message is to be sent to a job identified by its TSN.

TSN = <alphanum-name 1..4> 
TSN (up to 4 alphanumeric characters) of the job to which the message is to be sent.

JOB-IDENTIFICATION = *TERMINAL(...)
The message is to be sent to an interactive task on a terminal.

PROCESSOR = <name 1..8> 
BCAM name of the processor to which the terminal is connected.

STATION = <name 1..8> 
BCAM name of the terminal to which the message is to be sent.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No errors
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	Not enough class 4 memory; command aborted

Example

Systems support input:

/inform-job msg = '*** Please release reserved tape devices?***' ,

           tsn = 0FC3

Output on terminal of interactive task 0FC3:

%MESS *** Please release reserved tape devices‘ *** :14:53:38 :12-01-26026