Version 4.2.6
 —  Systemkommandos  —

CATALL

 

   

 

     

 

  [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.


Catalog Objects from/to

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.

Seitenanfang

Recatalog Only Existing Modules, or Catalog All Sources

Diese Option gilt nur für die Funktionen Catalog und Stow:

Anmerkung:
Diese Option gilt nicht für Objekte vom Typ Copycode und Text.

Seitenanfang

Select Object Types

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.

Seitenanfang

Select Function

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.

Seitenanfang

Select Options

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 SYSEXT enthält eine Programmierschnittstelle (API) USR1024N, mit der Sie die Ergebnisliste ausgeben können.

Sie können die Ergebnisliste auch mit einem weiteren CATALL-Kommando wieder zur Anzeige bringen. Weil die Parameter ebenfalls in der Ergebnisliste gespeichert werden, sind die Parameter des CATALL-Kommandos, mit dem die Ergebnisliste erstellt wurde, gültig. In diesem Fall bewirkt das Batch-CATALL-Kommando die Ausgabe einer Meldung, und weil keine Module katalogisiert werden, wird der Job mit dem Condition Code 56 beendet. Online werden Sie, falls eine Library eine Ergebnisliste enthält, gefragt, ob die vorherige Liste angezeigt oder ein neuer CATALL-Lauf gestartet werden soll.

Processing Information

Online zeigt CATALL während der Verarbeitung eine laufende Anzeige von Verarbeitungsstatus-Informationen.

Während der Batch-Verarbeitung gibt CATALL nur diejenigen Module aus, die einen Fehler verursacht haben.

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 CATALL-Lauf aufgetretenen Fehler in dieses Text Member geschrieben.

Seitenanfang

Auswahlliste

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:

Anschließend beginnt CATALL, die ausgewählten Objekte zu verarbeiten.

Seitenanfang

Direktkommando-Syntax

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:
G - Global Data Areas
A - Parameter Data Areas
L - Local Data Areas
C - Copycodes
T - Texte
S - Subroutinen
N - Subprogrammme
H - Helproutinen
M - Maps
P - Programme
4 - Klassen
* - Alle Typen (gilt standardmäßig)

Die types müssen als eine Zeichenkette angegeben werden (z.B. LAG für Local, Parameter und Global Data Areas). Standardmäßig gilt CATALL für alle Objektarten in der aktuellen Library.

SAVE / CATALOG / STOW / CHECK Entspricht den gleichnamigen Funktionen des Catalog Objects in Library-Schirms, siehe Select Function. CATALOG ist der Standardwert.
options
Diese Optionen entsprechen den Select Options auf dem Catalog Objects in Library-Screen, siehe Select Options. Mögliche options sind:
CC Condition Code wird zurückgegeben.
NOREN  Keine automatische Neunummerierung von Sourcecode-Zeilen.
KEEP Ergebnisliste wird aufbewahrt.
NOSCROLL Online: Keine laufende Anzeige von Verarbeitungsstatus-Informationen. Batch: Ausgabe derjenigen Module, die einen Fehler verursacht haben.
NOREPORT Keine Fehlerliste.
FULL Erweiterte Fehlerliste.
EL <text-member> [R]
EL <text-member> Ausgabe der Fehlerliste in ein Natural Text Member.
R Wenn ein Text Member existiert, ist der EL-Parameter funktionslos, wenn kein R (Replace) nach <text-member> angegeben wird.

Anmerkung:
Bei Angabe von NOREPORT und NOSCROLL, gilt automatisch auch KEEP.

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:

Beginn der AnweisungslisteUm nur die Objekte in Source- und Objektform zu speichern, für die schon Objektmodule vorhanden sind

Beginn der AnweisungslisteUm alle Objekte in Source- und Objektform zu speichern

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.

Seitenanfang