Inhalte von Variablen ausgeben
Komponente: | SDF-P-BASYS |
Funktionsbereich: | Prozeduren |
Anwendungsbereich: | PROCEDURE |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando SHOW-VARIABLE gibt den Inhalt von Variablen aus. Mögliche Ausgabemedien sind SYSOUT, SYSLST, Datei, Listenvariable oder Bibliothekselement.
Ausgabeform
Der Inhalt von Variablen mit dem Datentyp INTEGER werden als Zeichenfolgen der Zeichen 0-9 ausgegeben, ggf. mit vorangestelltem Minuszeichen.
Der Inhalt von Variablen mit dem Datentyp BOOLEAN wird als Zeichenkette FALSE oder TRUE ausgegeben.
Die Reihenfolge, in der die Inhalte von Variablenelementen ausgegeben werden, entspricht bei zusammengesetzten Variablen vom Typ Struktur der Reihenfolge der Elementdeklarationen, bei zusammengesetzten Variablen vom Typ Array der numerischen Folge der Arrayindizes.
Die Ausgabe beginnt für jede Variable jeweils in einer neuen Zeile.
Einschränkungen
Ist das kostenpflichtige Subsystem SDF-P nicht verfügbar, bestehen die folgenden Einschränkungen:
Es werden nur die Inhalte einfacher S-Variablen ausgegeben. Bei expliziter Angabe von Variablennamen können nur einfache S-Variablen angegeben werden.
Die Ausgabe in eine Listenvariable (OUTPUT=*VARIABLE) ist nicht möglich.
Bei den Operanden SELECT und INFORMATION können innerhalb der Strukturen *BY-ATTRIBUTES(...) bzw. *PARAMETERS(...) für die Operanden SCOPE und INITIALIZATION bzw. VALUE und NAME nur die jeweiligen Default-Werte angegeben werden.
Format
SHOW-VARIABLE | Kurzname:SHV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
VARIABLE-NAME =
Bezeichnet die auszugebenden Variablen.
VARIABLE-NAME = *ALL
Alle Variablen mit dem unter SCOPE angegebenen Geltungsbereich werden in lexikalischer Reihenfolge ihrer Variablennamen ausgegeben. Elemente von Strukturen werden in der Reihenfolge ihrer Deklaration, Arrayelemente in numerischer Reihenfolge ihrer Array-Indizes ausgegeben.
VARIABLE-NAME = list-poss(2000): <composed-name 1..255>
Namen der auszugebenden Variablen.
Diese werden in der angegebenen Reihenfolge ausgegeben.
VARIABLE-NAME = <structured-name 1..20 with-wild(40)>
Die Variablen, deren Namen das Suchmuster erfüllen, werden in lexikalischer Reihenfolge ihrer Namen ausgegeben.
SELECT = *BY-ATTRIBUTES(...)
Bestimmt die auszugebenden Variablen näher.
SCOPE = *VISIBLE / *PROCEDURE / *CURRENT / *CURRENT-PARAMETERS / *TASK-ALL /
*TASK-VISIBLE / *CALLING-PROCEDURES
Bezeichnet den Geltungsbereich der auszugebenden Variablen.
SCOPE = *VISIBLE
Gibt alle sichtbaren Variablen aus.
Eine Variable ist sichtbar, wenn sie nicht von einer Deklaration in einer Include-Prozedur überdeckt ist.
INITIALIZATION = *YES / *ANY
Bezeichnet, ob nicht-initialisierte Variablen ausgegeben werden sollen oder nicht.
INITIALIZATION = *YES
Es werden nur initialisierte Variablen ausgegeben.
INFORMATION = *PARAMETERS(...)
Bezeichnet die Informationen, die ausgegeben werden.
VALUE = *WITHOUT-QUOTES / *C-LITERAL / *X-LITERAL / *NONE
Gibt an, ob der Wert der Variablen ausgegeben werden soll und in welcher Form.
VALUE = *WITHOUT-QUOTES
Gibt Variablen mit dem Datantyp STRING ohne Hochkomma aus.
NAME = *FULL-NAME(...) / *ELEMENT-NAME(...) / *NONE
Bezeichnet in welcher Form der Name der Variablen ausgegeben wird.
NAME = *FULL-NAME(...)
Gibt den vollen Variablennamen aus.
LIST-INDEX-NUMBER = *NO / *YES
Gibt an, ob bei Listenelementen statt des Suffix (*LIST) die Elementnummer an den Namen angehängt wird.
OUTPUT =
Bezeichnet das Ausgabemedium.
OUTPUT = *SYSOUT
Ausgabe nach SYSOUT.
OUTPUT = *SYSLST
Ausgabe nach SYSLST.
OUTPUT = <filename 1..54 without-gen-vers>(...)
Ausgabe in die angegebene Datei, die eine SAM-Datei sein muss.
WRITE-MODE = *REPLACE
Der bisherige Inhalt der Datei soll überschrieben werden.
WRITE-MODE = *EXTEND
Die Ausgabe soll an den bisherigen Inhalt angehängt werden.
OUTPUT = *VARIABLE(...)
Nur möglich, wenn das kostenpflichtige Subsystem SDF-P verfügbar ist.
Ausgabe in eine Listenvariable.
VARIABLE-NAME = <structured-name 1..20>
Name der Listenvariablen.
WRITE-MODE = *REPLACE
Der bisherige Inhalt der Listenvariablen soll überschrieben werden.
WRITE-MODE = *EXTEND
Die Listenvariable soll erweitert werden, das heißt, die Ausgabe soll an den bisherigen Inhalt angehängt werden.
OUTPUT = *LIBRARY-ELEMENT(...)
Ausgabe in das Element einer PLAM-Bibliothek.
LIBRARY = <filename 1..54 without-vers>
Name der PLAM-Bibliothek.
ELEMENT = <composed-name 1..64>(...)
Name des Elements.
VERSION =
Bezeichnet die Version des Elements.
VERSION = *HIGHEST-EXISTING
Wählt die höchste existierende Version.
VERSION = *UPPER-LIMIT
Wählt die höchste mögliche Version.
VERSION = <composed-name 1..24>
Wählt die angegebene Version.
TYPE = S / alphanum-name 1..8
Bezeichnet den Elementtyp.
WRITE-MODE = *REPLACE
Der bisherige Inhalt des Elements soll überschrieben werden.
WRITE-MODE = *EXTEND
Das Element soll erweitert werden, d.h. die Ausgabe soll an den bisherigen Inhalt angehängt werden.
Kommando-Returncode
Es ist möglich, dass ein Teil des Kommandos schon abgearbeitet und ausgeführt wurde, bevor der Fehler auftrat. In diesem Fall ist das Ergebnis des Kommandos nicht garantiert.
(SC2) | SC1 | Maincode | Bedeutung / garantierte Meldungen |
|---|---|---|---|
0 | CMD0001 | Ohne Fehler | |
1 | 0 | CMD0001 | Warnung: kein Variable gefunden |
1 | CMD0202 | Syntaxfehler | |
3 | CMD2203 | Falsche Syntaxdatei | |
32 | CMD0221 | Systemfehler (interner Fehler) | |
64 | CMD0216 | Erforderliches Privileg fehlt | |
64 | SDP0091 | Semantikfehler | |
130 | SDP0099 | Kein Adressraum mehr verfügbar |