Mit dem Systemkommando LIST
können Sie sich
den Sourcecode eines einzelnen Objekts anzeigen oder mehrere in Ihrer aktuellen
Library gespeichterte Objekte auflisten lassen. Die zahlreichen Möglichkeiten
des LIST
-Kommandos sind im Folgenden
beschrieben.
Dieses Dokument behandelt folgende Themen:
Siehe auch separate Beschreibungen zu LIST XREF
,
LIST
COUNT
und LISTSQL
.
Programmierschnittstellen (APIs): USR1054N
,
USR1055N
, USR1056N
, USR2018N
,
USR4216N
. Siehe auch SYSEXT - Natural Application Programming
Interfaces in der
Utilities-Dokumentation.
Anmerkungen:
DDM
können Sie auch das
Schlüsselwort VIEW
(oder kurz V
) verwenden.
LIST
-Kommando lange Zeilen mit
bis zu 244 Zeichen anzeigen kann, sollten Sie die Zeilenlänge mit dem
Profilparameter LS
so groß wie möglich
wählen. Wenn möglich, setzen Sie den Parameter
LS=250
.
Für object-type können Sie einen der nachfolgend aufgeführten Objekttypen angeben oder Stern-Notation (*) benutzen.
*
|
|||||
CLASS
|
|||||
4 |
|||||
COPYCODE |
|||||
DATA-AREAS |
|||||
GLOBAL |
|||||
LOCAL |
|||||
PARAMETER |
|||||
DIALOG
|
|||||
3
|
|||||
FUNCTION |
|||||
7 |
|||||
ADAPTER |
|||||
8 |
|||||
RESOURCE |
|||||
9 |
|||||
MAP |
|||||
|
|||||
PROGRAM |
|||||
RECORDING |
|||||
ROUTINES |
|||||
HELPROUTINE |
|||||
SUBPROGRAM |
|||||
N |
|||||
SUBROUTINE |
|||||
TEXT |
Für object-name können Sie den Namen eines
Objekts (maximal 8 Zeichen; bei LIST
EXTENDED
32 Zeichen).
Für object-name-range können Sie Stern-Notation (*) und Wildcard-Notation (?) verwenden:
Für eine Liste aller Objekte in der aktuellen Library geben Sie als object-name-range einen Stern (*) an, aber keinen object-type.
Für eine Liste aller Objekte eines bestimmten Objekttyps geben Sie den gewünschten object-type sowie als object-name-range einen Stern (*) an.
Für eine Liste eines bestimmten Bereichs von Objekten können Sie für den object-name-range Stern-Notation (*) und Wildcard-Notation (?) verwenden:
Stern-Notation ist die Möglichkeit, innerhalb des object-name-range einen Stern (*) anzugeben: der Stern steht für eine beliebige Zeichenkette beliebiger Länge.
Wildcard-Notation ist die Möglichkeit, innerhalb des object-name-range ein Fragezeichen (?) anzugeben: das Fragezeichen steht für ein beliebiges Zeichen.
In einem object-name-range können Sie eine oder mehrere Stern- und Wildcard-Notationen miteinander kombinieren.
Für eine vollständige Liste von Objekten ab einen bestimmten Startwert bzw. bis zu einem bestimmten Endwert können Sie die Größer-Zeichen-Notation (>) bzw. die Kleiner-Zeichen-Notation (<) verwenden.
Die Größer-Zeichen-Notation (>) und die Kleiner-Zeichen-Notation (<) können nicht miteinander oder mit Stern-Notation (*) oder Wildcard-Notation (?) kombiniert werden. Sie können nur zum Anzeigen einer Liste von Objekten verwendet werden (siehe Liste von Objekten anzeigen).
Für eine ausführliche Beschreibung der options, siehe Abschnitt Optionen .
Für extended-type können Sie einen der nachfolgend aufgeführten Objekttypen oder einen Stern (*) angegeben.
*
|
||||
CLASS
|
||||
4 |
||||
SUBROUTINE |
Für eine ausführliche Beschreibung siehe
LIST
EXTENDED
.
[TYPE =type-list]
|
||||||||||||
[KIND =kind-range]
|
||||||||||||
[MODE =mode-range]
|
||||||||||||
[VERSION =version-range
]
|
||||||||||||
[USER =user-range]
|
||||||||||||
[DATE =date-range]
|
||||||||||||
[TIME =time-range]
|
||||||||||||
[CP =code-page-range]
|
||||||||||||
SORTED =
|
TYPE |
|
||||||||||
MODE |
||||||||||||
VERSION |
||||||||||||
USERID |
||||||||||||
DATE |
||||||||||||
DT |
||||||||||||
DATETIME
|
||||||||||||
TIME |
||||||||||||
SIZE |
||||||||||||
LINES |
||||||||||||
BPSIZE
|
||||||||||||
DS IZE
|
||||||||||||
DATSIZE |
||||||||||||
CP |
||||||||||||
CODE-PAGE |
type-list | * (für alle Typen)
oder eine Liste von 11 gültigen 1-Byte-Natural-Objekttyp-Zeichen (z.B.
P for Program, M für Map).
|
|
---|---|---|
kind-range | * |
Listet alle Objekte. |
S |
Listet nur Objekte in Sourceform. | |
C |
Listet nur katalogisierte Objekte. | |
S/C |
Listet nur Objekte, die in Sourceform und als katalogisiertes Objekt vorhanden sind. | |
S/ |
Listet nur Objekte auf, die nur als Sourceobjekte vorhanden sind. | |
/C |
Listet nur Objekte, die als katalogisiertes Objekt vorhanden sind. | |
W |
Listet nur in Sourceform und Objektform gespeicherte Objekte. | |
mode-range | * |
Listet alle Objekte. |
S |
Listet nur Objekte, die im Structured Mode geschrieben wurden. | |
R |
Listet nur Objekte, die im Report Mode geschrieben wurden. | |
version-range |
Die Natural-Version der Natural-Objekte. Siehe auch Begriffsdefinition von Version im Glossary. Gültiges Versionsformat: V.R.SM, dabei ist V die einstellige Versionsnummer, R die einstellige Release-Nummer, SM die zweistellige System-Maintenance-Level-Nummer. Sie können einen Bereich von Versionsnummern angeben, siehe range-notation. |
|
user-range |
Die User-ID des Benutzers, der ein Natural-Programmierobjekt gespeichert oder katalogisiert hat. Sie können eine einzelne User-ID oder einen Bereich von User-IDs angeben, siehe range-notation. |
|
date-range |
Listet alle Objekte mit einem Speicher- oder Katalogisierungsdatum innerhalb des angegebenen Datumsbereichs. Sie können ein einzelnes Datum oder einen Datumsbereich angeben. Gültiges Datumsformat: YYYY-MM-DD (YYYY=Jahr, MM=Monat, DD=Tag) Gültige Datumsbereiche:
Zulässige spezielle Datumsangaben: |
|
TODAY
(+/-nnnn) |
Alle Objekte mit aktuellem Tagesdatum. Im Anschluß an den Tag kann +nnnn oder -nnnn angegeben werden. Der Wert nnnn darf maximal 4 Zeichen lang sein. Das resultierende Datum wird berechnet aus dem aktuellen Tagesdatum plus oder minus nnnn Tage. Kann mit der Startwert-Option (>) oder der Endwert-Option
(<) kombiniert werden, z.B. listet |
|
YESTERDAY |
Alle Objekte mit dem Datum des Tages vor dem aktuellen Tag. | |
MONTH |
Alle Objekte, deren Datum im Bereich des aktuellen Monats liegt. | |
YEAR |
Alle Objekte, deren Datum im Bereich des aktuellen Jahres liegt. | |
time-range |
Listet alle Objekte mit einem Speicher- oder Katalogisierungszeitpunkt, der im angebenen Zeitbereich liegt. Geben Sie einen einzelnen Zeitwert oder einen Zeitbereich an. Gültiges Zeitformat: HH:II:SS (HH = Stunden, II = Minuten, SS = Sekunden) Gültige Zeitbereiche:
|
|
code-page-range | Sie können eine einzelne Codepage oder einen Bereich von Codepages angeben, siehe range-notation. |
Für eine Liste aller Objekte in der aktuellen Library geben Sie einen Stern (*) an.
Für eine Liste eines bestimmten Bereichs von Objekten können Sie Stern-Notation (*) und Wildcard-Notation (?)verwenden:
Stern-Notation ist die Möglichkeit, einen Stern (*) anzugeben: der Stern steht für eine beliebige Zeichenkette beliebiger Länge.
Wildcard-Notation ist die Möglichkeit, ein Fragezeichen (?) anzugeben: das Fragezeichen steht für ein beliebiges Zeichen.
Sie können eine oder mehrere Stern-Notationen (*) und Wildcard-Notationen (?) miteinander kombinieren.
Für eine vollständige Liste von Objekten ab einen bestimmten Startwert bzw. bis zu einem bestimmten Endwert können Sie die Größer-Zeichen-Notation (>) bzw. die Kleiner-Zeichen-Notation (<) verwenden.
Die Größer-Zeichen-Notation (>) und die Kleiner-Zeichen-Notation (<) können nicht miteinander oder mit Stern-Notation (*) oder Wildcard-Notation (?) kombiniert werden. Sie können nur zum Anzeigen einer Liste von Objekten verwendet werden (siehe Liste von Objekten anzeigen).
LIST | Wenn Sie nur das LIST -Kommando (ohne
Parameter) angeben, wird der Inhalt des Editor-Arbeitsbereichs aufgelistet.
|
---|
LIST object-name [options] |
In beiden Fällen wird der Sourcecode des angegebenen Objekts gelistet. Wenn Sie einen einzelnen object-name mit dem LIST-Kommando eingeben, brauchen Sie keinen object-type anzugeben; es wird der Sourcecode des angegebenen Objekts gelistet. Wenn Sie einen object-type angeben, müssen Sie auch einen object-name angeben. |
---|---|
LIST object-type object-name [options] |
LIST SEQUENTIAL object-name-range [options] | In beiden Fällen müssen Sie Stern-Notation (*) und/oder Wildcard-Notation (?) für den object-name-range benutzen. Dann werden nacheinander die Sourcecodes aller Objekte angezeigt, die die angegebenen Auswahlkriterien erfüllen. |
---|---|
LIST SEQUENTIAL object-type object-name-range [options] |
LIST object-name-range | In beiden Fällen müssen Sie Stern-Notation (*)
und/oder Wildcard-Notation (?) für den
object-name-range benutzen. Sie erhalten eine Liste
aller Objekte, die die angegebenen Auswahlkriterien erfüllen. In der Liste
können Sie dann Objekte zur Anzeige auswählen, indem Sie sie mit dem
Funktionscode LI markieren (siehe
Eine Funktion auf einem
Objekt ausführen).
|
---|---|
LIST object-type object-name-range |
LIST object-name-range |
In beiden Fällen müssen Sie Stern-Notation (*) und/oder
Wildcard-Notation (?) für den object-name-range
benutzen. Sie erhalten eine Liste aller Objekte, die die angegebenen
Auswahlkriterien erfüllen. In der Liste können Sie dann Objekte zur Anzeige
auswählen, indem Sie sie mit dem Funktionscode Mit der range-clause können Sie zusätzliche Auswahl- und Sortierkriterien angeben, siehe auch das Beispiel weiter unten. |
---|---|
LIST object-name-range range-clause |
LIST EXTENDED object-name-range | Listet die Langnamen der katalogisierten Subroutinen und Klassen. Bezüglich der Namensoptionen siehe auch object-name-range weiter oben. |
---|---|
LIST EXTENDED extended-type object-name-range |
LIST NOCOPT [object-type] object-name-range | Listet die katalogisierten Objekte, die mit dem
Natural Optimizer Compiler (NOC) kompiliert wurden, und zeigt außerdem die zu
Beginn beim CATALOG verwendeten
NOC-Optionen an. Bezüglich der Namensoptionen siehe auch
object-name-range
weiter oben.
|
---|
LIST OPTIONS [object-type] object-name-range | Listet die katalogisierten Objekte auf und zeigt
die beim CATALOG verwendeten
Compiler-Optionen. Bezüglich der Namensoptionen siehe auch
object-name-range
weiter oben.
Standardmäßig werden die endgültig verwendeten Compiler-Optionen
angezeigt, das heißt, die Optionseinstellungen, die am Ende des
|
---|
LIST DIRECTORY | Zeigt die Directory-Informationen zu dem gerade im
Editor-Arbeitsbereich befindlichen Objekt an:
|
---|---|
LIST DIRECTORY object-name |
Dieses Kommando zeigt die Directory-Informationen zu dem
betreffenden Objekt an (wie bei Wenn Sie Stern-Notation (*) oder Wildcard-Notation (?) für object-name-range verwenden, werden nacheinander die Directory-Informationen der entsprechenden Objekte angezeigt. |
LIST DIRECTORY object-name-range | |
LIST object-name WITH DIRECTORY | Dieses Kommando zeigt zunächst die Directory-Informationen zu
dem betreffenden Objekt an (wie bei LIST DIRECTORY
beschrieben) und listet anschließend den Sourcecode des Objekts.
|
LIST DDM | Dieses Kommando zeigt eines Liste aller DDMs an. |
---|---|
LIST DDM ddm-name | Wenn Sie einen einzelnen DDM-Namen angeben, wird das angegebene
DDM angezeigt.
Für ddm-name können Sie einen einzelnen DDM-Namen (bis zu 32 Zeichen lang) oder wie für object-name-range einen Bereich angeben, um eine Liste eines bestimmten Bereichs von DDMs anzuzeigen. |
Anmerkung:
Statt des Schlüsselworts DDM
können Sie auch das
Schlüsselwort VIEW
(oder kurz V
) verwenden.
Statt options können Sie eine der nachfolgend aufgeführten Optionen angeben.
[[WITH] DIRECTORY ] [NUMBERS OFF ] [expand-option]
|
||
formatted-option | ||
CONVERTED |
DIRECTORY | Dieses Kommando zeigt zunächst die Directory-Informationen zu dem betreffenden Objekt an (wie bei Directory Informationen anzeigen beschrieben) und listet anschließend den Sourcecode des Objekts. |
---|---|
NUMBERS OFF | Standardmäßig wird der Sourcecode eines Objekts mit
Zeilennummern gelistet. Wünschen Sie eine Anzeige ohne Zeilennummern, verwenden
Sie die Option NUMBERS OFF (Vgl. Unterkommandos für eine
angezeigte Source).
|
CONVERTED | Standardmäßig wird der Sourcecode in der zur Systemdatei
gespeicherten Codepage angezeigt. Sie können die Option CONVERTED
verwenden, um den Sourcecode in der Default-Codepage (siehe Systemvariable
*CODEPAGE) .
|
EXPAND |
[
FORMATTED ]
|
COMMENTS |
[expand-type ...10] | object-name object-name-range | ||||||||
n |
EXPAND object-name |
Die Wenn Sie beispielsweise ein Source-Programm listen, das ein
In den folgenden Erklärungen werden Objekte, die innerhalb einer Source gelistet werden, als "Expand-Objekte" bezeichnet. Unterkommandos zur
EXPAND -OptionInnerhalb eines gelisteten Expand-Objekts sind nur die folgenden Unterkommandos verfügbar (die oben beschrieben sind):
|
||
---|---|---|---|
EXPAND object-name-range | |||
EXPAND FORMATTED |
Die Option Für Data Areas gilt:
Für Maps gilt:
|
||
EXPAND COMMENTS |
Wenn Sie die Option Wenn Sie die Option Wenn Sie keine dieser beiden Optionen verwenden, wird das Expand-Objekt vollständig gelistet. |
||
EXPAND n | |||
expand-type |
Als expand-type geben Sie den Objekttyp des Expand-Objekts an. Sie können die folgenden expand-types angeben: |
||
P |
Programme | Falls Sie mehr als einen
expand-type angeben möchten, geben Sie sie in
beliebiger Reihenfolge und ohne Leerzeichen an; um Maps, Copycodes und
Subroutinen innerhalb einer gelisteten Source zu listen, geben Sie
beispielsweise MCS als expand-type
an.
|
|
N |
Subprogramme | ||
S |
Externen Subroutinen | ||
H |
Helproutinen | ||
G |
Global Data Areas | ||
L |
Local Data Areas | ||
A |
Parameter Data Areas | ||
M |
Maps | ||
C |
Copycodes | ||
E |
Fehlermeldungen | ||
4 |
Klassen | ||
* |
Alle Objekttypen | ||
object-name |
Als object-name oder object-name-range geben Sie den Namen bzw. die Namen der Expand-Objekte an, die innerhalb der gelisteten Source gelistet werden soll(en). Für den object-name bzw.
object-name-range eines Expand-Objekts stehen die
gleichen Optionen zur Verfügung wie für den object-name bzw.
object-name-range
des gelisteten Hauptobjekts in der primären
|
||
object-name-range |
FORMATTED |
['c'] | ['c'] | [SETTINGS ]
|
Die FORMATTED
-Option gilt für Data Areas (mit
STOW
gespeichert, d.h. bei denen der Zeitstempel des
Sourceobjekts und des katalogisierten Objekts identisch ist) und Maps:
FORMATTED |
Mit STOW-Kommando gespeicherte Data
Area:
Wenn Sie diese Option für eine Data Area angeben, wird die Data
Area formatiert angezeigt, d.h. die Anzeige ähnelt einem
Dies gilt nur für mit Sie können die Standardeinstellung im List-Profil ändern, siehe
Individuelles List-Profil
erstellen und siehe auch Unterkommando
Map:
Wenn Sie die |
---|
Wenn Sie Maps mit dem LIST-Kommando anzeigen, können Sie zusätzlich zum
Schlüsselwort FORMATTED
weitere Optionen angeben:
Die folgenden Optionen bewirken, dass die von der Map verwendeten Processing Rules angezeigt werden. Diese Verarbeitungsregeln werden in der Reihenfolge der Felder, denen sie zugewiesen sind, angezeigt und je Feld in der Reihenfolge des Rangs (Rank).
Siehe auch Unterkommandos LAYOUT
und
FORMAT
im
Abschnitt Source-Liste.
Wenn Sie Stern- oder Wildcard-Notation für den
object–name verwenden, erhalten Sie eine Liste aller
Objekte, die Ihr Auswahlkriterium erfüllen. Auf der Liste können Sie dann die
Objekte, die Sie gelistet, gedruckt usw. haben möchten, mit einem Funktionscode
markieren oder Sie können ein Natural-Systemkommando oder ein
LIST
-Unterkommando in der Kommandozeile absetzen.
Dieser Abschnitt beschreibt die Funktionen, Unterkommandos und
Funktionscodes, die in der angezeigten Liste der Objekte verfügbar sind, z.B.
nachdem Sie ein LIST *
-Kommando abgesetzt haben.
Folgende Themen werden behandelt:
Die Liste der Objekte enthält folgende Spalten:
Spalte | Erklärung |
---|---|
Cmd |
In diese Spalte können Sie einen Code eingeben, um eine Funktion auf einem Objekt auszuführen. Siehe Eine Funktion auf einem Objekt ausführen. |
Name |
Name des Objekts. |
Type |
Objekttyp. |
S/C |
Zeigt an, ob das Objekt als Source (S) und/oder als katalogisiertes Objekt (C) vorhanden ist. |
SM |
Der Natural-Programmiermodus, der beim Erstellen
des Objekts verwendet wurde.
S = Structured Mode R = Reporting Mode |
Version |
Natural-Produktversion, die zum Erstellen bzw. Katalogisieren des Objekts verwendet wurde. |
User ID |
User-ID des Benutzers, der das Objekt erstellt bzw. katalogisiert hat. |
Date , Time |
Zeitpunkt (Datum, Uhrzeit), zu dem das Objekt erstellt bzw. katalogisiert wurde. |
Wenn Ihnen eine Auswahlliste von Objekten angezeigt wird, können Sie darin wie folgt blättern:
Um in der Liste eine Seite vor bzw. zurückzublättern, drücken Sie PF8 bzw. PF7.
Um an den Anfang bzw. ans Ende der Liste zu blättern, drücken Sie PF6 bzw. PF9.
Wenn Ihnen eine Auswahlliste von Objekten angezeigt wird, befinden sich unmittelbar unterhalb der Spaltenüberschriften Felder, in denen die Auswahlkriterien für die derzeitige Liste angezeigt werden. Sie können die Auswahlkriterien ändern, indem Sie die Werte dieser Felder überschreiben. Wenn Sie ein Fragezeichen (?) in eins dieser Felder eingeben, erhalten Sie Informationen über die möglichen Werte für dieses Feld.
Falls von einem Objekt sowohl eine Source als auch ein Objektmodul existiert (wie in der Spalte S/C angezeigt), beziehen sich die angezeigten Informationen auf die Source, nicht das Objektmodul.
Anmerkung:
Wenn die SORT-Funktion aktiv ist, können die Source und das
Objektmodul getrennt angezeigt werden, d.h. wenn die Liste nach Objektdatum
sortiert wird und die Source und das Objektmodul unterschiedliche Datumswerte
aufweisen.
Um weitere Informationen zu Source- und katalogisierten Objekten anzuzeigen
Drücken Sie PF11, um nach rechts zu blättern.
Oder:
Drücken Sie PF10, um nach links zu blättern.
Anmerkung:
Standardmäßig wird die Anzahl der Source-Zeilen bei Sourceobjekten
aus Durchsatzgründen nicht berechnet. Wenn Sie wünschen, dass die die Anzahl
der Source-Zeilen bei Sourceobjekten angezeigt wird, können Sie entweder das
Unterkommando COUNTSOURCE
ON
eingeben oder im List-Profil (siehe
Individuelles List-Profil
erstellen) den Parameter
COUNT-SOURCE-LINES
auf Y
setzen.
Ist eine Informationseinheit in der Liste intensiviert dargestellt,
bedeutet dies, dass dort eine Abweichung zwischen der Source eines Objekts und
dem entsprechenden Objektmodul besteht. Um Näheres über die Abweichung zu
erfahren, können Sie das Objekt mit Funktionscode
LD
markieren, um sich
die betreffende Directory-Information anzeigen zu lassen. Zur Beseitigung der
Abweichung genügt es in der Regel, das Objekt neu mit
STOW
zu speichern (Funktionscode
ST
; siehe unten).
In einer Objekt-Auswahlliste können Sie ein Natural-Systemkommando oder
ein LIST
-Unterkommando in der Kommandozeile
eingeben. Gültige Unterkommandos sind:
Code | Funktion | |
---|---|---|
CODE-PAGE oder
CP |
ON |
Codepage-Informationen werden zu jedem Objekt angezeigt. Dies ist der Standardwert. |
OFF |
Codepage-Informationen werden nicht angezeigt. | |
SC |
Nur die Objekte werden aufgelistet, die einen Scan-Wert enthalten (kann nur bei langen Listen angewendet werden). | |
SC OFF |
Scan-Modus ausschalten. | |
SHORT |
Liste der Objekte in Kurzform
anzeigen, d.h. es werden nur die Objektnamen angezeigt (kann nur bei
SC OFF verwendet werden).
|
|
LONG |
Liste der Objekte in Langform (mit allen vorhandenen Feldern) anzeigen. | |
PRINT |
Liste der Objekte drucken. | |
EXTENDED |
Langnamen von Subroutinen/Klassen
anzeigen; entspricht der Funktion LIST EXTENDED
* .
|
|
ALL
fx
|
Den Funktionscode fx für alle angezeigten Objekte eingeben. fx = gültiger Funktionscode für ein gelistetes Objekt. | |
SORT |
Sort-Fenster anzeigen (siehe Liste der Objekte sortieren). | |
COUNTSOURCE |
ON |
Anzahl der Source-Zeilen für Sourceobjekte wird angezeigt. |
OFF |
Anzahl der Source-Zeilen für Sourceobjekte wird nicht angezeigt. | |
MARK-LONG-LINES
|
ON |
Lange Zeilen in der Auflistung eines Sourceobjekts werden in den
ersten zwei Stellen mit einem Der Standardwert kann im List-Profil angegeben werden; siehe Individuelles List-Profil erstellen. |
OFF |
Lange Zeilen in der Auflistung eines Sourceobjekts werden nicht markiert. | |
DEFINE-DATA |
ON |
Die aufgelistete Data-Area-Source wird standardmäßig im
Der Standardwert kann im List-Profil angegeben werden; siehe Individuelles List-Profil erstellen. |
OFF |
Die Anzeige einer Data Area Source erfolgt unformatiert. | |
LISTPROFILE |
Aktuelle Werte der Parameter des List-Profils anzeigen (siehe Individuelles List-Profil erstellen). | |
NOCOPT |
Listet die katalogisierten
Objekte, die mit dem Natural Optimizer Compiler (NOC) kompiliert wurden, und
zeigt außerdem die zu Beginn beim CATALOG verwendeten
NOC-Optionen an; entspricht LIST NOCOPT * , siehe
NOC-Optionen
katalogisierter Objekte anzeigen.
|
|
OPTIONS |
Listet die katalogisierten Objekte
auf und zeigt die beim CATALOG zu Beginn
verwendeten Compiler-Optionen; entspricht LIST OPTIONS
* , siehe Compiler-Optionen
katalogisierter Objekte anzeigen.
|
|
REUSE |
ON |
Wiederverwendungsmodus einschalten.
Die zuletzt angezeigte Liste wird erneut verwendet, nachdem in der Spalte Cmd Kommdos ausgeführt wurden. Ausgenommen sind folgende Kommandos:
|
OFF |
Wiederverwendungsmodus ausschalten.
Nach der Ausführung von Kommandos, die in der Spalte Cmd eingegeben wurden, wird die Liste neu erstellt. |
|
REFRESH |
Die gerade angezeigte Liste
aktualisieren.
Dieses Unterkommando können Sie insbesondere bei eingeschaltetem Wiederverwendungmodus benutzen. |
|
+ | Eine Seite vor blättern. | |
- | Eine Seite zurück blättern. | |
++ | Ans Ende der Objektliste blättern. | |
-- | An den Anfang der Objektliste blättern. | |
? | Hilfe zur Kommandozeile aufrufen. |
Um ein Objekt von der Auswahlliste für eine bestimmte Funktion auszuwählen, markieren Sie es einfach in der linken Spalte (unter der Überschrift Cmd) mit dem entsprehenden Funktionscode.
Sie können mehrere Objekte in der Auswahlliste mit unterschiedlichen Funktionscodes markieren. Die Funktionen werden dann nacheinander ausgeführt.
Die folgenden Funktionscodes stehen Ihnen zur Verfügung (mögliche Abkürzungen sind unterstrichen).
Funktionscode | Funktion |
---|---|
? |
Ein Fenster zeigt Ihnen, welche Funktionen für das markierte
Objekt zur Verfügung stehen. Es werden jeweils nur die Funktionen aufgeführt,
die für das betreffende Objekt auch tatsächlich möglich sind (zum Beispiel wird
Ihnen für eine Subroutine nicht die Funktion RU(N)
angeboten und für ein Objekt, das nur in Sourceform existiert, nicht die
Funktion EX(ECUTE) ).
In dem Fenster können Sie für das betreffende Objekt die gewünschte Funktion auswählen. |
CA |
Kompilieren und speichern in Objektform (entspricht dem
Systemkommando CATALOG ).
|
DE |
Löschen eines Objekts (entspricht dem Systemkommando
DELETE ).
|
DL |
Herunterladen (Download) des Objekts vom Großrechner auf einen Personal Computer (nur möglich, wenn Natural Connection installiert ist). |
ED |
Editieren des Sourcecodes (entspricht dem Systemkommando
EDIT ).
|
EX |
Ausführen des Objektmoduls (entspricht dem Systemkommando
EXECUTE ).
|
LC |
Anzeigen des in die Default-Codepage
*CODEPAGE
umgesetzten Sourcecodes des Objekts (entspricht dem Systemkommando
LIST object-name
CONVERTED ).
|
LD |
Anzeigen der Directory-Information zum Objekt (entspricht dem
Systemkommando LIST
DIRECTORY
object-name ).
|
LE |
Anzeigen des Sourcecodes des Objekts in expandierter Form
(entspricht LIST
object-name EXPAND
* ).
|
LF |
Formatierte Anzeige von Data Area oder Map (entspricht dem
Systemkommando LIST
object-name
FORMATTED ).
|
LI |
Anzeigen (List) des Sourcecodes. |
LN |
Anzeigen des Langnamens der Subroutine oder der Klasse (nur möglich, wenn ein katalogisiertes Objekt vorhanden ist) oder der Resource. |
NO |
Zeigt die während des Katalogisierens mit
CATALOG
verwendeten Natural Optimizer (NOC) Optionen (funktioniert nur, wenn ein
katalogisiertes Objekt existiert).
|
OP |
Zeigt die zu Beginn, die am Ende verwendeten und
die geänderten Compiler-Optionen, die beim Katalogisieren mit
CATALOG
verwendet wurden (funktioniert nur, wenn ein katalogisiertes Objekt existiert).
Die zu Beginn verwendeten und die geänderten Compiler-Optionen können nur bei Objekten angezeigt, werden, die mit Natural Version 4.2.5 oder höher katalogisiert wurden. |
PR |
Drucken (Print) des Sourcecodes. |
RE |
Umbenennen des Objekts (entspricht dem Systemkommando
RENAME ).
|
RU |
Kompilieren und Ausführen der Source (entspricht dem
Systemkommando RUN ).
|
ST |
Speichern in Source- und Objektform (entspricht dem
Systemkommando STOW ).
|
UC |
Löschen des Objektmoduls (entspricht dem Systemkommando
UNCATALOG ).
|
. |
Ende (Verlassen des Auswahllistenfensters). |
Das LIST
-Kommando bietet Ihnen die
Möglichkeit, die Liste der angezeigten Objekte nach mehreren Sortierkriterien
zu sortieren.
Anmerkung:
Damit Sie diese Funktion benutzen können, muss die Größe des vom
Sort-Programm benutzten Work Buffers mit dem Schlüsselwortparameter
WRKSIZE
des Natural-Profilparameters SORT
auf einen
ausreichenden Wert gesetzt werden. Die maximale Größe der Liste, die sortiert
werden kann, wird durch die Größe des Work Buffers begrenzt.
Um die Sort-Funktion aufzurufen
Drücken Sie PF4.
Oder:
Setzen Sie in der Liste der Objekte ein
SORT
-Unterkommando ab.
SORT |
|||||||||
TYPE |
ASCENDING
DESCENDING
|
||||||||
MODE |
|||||||||
VERSION |
|||||||||
USER |
|||||||||
DATE |
|||||||||
DT |
|||||||||
DATETIME |
|||||||||
TIME |
|||||||||
SIZE |
|||||||||
LINES |
|||||||||
BPSIZE |
|||||||||
DS |
|||||||||
DATSIZE |
|||||||||
CP |
|||||||||
CODE-PAGE |
|||||||||
MEMBER |
|||||||||
OFF |
Wenn Sie PF4 drücken, können Sie in einem Fenster angeben, ob Sie die Liste sotieren wollen (Y/N), ein Sort-Feld markieren und in auf- oder absteigender Reihenfolge sortieren wollen.
Sort-Feld | Schlüsselwort in Sort-Syntax |
---|---|
Natural object type | TYPE |
Programming mode (Reporting oder Structured mode) | MODE |
Version | VERSION |
User ID | USER |
Date | DATE |
Date and time | DATETIME |
Time | TIME |
Source size | SIZE |
Number of source lines | LINES |
Buffer pool size | BPSIZE |
DATSIZE (Größe des lokalen Daten-Buffers)
|
DS /DATSIZE |
Code page | CP /CODE-PAGE |
Member names of subroutines or classes (nur in der erweiterten Auswahlliste verfügbar) | MEMBER |
Um die Sort-Funktion auszuschalten
Geben Sie das Unterkommando SORT OFF
ein.
Oder:
Deaktivieren Sie die Sort-Funktion in dem mit PF4
aufgerufenen Fenster.
Die sortierte Liste wird in einem Natural-Textobjekt in der Library
WORKPLAN
erstellt. Der Name des Objekts wird durch das
LIST
-Kommando erzeugt. Wenn Sie das List-Profil
aufrufen (siehe Individuelles
List-Profil erstellen), können Sie den Namen für das
Textobjekt sowie die Library angeben.
Folgende Themen werden behandelt:
Wenn Ihnen der Sourcecode eines Objekts angezeigt wird, können Sie in der Kommandozeile eines der folgenden Kommandos eingeben.
Unterkommando | Funktion |
---|---|
+ |
Blättert ein Seite vor. |
- |
Blättert eine Seite zurück. |
++ |
Blättert ans Ende der Source. |
BOTTOM |
|
-- |
Blättert an den Anfang der Source. |
TOP |
|
+n |
Blättert n Zeilen vor. |
-n |
Blättert n Zeilen zurück. |
nnnn |
Blättert zu Zeile Nummer nnnn. |
CONVERTED |
Siehe CONVERTED bei
Options.
|
DBFNR
ON |
Zeigt die DBID und FNR der
Source-Library in der Kopfzeile des Sourcecodes.
|
DBFNR OFF |
Zeigt die Kopfzeile des Sourcecodes ohne die DBID
und FNR der Source-Library. Dies ist der Standardwert.
|
EXPAND |
Siehe expand-option. |
FIELDS |
Gilt nur für Maps: Zeigt das Field Summary, d.h. die Liste der Felder in der Maske. |
FIND
|
Zeigt nur die Sourcecode-Zeilen, in denen der angegebene Wert (value) vorkommt. Wenn Sie nur das Kommando Wenn Sie Wenn Sie |
FIND
value |
|
FIND ABSOLUTE
value |
|
FORMAT |
Gilt nur für Data Areas und Maps: zeigt die formatierte Data Area bzw. Map, sowie zur Map gehörige Informationen. |
LAYOUT |
Gilt nur für Maps. Zeigt das Layout der Map, d.h. die Map, wie Sie ein Benutzer zur Laufzeit sieht. |
NUMBERS ON |
Zeigt die Source mit Sourcecode-Zeilennummern. Dies ist der Standardwert. |
NUMBERS
OFF |
Zeigt die Source ohne Sourcecode-Zeilennummern. |
PRINT |
Druckt die Source. |
REF
|
Zeigt die Zeilennummer der Sourcecode-Zeilen, in
denen der angegebene Wert (value) vorkommt.
Wenn Sie nur das Kommando Wenn Sie Wenn Sie |
REF
value |
|
REF ABSOLUTE
value |
|
RULES |
Gilt nur für Maps. Zeigt die von der Map verwendeten Verarbeitungsregeln (Processing Rules). Die Rules werden in der Reihenfolge der Felder, denen sie zugewiesen sind, gezeigt und je Feld in der Reihenfolge des Rangs (Rank). |
SCAN
|
Zeigt alle Zeilen intensiviert an, in denen der
angegebene Wert (value) vorkommt. Die erste Zeile,
in der der Wert vorkommt, wird an den Anfang der Seite geblättert.
Wenn Sie nur das Kommando Wenn Sie Wenn Sie |
SCAN
value |
|
SCAN
ABSOLUTE value
|
|
SCAN= or
SC= |
Führt das letzte SCAN -Kommando
erneut aus. Alternativ können Sie PF5 drücken.
|
SETTINGS |
Gilt nur für Maps. Zeigt die Map Settings der Map. |
ZOOM
[expand-type...10]
object-name
|
Die Angabe eines einzelnen Namens (object-name) mit dem
ZOOM -Kommando hat die gleiche Auswirkung wie das
Markieren des Namens mit dem Cursor in der gelisteten Source (siehe
Cursor-sensitive
Objektauswahl). Das ausgewählte Objekt wird in einem
Fenster angezeigt.
Wenn Sie Stern-Notation (*) bzw. Wildcard-Notation (?) im object-name verwenden, werden alle ausgewählten Objekte in dem Fenster gezeigt, und zwar in der Reihenfolge, in der sie in der gelisteten Source referenziert werden. Die Angabe eines expand-type entspricht der expand-option. Für ein Objekt, das in einem über |
ZOOM
[expand-type...10]
object-name-range |
|
. |
Beenden. |
Anmerkung:
Standardmäßig werden die DBID
und FNR
der
Source-Library nicht in der Kopfzeile der aufgelisteten Source angezeigt. Wenn
Sie wollen, dass die DBID
und FNR
der Source-Library
angezeigt werden, können Sie entweder das Unterkommando
DBFNR ON
eingeben oder im List-Profil den Parameter
SOURCE-LIST-WITH-DBID-FNR
auf Y
setzen
(siehe Individuelles List-Profil
erstellen).
Dieses Unterkommando gilt nur für Data Areas (die mit
STOW
gespeichert wurden und bei denen der
Zeitstempel des Sourceobjekts und des katalogisierten Objekts identisch ist)
und für Maps.
Bei Data Areas entspricht dieses Unterkommando der Option
FORMATTED
.
Im List-Profil können Sie angeben, wie die Data Areas standardmäßig angezeigt werden sollen:
formatiert, d.h. die Anzeige ähnelt der in einem
DEFINE
DATA
-Statement oder
unformatiert, d.h. die Anzeige ähnelt der im Data-Area-Editor.
In der List der Objekte können Sie das Unterkommando
DEFINE-DATA
ON/OFF
benutzen, um den Standardwert für die Zeit zu
setzen, während der das LIST
-Kommando ausgeführt
wird.
Wenn Data Areas standardmäßig formatiert angezeigt werden und wenn es
nicht möglich ist, den Sourcecode der Data Area in das DEFINE
DATA
-Format umzusetzen, erscheint eine entsprechende Meldung und die
Data Area wird unformatiert angezeigt.
Wenn Sie das Unterkommando FORMAT
für eine
Map eingeben, erscheint ein Fenster, in dem Sie eine oder mehrere zusätzliche
Informationen auswählen können, die mit der Map angezeigt werden:
Map Settings (entspricht dem Unterkommando
SETTINGS
).
Map Layout (entspricht dem Unterkommando
LAYOUT
). Zusätzlich können Sie Füllzeichen für
Eingabefelder (AD=A
und AD=M
) und
Ausgabefelder (AD=O
) angeben, um diese Felder sichtbar
zu machen. Sie können ein beliebiges Zeichen als Füllzeichen angeben.
Field Summary (entspricht dem Unterkommando
FIELDS
).
Processing Rules (entspricht dem Unterkommando
RULES
).
Die von Ihnen gewählten Optionen werden nacheinander in der im Auswahlfenster vorhandenen Reihenfolge angezeigt.
Im FORMAT
-Modus stehen dieselben
Unterkommandos zum Blättern (Ausnahme: B) und die Unterkommandos
FIELDS
, LAYOUT
,
PRINT
, RULES
und
SETTINGS
zur Verfügung wie bei einer normal mit
LIST
angezeigten Source (siehe oben). Zusätzlich
sind zu jeder Option die nachfolgend beschriebenen Unterkommandos verfügbar.
S>n |
Verschieben des Map Layouts um n Spalten nach rechts. |
S<n |
Verschieben des Map Layouts um n Spalten nachlinks. |
EXTEND |
Zeigt erweiterte Feld-Etitierinformationen zu allen
Map-Feldern.
Um die erweiterten Feld-Etitierinformationen zu einem einzelnen angezeigten Feld anzuzeigen, markieren Sie den Namen des Feldes in der Field Summary List mit dem Cursor und drücken Sie ENTER. |
RULES
nn |
Zeigt die Verarbeitungsregeln, die mit dem Feld
nn verknüpft sind (wobei
nn für die fortlaufende Zeilennummer in der ersten
Spalte der Field Summary List steht).
Um die Verarbeitungsregeln zu einem einzelnen angezeigten Feld
anzuzeigen, geben Sie ein |
SCAN
[ABSOLUTE]
value |
Wie bei Unterkommandos für eine angezeigte Source. |
SCAN
= |
SCAN
[ABSOLUTE]
value |
Wie bei Unterkommandos für eine angezeigte Source. |
SCAN
= |
Innerhalb einer gelisteten Source können Sie mit dem Cursor den Namen eines Objektes, das in dieser Source referenziert wird, markieren; die Source des so ausgewählten Objektes wird dann in einem Fenster gezeigt.
Für die in dem Fenster gezeigte Source stehen Ihnen dieselben
Unterkommandos — außer PRINT
,
EXPAND
und ZOOM
— zur
Verfügung wie für eine "normal" gelistete Source
Sie können sich ihr eigenes, individuelles Profil für das
LIST
-Kommando erstellen. Für diesen Zweck bietet
Natural Ihnen das Textobjekt LISTPROF
in der Library
SYSLIB
.
In LISTPROF
können Sie allgemeine oder benutzerspezifische
Profile mit entsprechenden Standardwerten eintragen, zum Beispiel für
COUNT-SOURCE-LINES
. Diese Standardwerte werden verwendet, wenn Sie
das LIST
-Kommando ausführen.
Um die in LISTPROF definierten Werte zu aktivieren
Kopieren Sie das Textobjekt LISTPR-S
von der Library
SYSLIB
in eine beliebige Library.
Fügen Sie Ihre Änderungen hinzu.
Speichern Sie das Textobjekt LISTPR-S
unter dem Namen
LISTPROF
.
Speichern Sie das Textobjekt LISTPROF
in die Library
SYSLIB
.
Rufen Sie das LIST
-Kommando auf.
Eine ausführliche Beschreibung finden Sie im Textobjekt
LISTPR-S
in der Library SYSLIB
.