MSG( ) Meldungstext ausgeben

Anwendungsgebiet: Kommando-Returncodes (Meldungen)

Die Funktion MSG( ) liefert den Meldungstext, der dem angegebenen Meldungsschlüssel zugeordnet ist, und zwar in der angegebenen Sprache und mit dem angegebenen Ausgabeformat.

Der Meldungsschlüssel kann z.B. für einige SDF-P-Kommandos vorher mit der Funktion MAINCODE( ) aus dem Kommando-Returncode abgefragt worden sein.

Format

MSG( )

MSG-IDENTIFICATION = string_ausdruck

,LANGUAGE = *STD / *ENGLISH / *GERMAN

,INSERT-00 = *NONE / string_ausdruck

,INSERT-01 = *NONE / string_ausdruck

: : :

,INSERT-29 = *NONE / string_ausdruck

,MSG-STRUCTURE-OUTPUT = *NONE / *SYSMSG

Ergebnistyp

STRING (<string>)

Eingabeparameter

MSG-IDENTIFICATION = string_ausdruck
string_ausdruck enthält den 7 Byte langen Meldungsschlüssel mit folgendem Aufbau:

Byte 1-3:	Buchstaben als Kennzeichen der Meldungsklasse
Byte 4-7:	Ziffern 0-9, Buchstaben A-F als hexadezimale Darstellung der exakten Fehlernummer

LANGUAGE = *STD / ENGLISH / *GERMAN
Es wird der englische bzw. der deutsche Meldungstext ausgegeben.
Voreingestellt ist *STD, d.h. die Ausgabe erfolgt in der für die Task voreingestellten Sprache. Die (früheren) Operandenwerte *E für *ENGLISH und *D für *GERMAN werden weiter kompatibel unterstützt.

INSERT-nn = *NONE / string_ausdruck
Bezeichnet den Zusatzinhalt einer Meldung.

MSG-STRUCTURE-OUTPUT =
Bezeichnet, ob Variablen für Ausgaben von Meldungen erzeugt und weitergeschickt werden müssen oder nicht.

MSG-STRUCTURE-OUTPUT = *NONE
Variablen für Ausgaben von Meldungen werden nicht über den S-Variablenstrom SYSMSG weitergeschickt. Der Meldungstext ist mit dem Kommando /HELP-MSG-INFORMATION MSG-ID=*LAST nicht verfügbar.

MSG-STRUCTURE-OUTPUT = *SYSMSG
Wenn die Meldungen garantiert sind, werden Variablen für Ausgaben von Meldungen über den S-Variablenstrom SYSMSG weitergeschickt. Der Meldungstext ist mit dem Kommando /HELP-MSG-INFORMATION MSG-ID=*LAST verfügbar.

Ergebnis

Meldungstext als String

Leerstring ('') bedeutet, dass dem Meldungsschlüssel kein Text zugeordnet ist.

Fehlermeldungen

SDP0413   NICHT ZULAESSIGE LAENGENANGABE
SDP0418   UNGUELTIGE MELDUNGSSCHLUESSEL 

Beispiel

/DECLARE-VARIABLE MIP(TYPE=*STRUCTURE(*DYNAMIC)),MULTIPLE-ELEMENTS=*LIST 
/ASSIGN-STREAM SYSMSG,TO=*VARIABLE(MIP)
/A=MSG(MSG-IDENTIFICATION='SDP1018',"Diese Meldung ist garantiert" -
/                 INSERT-00='MY-VARIABLE', -
/                 MSG-STRUCTURE-OUTPUT = *SYSMSG)
/B=MSG(MSG-IDENTIFICATION='SDP1010',"Diese Meldung ist NICHT garantiert" -
/                 INSERT-00='MY-SECOND-VARIABLE', -
/                 MSG-STRUCTURE-OUTPUT = *SYSMSG)
/SHOW-VARIABLE *ALL
A =  %  SDP1018 VARIABLE 'MY-VARIABLE' EXISTIERT BEREITS MIT ANDEREN 
ATTRIBUTEN
B =  %  SDP1010 VARIABLE 'MY-SECOND-VARIABLE' HAT KEINEN WERT
MIP(*LIST).MSG-TEXT = %  SDP1018 VARIABLE 'MY-VARIABLE' EXISTIERT BEREITS MIT 
ANDEREN ATTRIBUTEN
MIP(*LIST).MSG-ID = SDP1018
MIP(*LIST).I0 = MY-VARIABLE
*END-OF-CMD