HELP-MSG-INFORMATION

Display text of system message

Component:	MIP
Functional area:	Job processing Message processing
Domain:	JOB MESSAGE-PROCESSING
Privileges:	STD-PROCESSING TSOS HARDWARE-MAINTENANCE OPERATING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION
Routing code:	@

Function

The HELP-MSG-INFORMATION command displays the text of a system message on SYSOUT. In addition, the user can request explanations of messages and specify the language in which message texts should be issued.

Format

HELP-MSG-INFORMATION	Alias: HP / HPMSGI
MSG-IDENTIFICATION = *LAST / <alphanum-name 4..7> ,INFORMATION-LEVEL = *MAXIMUM / *MEDIUM / *MINIMUM ,LANGUAGE = *STD / <name 1..1>

Operands

MSG-IDENTIFICATION = *LAST / <alphanum-name 4..7>
Number of the system message to be displayed.
Both 4-digit and 7-digit message numbers are permitted.
See "Note".

MSG-IDENTIFICATION = *LAST
Repeats the system message last issued by the system during the current job. This does not include system messages previously requested with HELP-MSG-INFORMATION.

INFORMATION-LEVEL =
Amount of information to be displayed.

INFORMATION-LEVEL = *MAXIMUM
Displays the system message in unabbreviated form; in addition, an explanation of the message text is given.

INFORMATION-LEVEL = *MEDIUM
Displays the system message in unabbreviated form.

INFORMATION-LEVEL = *MINIMUM
Displays the system message in coded form.

LANGUAGE = *STD / <name 1..1>
Language identifier. The system message is to be given in the language assigned to the language identifier (D = German, E = English).

LANGUAGE = *STD
The default language defined user attributes applies (see commands ADD-USER und MODIFY-USER-ATTRIBUTES, operand DEFAULT-MESSAGE-LANGUAGE). If a different value has been set using the MODIFY-MSG-ATTRIBUTES command, then this value applies.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No error Guaranteed message: NMH1120
2	0	NMH9006	Warning Guaranteed messages: NMH1165, NMH1166
	1	NMH1174	Syntax error Guaranteed message: NMH1155
	32	NMH1121	Internal error
	64	CMD0216	Semantic error
	64	NMH1155	Semantic error Guaranteed message: NMH1155
	64	NMH1199	Semantic error

Note

If MIP itself sent the message to SYSOUT, any inserts in the message will have been replaced by current values. If it was some other system component, not MIP, that sent the message to SYSOUT, the insert texts in the message are those that MIP placed in the message when the other system component requested the message text. These values may also be internal labels set by the requester for future processing. 

Example

/cpf xx.dummy,aaaaa ————————————————————————————————————————————————————————  (1)

%  DMS0812 '0533' DMS ERROR CODE OCCURRED DURING EXECUTION OF THE JOB FOR THE FI
LE NAME ':2OSG:$USER1.XX.DUMMY' WITH THE FILE NAME ':2OSG:$USER1.AAAAA'. FURTHER
 INFORMATION: /HELP-MSG DMS0533

/help-msg-information language=d   ————————————————————————————————————————   (2)

%  DMS0812 DMS-FEHLERCODE '0533' BEI AUFTRAGSAUSFUEHRUNG FUER DEN DATEINAMEN ':2
OSG:$USER1.XX.DUMMY' MIT DATEINAME ':2OSG:$USER1.AAAAA' AUFGETRETEN. WEITER INFO
RMATION: /HELP-MSG DMS0533
%  ? Fuer das vorausgegangene Kommando wurde ein Fehler-Protokoll angefordert.
%    (&00): DMS-Returncode von der Funktionsausfuehrung.
%    (&01): Ausgewaehlter, vollqualifizierter Dateiname.
%    (&02): Zweiter bzw. neuer, ggf. konstruierter Dateiname.
%  ! Siehe Massnahme-Text zum Fehlercode DMS(&00).

/help-msg-information msg-id=dms0533,language=d   —————————————————————————   (3)

%  DMS0533 ANGEGEBENE DATEI IN PUBSET '(&00)' NICHT GEFUNDEN. KOMMANDO BEENDET
%  ? Diese Meldung wird von DVS-Kommandos ausgegeben. Die angeforderte Datei
%    ist im gewuenschten Pubset nicht katalogisiert.
%  MASSNAHME : KEINE

/help-msg-info info-level=*medium,language=d   ————————————————————————————   (4)

%  DMS0812 DMS-FEHLERCODE '0533' BEI AUFTRAGSAUSFUEHRUNG FUER DEN DATEINAMEN ':2
OSG:$USER1.XX.DUMMY' MIT DATEINAME ':2OSG:$USER1.AAAAA' AUFGETRETEN. WEITER INFO
RMATION: /HELP-MSG DMS0533 

(1)	The system issues message DMS0812 in response to an invalid COPY-FILE command.
(2)	The message last issued by the system is to be displayed together with an explanation in German. The message text is output in unabbreviated form.
(3)	The German message text of message DMS0533 is to be displayed. Here, the command does not refer to the message last issued by the system and therefore may be entered at any point in the job.
(4)	The message last issued by the system is requested in its German form: DMS0812. Message DMS0533 is not considered since the other message was explicitly requested.