SEND-MSG

Nachricht an Konsole oder Programm (STXIT-Routine) senden

Komponente:	BS2000
Funktionsbereich:	keine Zuordnung
Anwendungsbereich:	JOB PROGRAM
Privilegierung:	STD-PROCESSING OPERATING TSOS HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION
Berechtigungsschlüssel:	P

Das Kommando SEND-MSG wird durch die Kommandos INFORM-OPERATOR und INFORM-PROGRAM ersetzt. SEND-MSG wird noch kompatibel unterstützt. Für Neuanwendungen sollten jedoch die neuen Kommandos verwendet werden. Nachfolgend sind nur noch eine kurze Funktionsbeschreibung, Funktionsübersicht, das Syntaxformat und Kommando-Returncodes enthalten.

Funktionsbeschreibung

Mit dem Kommando SEND-MSG kann eine Nachricht an die Konsole, an ein unterbrochenes Programm der eigenen Dialog-Task oder -als privilegierte Funktion- an ein Programm einer Nicht-Dialog-Task gesendet werden.

Konsole (Operand TO=*OPERATOR):

Diese Funktion wird durch das Kommando INFORM-OPERATOR angeboten.

Programm (Operand TO=*PROGRAM):

Diese Funktion wird durch das Kommando INFORM-PROGRAM angeboten (JOB-IDENTIFICATION=*OWN).

Nachricht an ein Programm einer Nicht-Dialog-Task (Privilegierte Funktion):

Diese Funktion wird durch das Kommando INFORM-PROGRAM angeboten (JOB-IDENTIFICATION=*TSN(...) bzw. *MONJV(...)).

 

Format

SEND-MSG                                                                                                                                                   

TO = *OPERATOR (...) / *PROGRAM(...)
	*OPERATOR(...)
		|	WAIT-RESPONSE = *NO / *YES
	*PROGRAM(...)
		|	JOB-IDENTIFICATION = *OWN / *TSN(...) / *MONJV(...)
		|		*TSN(...)
		|			|	TSN = <alphanum-name 1..4>
		|		*MONJV(...)
		|			|	MONJV = <filename 1..54 without-gen>
,MSG = *NO / <c-string 1..230 with-low>

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Ohne Fehler
1	0	CMD0001	Es ist keine Aktion notwendig, da bei Angabe von MSG=*NO keine Nachricht an den Operator zu senden ist
1	1	NBR0950	Die Angabe TO=*OPERATOR kann nicht von einer Konsole eingegeben werden
	64	EXC0920	Angegebene JOB-ID ungültig
	64	EXC0921	Kommando für eine Dialog-Task nicht zulässig
	64	EXC0922	Kein Programm geladen
	64	EXC0923	Im angegebenen Programm keine STXIT-Schnittstelle für dieses Ereignis definiert
	64	EXC0924	Im angegebenen Programm keine STXIT-Routine für dieses Ereignis definiert
	64	EXC0925	STXIT-Routine bereits aktiviert
	64	EXC0090	Speicherplatzmangel