|
|
|||||||||||||
|
|
|
|
|
[options ...] |
|
||||||||
SAVE |
|||||||||||||
CATALL |
object-name
[TO
object-name] |
RECAT |
[TYPES
types]
|
CATALOG |
|||||||||
ALL
|
STOW |
||||||||||||
CHECK |
|||||||||||||
| text-name |
Mit dem Systemkommando CATALL können Sie alle
Objekte in der aktuellen Library gleichzeitig in Source- und/oder Objektform
speichern.
Wenn Sie das Kommando CATALL ohne zusätzliche
Optionen eingeben, erscheint der Schirm Catalog Objects in
Library auf dem Sie die nachfolgend beschriebenen Funktionen
auswählen können. Sie können das Kommando CATALL
aber auch als Direktkommando unter Verwendung der oben dargestellten
Syntax benutzen.
Außerdem können Sie mit Hilfe des Subprogramms CATALLU2
standardmäßig Funktionen auf dem Catalog Objects in
Library-Schirm auswählen. Darüber hinaus können Sie mit
CATALLU2 auswählen, ob der User Exit in Batch und/oder im Command
Mode aufgerufen wird. Dieses Subprogramm wird in Source-Form in der Library
SYSTEM (FNAT) mitgeliefert. Um das Subprogramm zu
aktivieren, müssen Sie es entsprechend den Angaben in der Source modifizieren,
es anschließend katalogisieren und in die Library SYSLIB kopieren.
Das Subprogramm wird aufgerufen, bevor der Schirm Catalog Objects in
Library ausgegeben wird.
Siehe auch Object Naming Conventions in der Using Natural-Dokumentation.
Dieses Dokument beschreibt die Funktionen des Catalog Objects in Library-Schirms.
Wenn Sie CATALL für alle Objekte der
ausgewählten Typen in der aktuellen Library ausführen möchten, geben Sie einen
Stern (*) als Objektname im from-Feld ein.
Wenn Sie CATALL nur für einen bestimmten
Bereich von Objekten ausführen möchten, können Sie im
from-Feld Stern-Notation (*) und Wildcard-Notation (?) für
den Namen verwenden, und zwar in der gleichen Weise wie beim Systemkommando
LIST beschrieben.
Sie können auch einen Anfangs- und Endwert für einen bestimmten Bereich von Objekten angeben, indem Sie in den beiden Feldern from und to entsprechende Objektnamen (ohne Stern- oder Wildcard-Notation) eingeben.
Statt in diese Felder Werte einzugeben, können Sie auch Objekte von einer Auswahlliste auswählen (siehe unten).
Sie haben auch die Möglichkeit, im from-Feld den
Namen eines Objekts vom Typ Text anzugeben, der eine Liste von
CATALL-Kommandos enthält. Die in dem Text
enthaltenen CATALL-Kommandos werden dann ausgeführt.
Sie können einen solchen Text entweder von Hand erstellen oder bei Verwendung
der Auswahlliste (siehe
unten) automatisch erstellen.
Diese Option gilt nur für die Funktionen Catalog und Stow:
Wenn Sie das erste der beiden Felder markieren, werden nur die Objekte neu katalogisiert, die in der aktuellen Library bereits in Objekt-Form vorhanden sind; Objekte, die nur in Source-Form vorhanden sind, werden nicht katalogisiert.
Wenn Sie das zweite der beiden Felder markieren, werden alle ausgewählten Objekte katalogisiert.
Anmerkung:
Diese Option gilt nicht für Objekte vom Typ Copycode und
Text.
Standardmäßig gilt CATALL für Objekte
jeglichen Objekttyps in der aktuellen Library (alle Objekttypen sind mit X
markiert).
Wenn Sie bestimmte Objekttypen vom CATALL
ausnehmen möchten, überschreiben Sie das betreffende X mit einem
Leerzeichen.
Sie können eine der folgenden Funktionen auswählen, die für die
ausgewählten Objekte ausgeführt werden soll: SAVE,
CATALOG,
STOW oder
CHECK. Die
Funktionen entsprechen den gleichnamigen Systemkommandos.
Anmerkung:
Objekte vom Typ Copycode und Text werden immer mit
SAVE gespeichert, auch wenn Sie die Funktion
STOW auswählen. Sie werden jedoch nicht gespeichert,
wenn Sie CATALOG auswählen.
Sie können eine oder mehrere der folgenden Optionen für die
CATALL-Verarbeitung auswählen:
| Condition Code in Batch | Wenn Sie CATALL im Batch-Betrieb
ausführen und diese Option mit einem Zeichen markieren, wird Condition Code 55
zurückgegeben, falls entweder bei der
CATALL-Ausführung ein Syntaxfehler entdeckt wird
oder innerhalb des angegebenen Bereiches zu verarbeitender Objekte keine
Objekte gefunden wurden (nur bei CATALOG und
STOW
möglich).
|
|---|---|
| Renumber Source-Code Lines | Standardmäßig werden mit den Funktionen
SAVE und STOW die
Sourcecode-Zeilen von Source-Objekten auch neu numeriert.
Wenn Sie keine automatische Neunumierung der Zeilen wünschen, überschreiben Sie das X in diesem Feld mit einem Leerzeichen. |
| Keep Result List | CATALL erzeugt eine Ergebnisliste.
Wenn Sie diese Liste für den weiteren Gebrauch aufheben möchten, markieren Sie
dieses Feld mit einem Zeichen.
Die Library Sie können die Ergebnisliste auch mit einem weiteren
|
| Processing Information |
Online zeigt CATALL während der Verarbeitung eine laufende Anzeige von Verarbeitungsstatus-Informationen. Während der Batch-Verarbeitung gibt
Wenn Sie diese Anzeige nicht wünschen, überschreiben Sie das X in diesem Feld mit einem Leerzeichen. |
| Error Report | Am Ende der Verarbeitung zeigt CATALL
eine Liste der aufgetretenen Fehler an.
Wenn Sie diese Fehlerliste nicht wünschen, überschreiben Sie das X in diesem Feld mit einem Leerzeichen. |
| Extended Error Report | Der Fehlerbericht wird in erweiterter Form ausgegeben,
einschließlich der Verzeichnisinformationen, Fehlerzeile und Fehlermeldung.
Wenn Sie den erweiterten Fehlerbericht wünschen, markieren Sie dieses Feld mit einem X. |
| PF4 AddOp |
Nach Drücken von PF4 erscheint ein Fenster, in dem Sie zusätzliche Optionen auswählen oder eingeben können. Error Text Member: Geben Sie hier den Namen
eines Natural-Text-Members ein. Es wird eine Liste der bei einem
|
Wenn Sie CATALL nur für bestimmte Objekte
ausführen möchten, können Sie die gewünschten Objekte von einer Auswahlliste
auswählen.
Hierzu machen Sie zunächst die gewünschten Angaben unter Select Function und Select Options und drücken dann PF5. Sie erhalten dann eine Liste der in der aktuellen Library gespeicherten Objekte.
Die Liste entspricht der des Systemkommandos
LIST. Auch das Blättern in der Auswahlliste und die
Angabe neuer Kriterien für die Auswahlliste erfolgt in der gleichen Weise wie
beim LIST-Kommando.
Auf der Liste wählen Sie die gewünschten Objekte aus, indem Sie sie in der Spalte Cmd mit einem Zeichen markieren. Um alle Objekte der aktuellen Auswahlliste gleichzeitig auszuwählen, drücken Sie PF5. Anschließend können Sie in der Liste blättern, andere Auswahlkriterien angeben und weitere Objekte auswählen.
Nachdem Sie alle gewünschten Objekte ausgewählt haben, drücken Sie PF3.
Dann erscheint ein Fenster, das Ihnen die Möglichkeit bietet, die
getroffene Objektauswahl zu speichern, um sie für spätere
CATALL-Verarbeitungen wiederzuverwenden:
Falls Sie in das Fenster einen Namen eingeben, wird die getroffene
Auswahl (in Form von CATALL-Kommandos) automatisch
in einem Objekt vom Typ Text dieses Namens gespeichert. Dieser Text-Name kann
später im Feld Catalog
Objects from des Catalog Objects in
Library-Schirms eingegeben werden (vgl. oben).
Falls Sie dies nicht wünschen, drücken Sie EINGABE ohne einen Namen in das Fenster einzugeben.
Anschließend beginnt CATALL, die ausgewählten
Objekte zu verarbeiten.
Für die verschiedenen Angaben, die Sie auf dem Catalog Objects
in Library-Schirm machen können, gibt es auch entsprechende
Optionen, die Sie direkt mit dem Systemkommando
CATALL angeben können:
| object-name TO object-name | Entspricht den Feldern Catalog Objects from und to des Catalog Objects in Library-Schirms, siehe Catalog Objects from/to. | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RECAT / ALL | Entspricht den Optionen Recatalog Only Existing
Modules oder Catalog All Sources des
Catalog Objects in Library-Schirms. RECAT ist
der Standardwert, siehe Recatalog Only Existing Modules, or
Catalog All Sources.
|
|||||||||||||||||||||||||||||||||
| TYPES types | Entspricht den markierten Objekttypen des Catalog
Objects in Library-Schirms, siehe
Select Object
Types. Mögliche types sind:
Die types müssen als eine
Zeichenkette angegeben werden (z.B. |
|||||||||||||||||||||||||||||||||
| SAVE / CATALOG / STOW / CHECK | Entspricht den gleichnamigen Funktionen des Catalog
Objects in Library-Schirms, siehe
Select
Function. CATALOG ist der
Standardwert.
|
|||||||||||||||||||||||||||||||||
| options |
|
|||||||||||||||||||||||||||||||||
| text-name | Entspricht der Angabe eines Text-Namens im Catalog Objects from-Feld des Catalog Objects in Library-Schirms, siehe Catalog Objects from/to. | |||||||||||||||||||||||||||||||||
Beispiele:
Um nur die Objekte in Source- und Objektform zu speichern, für die
schon Objektmodule vorhanden sind
Geben Sie folgendes Kommando ein:
CATALL * STOW KEEP CC NOREN
Dieses Kommando enthält ein implizites RECAT und bewirkt
dasselbe wie folgendes Kommando:
CATALL * RECAT STOW KEEP CC NOREN
Um alle Objekte in Source- und Objektform zu speichern
Geben Sie folgendes Kommando ein:
CATALL * ALL STOW KEEP CC NOREN
Anmerkung:
Die einzelnen Bestandteile des Kommandos müssen durch ein
Leerzeichen oder durch das Eingabebegrenzungszeichen (wie mit dem
Session-Parameter ID festgelegt)
voneinander getrennt werden.
