SHOW-ELEMENT zeigt den Elementinhalt abhängig vom Typ des angegebenen Elementes. Es können die Inhalte von textartigen Elementen, Moduln, Phasen und Bindelademoduln ausgegeben werden. Das Darstellungsformat der Ausgabe wird über den Operanden OUTPUT-FORM gesteuert. Die Bedeutung der Attribute bei Moduln und Bindelademoduln ist [5] zu entnehmen.
Die Anweisung ist für alle Elementtypen zulässig. Benutzertypen werden dabei entsprechend ihrem Basistyp behandelt. Ist der Basistyp LMS nicht bekannt, so wirken nur die Operanden TEXT-INFORMATION und OUTPUT-FORM.
LMS kann jetzt Elemente mit nicht standardmäßigem CCSN anzeigen und ebenso Text mit Sonderzeichen. Dazu sollten die Sitzungsparameter auf UNICODE eingestellt sein:
Wählen Sie im Menü "Konfiguration" "Datensichtstation (DSS)...”; Wählen Sie im “DSS Modus” die Option “Unicode”; Wählen Sie im “DSS Typ” den Eintrag “DSS9763” (Details siehe UNICODE in BS2000/OSD, Einführung). Und beim Kommando MODIFY TERMINAL OPTIONS wird der UNICODE Parameter gesetzt: MODIFY TERMINAL OPTIONS CCS = UTFE.
SHOW-ELEMENT | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
ELEMENT = *LIBRARY-ELEMENT(...)
Angaben für die gewünschte Elementbezeichnung.
LIBRARY = *STD / <filename 1..54 without-vers> / *LINK(...)
Angabe der Bibliothek, in der sich das Element befindet.
LIBRARY = *STD
Die durch OPEN-LIBRARY eröffnete Bibliothek.
LIBRARY = <filename 1..54 without-vers>
Name der Bibliothek, in der sich das Element befindet.
LIBRARY = *LINK(...)
Die über den Dateikettungsnamen zugewiesene Bibliothek.
LINK-NAME = <structured-name 1..8>
Dateikettungsname der Bibliothek, der vor dem Aufruf von LMS mit einem /ADD-FILE-LINK-Kommando vereinbart wurde.
ELEMENT = *ALL / <composed-name 1..64 with-under with-wild(132)>(...)
Name des Elementes, welches angezeigt werden soll.
VERSION = *HIGHEST-EXISTING / *ALL / *UPPER-LIMIT / <composed-name 1..24 with-under with-wild(52)>
Version, die das auszugebende Element besitzt.
VERSION = *HIGHEST-EXISTING
Das Element mit der höchsten bestehenden Version bzgl. BASE wird ausgegeben.
VERSION = *UPPER-LIMIT
Die in der Bibliothek unter dem angegebenen TYPE und Namen höchstmögliche Version X’FF’ wird angezeigt.
VERSION = <composed-name 1..24 with-under with-wild(52)> Explizite Angabe der Version des Elementes, das angezeigt werden soll.
BASE = *STD / <composed-name 1..24 with-under with-wild>
Präfix für die Versionsauswahl. Im Zusammenhang mit VERSION=*HIGHEST-EXISTING kann damit die höchste Version mit einem bestimmten Präfix angesprochen werden. BASE=*STD wirkt wie BASE=*.
TYPE = *LMS-DEFAULT / *ALL / <alphanum-name 1..8 with-wild(20)>
Typ, den das auszugebende Element besitzt.
USER-DATE = *ANY / *TODAY / <date8..10 with-compl> / *INTERVAL(...)
Datum, das vom Benutzer vergeben wurde.
USER-DATE = *ANY
Das auszugebende Element besitzt ein beliebiges Datum.
USER-DATE = *TODAY
Das Element mit dem aktuellen Tagesdatum wird angezeigt.
USER-DATE = <date 8..10 with-compl>
Das Element, dessen Datum explizit in der Form [JJ]JJ-MM-TT eingegeben wird, wird angezeigt.
USER-DATE = *INTERVAL(...)
Alle Elemente, die in dem angegebenen Zeitraum liegen, werden angezeigt.
FROM = 1900-01-01 / <date 8..10 with-compl> Beginn des Zeitraums.
TO = *TODAY / <date 8..10 with-compl>
Ende des Zeitraums.
CREATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Erzeugungsdatum des Elementes. Beschreibung der Operanden analog zu USER-DATE.
MODIFICATION-DATE = *ANY / *TODAY / <date 8..10 with-compl> / *INTERVAL(...)
Datum der letzten Änderung für das Element. Beschreibung der Operanden analog zu USER-DATE.
EXCEPT-ELEMENT =*NONE / *ELEMENT(...)
Angabe der Elemente, die von der Auswahl ausgeschlossen werden.
EXCEPT-ELEMENT = *NONE
Es wird kein Element ausgeschlossen.
EXCEPT-ELEMENT = *ELEMENT(...)
Angabe der Elemente, die nicht angezeigt werden sollen. Ein Element wird ausgeschlossen, wenn alle Felder der EXCEPT-ELEMENT-Struktur, die nicht auf *ANY gesetzt sind, das Element als Treffer ausweisen. Sind alle Felder der EXCEPT-ELEMENT-Struktur auf *ANY gesetzt, so werden alle Elemente ausgeschlossen.
Zur Beschreibung der Operanden siehe Operand *LIBRARY-ELEMENT dieser Anweisung.
TEXT-INFORMATION = *LMS-DEFAULT / *ALL / *STATISTICS / *FILE-ATTRIBUTES / *PARAMETERS(...)
Legt die Informationsmenge für alle Elemente außer den Elementtypen R, C und L fest.
TEXT-INFORMATION = *ALL
Es wird alles ausgegeben.
TEXT-INFORMATION = *STATISTICS
Es wird die Anzahl der Sätze pro Satzart und die Summe der Sätze ausgegeben. Pro Satzart wird die Summe der Satzlängen (ohne Satzlängenfelder) ausgeben und deren Summe über alle Satzarten.
TEXT-INFORMATION = *FILE-ATTRIBUTES
Es werden nur die gespeicherten Dateiattribute ausgegeben. Für alle PAM-Elemente außer denen vom Elementtyp L gehört dazu auch der Last Byte Pointer (LBP), wenn er als Dateiattribut gespeichert ist. Für SAM-Elemente enthält die Ausgabe den Namen des NET-CODED-CHAR-SET (NETCCSN), wenn er als Dateiattribut gespeichert ist.
TEXT-INFORMATION = *PARAMETERS(...)
Es wird ein Elementausschnitt festgelegt, der ausgegeben werden soll.
INFORMATION = *LMS-DEFAULT / *ALL / list-poss(2): *TEXT / *COMMENT
Der anzuzeigende Teilbereich des Elementes
INFORMATION = *ALL
Es wird alles ausgegeben.
INFORMATION = *TEXT
Der eigentliche Text, d.h. Satzart 1 wird angezeigt.
INFORMATION = *COMMENT
Der separat gespeicherte Text, d.h. Satzart 2 wird angezeigt.
RECORD-RANGE = *LMS-DEFAULT / *ALL / *RANGE(...)
Der zu bearbeitende Teilbereich des Elementes.
RECORD-RANGE = *ALL
Es werden alle Sätze bearbeitet.
RECORD-RANGE = *RANGE(...)
Der zu bearbeitende Satznummernbereich wird bestimmmt. Die Satznummern beziehen sich nicht auf eine Satzart, sondern auf den durch INFORMATION= festgelegten Teilbereich des Elementes. Innerhalb dieses Teilbereiches werden die Sätze von 1 bis n durchnumeriert.
FROM = *LMS-DEFAULT / <integer 1..2147483647>
Beginn des Bereichs durch Angabe der ersten Satznummer. Standardmäßig wird die Satznummer 1 genommen.
TO = *LMS-DEFAULT / *LAST / <integer 1..2147483647>
Ende des Bereichs durch Angabe der letzten Satznummer. Standardmäßig wird die letzte Satznummer genommen.
RECORD-PART = *LMS-DEFAULT / *ALL / *PART(...)
Der zu bearbeitende Satzbereich wird bestimmt.
RECORD-PART = *ALL
Der ganze Satz wird bearbeitet.
RECORD-PART = *PART(...)
Der zu bearbeitende Satzbereich wird bestimmt. Werden die Standardwerte nicht verändert, wird der ganze Satz bearbeitet.
START = *LMS-DEFAULT / <integer 1..262144>
Beginn des Bereichs durch Angabe des ersten Zeichens im Satz. Standardmäßig wird das erste Zeichen genommen.
LENGTH = *LMS-DEFAULT / *REST / <integer 0..262144>
Länge des Bereichs. Standardmäßig wird der Rest des Satzes genommen.
RECORD-NUMBER = *LMS-DEFAULT / *BY-OUTPUT / *YES / *NO
Bestimmt die Ausgabe der Satznummern.
RECORD-NUMBER = *BY-OUTPUT
Nur wenn die Ausgabe nach SYSOUT erfolgt, werden keine Satznummern ausgegeben. Bei jedem anderen Ausgabemedium werden sie mit ausgegeben.
RECORD-NUMBER = *YES
Die Satznummern werden auch nach SYSOUT ausgegeben.
RECORD-NUMBER = *NO
Es werden keine Satznummern mit ausgegeben.
MODULE-INFORMATION = *LMS-DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)
Legt die Informationsmenge für Bindemodule (Elemente vom Typ R) fest.
MODULE-INFORMATION = *ALL
Es wird alles ausgegeben.
MODULE-INFORMATION = *STATISTICS
Es werden Name, Länge und Adresse der CSECTS sowie die Gesamtlänge des Moduls ausgegeben.
MODULE-INFORMATION = *PARAMETERS(...)
Dieser Parameter legt fest, ob alle Satzarten oder nur ausgewählte Satzarten ausgegeben werden.
INFORMATION = *LMS-DEFAULT / *ALL / *TXT(...) / *TXTP(...) / list-poss(9): *ESD / *ISD / *LSD / *RLD / *REP / *INCLUDE / *DSDD / *REF / *END
Die hier aufgezählten Satzarten können ausgewählt werden.
INFORMATION = *TXT(...)
Es werden Textsätze ausgewählt.
CSECT-NAME = *LMS-DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>
Die Textsätze können auf eine CSECT eingeschränkt werden.
ADDRESS = *LMS-DEFAULT / <x-string 1..8>(...)
Anfangsadresse des Textes. Die Standardeinstellung ist X‘00000000‘.
BASE-ADDRESS = *LMS-DEFAULT / <x-string 1..8>
Die hier angegebene Basisadresse wird auf die Anfangsadresse addiert. Die Standardeinstellung ist X‘00000000‘.
LENGTH =*LMS-DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8> Länge des Textes.
INFORMATION = *TXTP(...)
Es werden TXTP-Sätze ausgegeben.
MODIFICATION-ID = *LMS-DEFAULT / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Es werden die TXTP-Sätze mit der angegebenen Identifikation ausgewählt.
MODIFICATION-ID = *RANGE(...)
Es können mehrere TXTP-Sätze ausgewählt werden, die in einem Bereich liegen.
FROM = *LMS-DEFAULT / *LOWEST / <c-string 1..8 with-low>
Der Bereichsbeginn ist standardmäßig die niedrigste Identifikation für die TXTP-Sätze oder sonst die hier eingegebene.
TO = *LMS-DEFAULT / *HIGHEST / <c-string 1..8 with-low>
Das Bereichsende ist standardmäßig die höchste Identifikation für die TXTP-Sätze oder sonst die hier eingegebene.
PHASE-INFORMATION = *LMS-DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)
Legt die Informationsmenge für Phasen (Elemente vom Typ C) fest.
PHASE-INFORMATION = *ALL Es wird alles ausgegeben.
PHASE-INFORMATION = *STATISTICS
Es werden Name, Länge und Adresse des Segmentes sowie die Gesamtlänge des Segmentes ausgegeben.
PHASE-INFORMATION = *PARAMETERS(...)
Dieser Parameter legt fest, ob alle Satzarten oder nur ausgewählte Satzarten ausgegeben werden.
SEGMENT = *LMS-DEFAULT / *ALL / *ROOT / <name 1..8>
Phasensegment, das ausgewählt wird.
INFORMATION = *LMS-DEFAULT / *ALL / *TXT(...) / *TXTP(...) /list-poss(4): *ESD / *ISD / *LSD / *RLD
Die hier aufgezählten Satzarten können ausgewählt werden.
INFORMATION = *TXT(...)
Es werden Textsätze ausgewählt.
ADDRESS = *LMS-DEFAULT(...) / <x-string 1..8>(...)
Anfangsadresse des Textes
BASE-ADDRESS = *LMS-DEFAULT / <x-string 1..8>
Die hier angegebene Basisadresse wird auf die Anfangsadresse addiert.
LENGTH = *LMS-DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>
Länge des Textes.
INFORMATION = *TXTP(...)
Es werden TXTP-Sätze ausgegeben.
MODIFICATION-ID = *LMS-DEFAULT / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Es werden die TXTP-Sätze mit der angegebenen Identifikation ausgewählt.
MODIFICATION-ID = *RANGE(...)
Es können mehrere TXTP-Sätze ausgewählt werden, die in einem Bereich liegen.
FROM = *LMS-DEFAULT / *LOWEST / <c-string 1..8 with-low>
Der Bereichsbeginn ist standardmäßig die niedrigste Identifikation für die TXTP-Sätze oder sonst die hier eingegebene.
TO= *LMS-DEFAULT / *HIGHEST / <c-string 1..8 with-low>
Das Bereichsende ist standardmäßig die höchste Identifikation für die TXTP-Sätze oder sonst die hier eingegebene.
LLM-INFORMATION = *LMS-DEFAULT / *ALL / *STATISTICS / *PARAMETERS(...)
Legt die Informationsmenge für Bindelademodule (Elemente vom Typ L) fest.
LLM-INFORMATION = *ALL Es wird alles ausgegeben.
LLM-INFORMATION =*STATISTICS
Allgemeine Informationen über das Bindelademodul (Name, Copyright, ...) werden ausgegeben.
LLM-INFORMATION = *PARAMETERS(...)
Dieser Parameter legt fest, ob alle Satzarten oder nur ausgewählte Satzarten ausgegeben werden.
LLM-PART = *LMS-DEFAULT / *ALL / *SLICE(...) / *SUB-LLM(...)
Angabe des LLM-Teils, das ausgewählt werden soll. Standardmäßig wird der gesamte LLM ausgewählt.
LLM-PART = *SLICE(...)
Angabe der SLICE, die ausgegeben werden soll.
NAME = *LMS-DEFAULT / <structured-name 1..32> Name der SLICE, die ausgegeben werden soll.
LLM-PART = *SUB-LLM(...)
Angabe des SUB-LLM, der ausgegeben werden soll.
PATH-NAME = *LMS-DEFAULT / <c-string 1..255 with-low> / <text 1..255>
Der auszugegebende SUB-LLM wird durch seinen Pfadnamen bestimmt.
INFORMATION = *LMS-DEFAULT / *ALL / *TXT(...) / *TXTP(...) / *LOGICAL(...) / *PHYSICAL / *REF / list-poss(4): *RELOCATION / *ESVD / *ESVR / *LRLD
Die hier aufgezählten Satzarten können ausgewählt werden.
INFORMATION = *TXT(...)
Es werden Textsätze ausgewählt.
CSECT-NAME = *LMS-DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>
Die Textsätze können auf eine CSECT eingeschränkt werden.
ADDRESS = *LMS-DEFAULT(...) / <x-string 1..8>(...)
Anfangsadresse des Textes
BASE-ADDRESS = *LMS-DEFAULT / <x-string 1..8>
Die hier angegebene Basisadresse wird auf die Anfangsadresse addiert.
LENGTH = *LMS-DEFAULT / *REST / <integer 1..2147483647> / <x-string 1..8>
Länge des Textes
INFORMATION = *TXTP(...)
Es werden TXTP-Sätze ausgegeben.
CSECT-NAME = *LMS-DEFAULT / *ALL / <c-string 1..32 with-low> / <text 1..32>
Die TXTP-Sätze können auf eine CSECT eingeschränkt werden.
MODIFICATION-ID = *LMS-DEFAULT / *ALL / <c-string 1..12 with-low> / *RANGE(...)
Es werden die TXTP-Sätze mit der angegebenen Identifikation ausgewählt.
MODIFICATION-ID = *RANGE(...)
Es können mehrere TXTP-Sätze ausgewählt werden, die in einem Bereich liegen.
FROM = *LMS-DEFAULT / *LOWEST / <c-string 1..12 with-low>
Der Bereichsbeginn ist standardmäßig die niedrigste Identifikation für die TXTP-Sätze oder sonst die hier eingegebene.
TO = *LMS-DEFAULT / *HIGHEST / <c-string 1..12 with-low>
Das Bereichsende ist standardmäßig die höchste Identifikation für die TXTP-Sätze oder sonst die hier eingegebene.
INFORMATION = *LOGICAL(...)
Es wird die logische Struktur des LLM ausgegeben.
LEVEL = *LMS-DEFAULT / *ALL / *NEXT
Es werden standardmäßig alle oder sonst nur die nächste Unterstruktur ausgegeben.
INFORMATION = *PHYSICAL
Es wird die physikalische Struktur des LLM ausgegeben.
OUTPUT-FORM = *LMS-DEFAULT / *STD / *CHARACTER / *HEXADECIMAL / *DUMP
Festlegung der Darstellungsformates für die Ausgabe.
OUTPUT-FORM = *STD
Das Darstellungsformat wird abhängig vom Typ des Elementes gewählt. Für Textelemente wirkt dieser Operand wie OUTPUT-FORM = *CHARACTER.
OUTPUT-FORM = *CHARACTER
Die Ausgabe wird alphanumerisch dargestellt.
OUTPUT-FORM = *HEXADECIMAL
Die Ausgabe wird hexadezimal dargestellt.
OUTPUT-FORM = *DUMP
Die Ausgabe wird alphanumerisch und hexadezimal dargestellt.
TEXT-OUTPUT = *LOGGING-PARAMETERS / *SYSOUT / *SYSLST(...) / *EDT(...)
Steuerung der Protokollausgabe.
TEXT-OUTPUT = *LOGGING-PARAMETERS
Die Protokollausgabe erfolgt in das mit //MODIFY-LOGGING-PARAMETERS, TEXT-OUTPUT= festgelegte Ausgabemedium.
TEXT-OUTPUT = *SYSOUT
Die Ausgabe wird nach SYSOUT geschrieben.
TEXT-OUTPUT = *SYSLST(...)
Die Ausgabe wird nach SYSLST geschrieben.
SYSLST-NUMBER = *STD / <integer 1..99>
Bezeichnet die SYSLST-Datei, in die die Ausgabe erfolgen soll.
SYSLST-NUMBER = *STD
Es gilt die Systemdatei SYSLST.
SYSLST-NUMBER = <integer 1..99>
Es gilt die Systemdatei aus der Menge SYSLST01 bis SYSLST99, deren Nummer hier angegeben wird.
TEXT-OUTPUT = *EDT(...)
Die Ausgabe erfolgt in die Arbeitsdatei 9 des EDT. Tritt bei der Protokollausgabe ein Fehler auf, so wird auf den Standardprotokollstrom (SYSOUT) umgeschaltet.
WRITE-MODE = *EXTEND / *REPLACE
Schreibmodus der Ausgabe bezogen auf den Inhalt der Arbeitsdatei 9.
WRITE-MODE = *EXTEND
Existieren Daten in der Arbeitsdatei 9, werden diese durch die Ausgabe erweitert. Ansonsten wird die Ausgabe an den Anfang der Arbeitsdatei geschrieben.
WRITE-MODE = *REPLACE
Die Ausgabe erfolgt an den Anfang der Arbeitsdatei 9. Existierende Daten in der Arbeitsdatei werden dabei ersetzt.
Anweisungs-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Ohne Fehler | |
2 | 0 | LMS0084 | VTSUCB-Makro-Fehler |
2 | 0 | LMS0129 | Anweisung abgebrochen durch Benutzer |
1 | CMD0230 | Syntaxfehler | |
32 | LMS1002 | Interner Fehler | |
64 | LMS0302 | Element nicht gefunden | |
64 | LMS1003 | Fehler während Mengenverarbeitung (Wildcard) bei mindestens einem Element oder einer Datei | |
64 | LMS1004 | Sonstige Fehler | |
64 | PLA0229 | Kein Zugriffsrecht für das Element | |
130 | LMS0041 | Systemadressraum erschöpft | |
130 | LMS0411 | Bibliothek gesperrt | |
130 | LMS0412 | Element gesperrt | |
130 | LMS0413 | Typ gesperrt |
Notwendige Zugriffsrechte
Bei LIBRARY-ELEMENT: Leserecht für LIBRARY und ELEMENT
Sind von der Anweisung mehrere Elemente betroffen, so werden Elemente ohne Leserecht von der Anweisung ausgenommen.
Beispiele
Das Element LETTER.A, das den Text ’Sehr geehrte ...’ enthält, soll aufgelistet werden.
//show-element (element=letter.a,type=d) INPUT LIBRARY= :1OSQ:$USER.LIB.SHOW INPUT ELEMENT= (D)LETTER.A/@(0001)/2011-04-09 SEHR GEEHRTE ... NUMBER OF PROCESSED RECORDS IS 1
Für das PAM Element NET.LBP.2DD werden die gespeicherten Dateiattribute mit Last Byte Pointer (LBP) ausgegeben.
//show-element (element=net.lbp.2dd,type=x),text-information=file attributes INPUT LIBRARY= :1OSQ:$USER.LIB.SHOW INPUT ELEMENT= (X)NET.LBP.2DD/@(0001)/2014-12-17 ORIGINAL FILE ATTRIBUTES : FILENAME= :1OSQ:$USER.LBP1.100 FILSIZE = 0000016 FCBTYPE = PAM 2ND ALLO = 00016 LBP = 00733 SHARE = NO ACCESS = WRITE BLKCTRL = NO BLKSIZE = 002048 RECFORM = U RECSIZE = 00000 PERFORM = STANDARD USAGE = NOT-SPEC