Anwendungsgebiet: Jobvariablen-Funktionen
Die Funktion JV( ) liefert den Inhalt der angegebenen Jobvariablen.
Die Funktion setzt voraus, dass das Subsystem JV geladen ist. Nähere Informationen über Jobvariablen enthält das Handbuch „Jobvariablen“ [5].
Format
JV( ) |
JV-NAME = string_ausdruck ,START = 1 / arithm_ausdruck1 ,LENGTH = *REST-LENGTH / arithm_ausdruck2 |
Ergebnistyp
STRING
Eingabeparameter
JV-NAME = string_ausdruck
Bezeichnet eine Jobvariable, „string_ausdruck“ muss ein gültiger Jobvariablenname oder ein durch einen vorangestellten * gekennzeichneter JV-Kettungsname sein.
START= 1 / arithm_ausdruck1
Bezeichnet die Startposition für den zu extrahierenden JV-Inhalt. Im Standardfall ist dies das erste Zeichen. arithm_ausdruck1 muss ein positiver Integerwert sein, der kleiner ist als die Länge der gesamten JV. Wenn für arithm_ausdruck1 kein gültiger Wert angegeben wird, wird der Nullstring zurückgegeben.
LENGTH = *REST-LENGTH / arithm_ausdruck2
Bezeichnet die Länge des zu extrahierenden JV-Inhalts. Der Defaultwert *REST-LENGTH zeigt an, das der zu extrahierende JV-Inhalt mit der bei START angegebenen Position beginnt und bis zum Ende reicht. Wird mit arithm_ausdruck2 eine davon abweichende Länge angegeben, die zu lang ist, wird implizit LENGTH = *REST-LENGTH angenommen.
Ergebnis
Inhalt der mit „string_ausdruck“ bezeichneten Jobvariablen bzw. des durch „arithm_ausdruck1“ und „arithm_ausdruck<sub>1</sub>“ und „arithm_ausdruck2“ bezeichneten Teilbereichs.
Fehlermeldungen
SDP0412 START-POSITION AUSSERHALB MOEGLICHEN BEREICHS
SDP0414 WARNUNG: *REST-LENGTH WERTE FUER OPERAND LENGTH VERWENDET
SDP1022 AUF DIE JOBVARIABLE '(&00)' KANN NICHT ZUGEGRIFFEN WERDEN
SDP1024 JOBVARIABLE '(&00)' EXISTIERT NICHT
SDP1027 WERT FUER JOBVARIABLE '(&00)' IST KEIN STRING
SDP1054 JOBVARIABLEN-FEHLER: JVS-FEHLERCODE '(&00)' BEI ZUGRIFF AUF
JOBVARIABLE '(&01)'. IM SYSTEM-MODUS: /HELP-MSG JVS(&00)
Beispiel
/CREATE-JV JV-NAME=HUGO
/MODIFY-JV JV-CONTENTS=HUGO,SET-VALUE=c'schalter ein'
/A = JV('HUGO')
/SHOW-VARIABLE A
A = schalter ein
/B = JV('HUGO',4,3)
/SHOW-VARIABLE B
B = alt