CATALL

object-name [TO object-name] {XSET / XREFSET} set-number [SETUSER set-user]

RECAT ALL

[TYPES types]

SAVE CATALOG STOW CHECK

[options ...]

text-name

Mit dem Systemkommando CATALL können Sie einzelne oder mehrere Natural-Objekte in der aktuellen Natural-Library katalogisieren (kompilieren) und speichern.

Wenn Sie das Kommando CATALL ohne zusätzliche Optionen eingeben, erscheint der Schirm Objekte in Library katalogisieren, 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.

Alle Objekte werden in der Reihenfolge verarbeitet, in der sie im Schirm Objekte in Library katalogisieren aufgelistet sind (siehe auch Informationen zu TYPES im Abschnitt Direktkommando-Syntax.

Außerdem können Sie mit Hilfe des Subprogramms CATALLU2 standardmäßig Funktionen auf dem Objekte in Library katalogisieren-Schirm auswählen. Darüber hinaus können Sie auswählen, ob CATALLU2 im Batch Mode oder im Command Mode aufgerufen wird. Dieses Subprogramm wird in Quellcode-Form in der Library SYSTEM (FNAT) mitgeliefert. Um das Subprogramm zu aktivieren, müssen Sie es entsprechend den Angaben im Quellcode modifizieren, es anschließend katalogisieren und in die Library SYSLIB kopieren. Das Subprogramm wird aufgerufen, bevor der Schirm Objekte in Library katalogisieren ausgegeben wird.

Siehe auch Namenskonventionen für Objekte im Dokument Natural benutzen.

Dieses Dokument behandelt folgende Themen:

• Objekte katalogisieren von/bis

• Predict Set und Set Benutzer

• Vorhandene Module neu katalogisieren oder alle Quellcode-Objekte katalogisieren

• Objekttypen auswählen

• Funktion auswählen

• Optionen auswählen

• Auswahlliste

• Direktkommando-Syntax

---

Objekte katalogisieren von/bis

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 aus einer Auswahlliste übernehmen (siehe unten).

Sie haben außerdem die Möglichkeit, im from-Feld den Namen eines Objekts vom Typ Text anzugeben, das 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 unter Benutzung der Auswahlliste (siehe unten) automatisch erstellen.

Predict Set und Set Benutzer

Wenn Sie CATALL für die Objekte eines Predict Set ausführen möchten, geben Sie im Feld Predict Set eine ein- bzw. zweistellige Zahl an, die den Retained Set bezeichnet, welcher für die Namen der zu verarbeitenden Objekte verwendet werden soll.

Wenn Sie einen Predict Set verwenden, dürfen Sie die Felder von und bis nicht benutzen. Zusätzlich können Sie im Feld Set Benutzer die Benutzerkennung des Benutzers angeben, der den Predict Set erstellt hat. Wenn Sie keine Benutzerkennung angeben, wird der Wert der Systemvariablen *USER verwendet.

Ein Retained Set wird mit der Save Set-Option des Systemkommandos LIST XREF erstellt.

Vorhandene Module neu katalogisieren oder alle Quellcode-Objekte katalogisieren

Diese Option bewirkt Folgendes:

• Wenn Sie das Feld Nur katalogisierte Objekte auswählen markieren, werden nur die Quellcode-Objekte in der aktuellen Library katalogisiert, die bereits früher katalogisiert worden waren (ein entsprechendes katalogisiertes Objekt existiert).

• Wenn Sie das Feld Alle Source-Objekte auswählen markieren, werden alle Quellcode-Objekte (mit oder ohne entsprechende katalogisierte Objekte) in der aktuellen Library katalogisiert.

Objekttypen auswählen

Standardmäßig gilt CATALL für Objekte jeglichen Objekttyps in der aktuellen Library (alle Objekttypen sind mit X markiert).

Wenn Sie bestimmte Objekttypen von der Verarbeitung durch CATALL ausnehmen möchten, überschreiben Sie das betreffende X mit einem Leerzeichen.

Funktion auswählen

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.

Optionen auswählen

Sie können eine oder mehrere der folgenden Optionen für die CATALL-Verarbeitung auswählen:

Option	Erklärung
Condition Code im 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 (gilt nur bei CATALOG und STOW).
Quellcode-Zeilen neu numerieren	Standardmäßig werden mit den Funktionen SAVE und STOW die Quellcode-Zeilen von Quellcode-Objekten, die mit SAVE oder STOW bearbeitet wurden, auch neu numeriert. Wenn Sie keine automatische Neunumierung der Zeilen wünschen, überschreiben Sie das X in diesem Feld mit einem Leerzeichen.
Ergebnisliste speichern	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 Anwendungsprogrammierschnittstelle (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 Objekte 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 Ergebnisliste angezeigt oder ein neuer CATALL-Lauf gestartet werden soll.
Verarbeitungsinformationen	Während der Online-Verarbeitung zeigt CATALL eine fortlaufende Anzeige von Verarbeitungsstatus-Informationen. Während der Batch-Verarbeitung gibt CATALL nur diejenigen Objekte aus, die einen Fehler verursacht haben. Wenn Sie diese Anzeige nicht wünschen, überschreiben Sie das X in diesem Feld mit einem Leerzeichen.
Fehlerreport	Am Ende der Verarbeitung zeigt CATALL eine Liste der aufgetretenen Fehler an. Wenn Sie die Anzeige dieser Fehlerliste nicht wünschen, überschreiben Sie das X in diesem Feld mit einem Leerzeichen.
Erweiterter Fehlerreport	Der Fehlerbericht wird in erweiterter Form ausgegeben, einschließlich 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. Report-Text-Objekt: Geben Sie hier den Namen eines Natural-Text-Objekts ein. Es wird ein Bericht über die bei einem CATALL-Lauf aufgetretenen Fehler in dieses Text-Objekt geschrieben.

Auswahlliste

Wenn Sie CATALL nur für bestimmte Objekte ausführen möchten, können Sie die gewünschten Objekte aus einer Auswahlliste übernehmen.

Hierzu machen Sie zunächst die gewünschten Angaben unter Funktion auswählen und Optionen auswählen und drücken dann PF5. Es wird eine Liste der in der aktuellen Library gespeicherten Objekte angezeigt.

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.

Aus 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/oder weitere Objekte auswählen.

Nachdem Sie alle gewünschten Objekte ausgewählt haben, drücken Sie PF3.

Es 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 Objekte katalogisieren von im Bildschirm Objekte in Library katalogisieren eingegeben werden.

• Falls Sie dies nicht wünschen, geben Sie in das Fenster nichts ein, und drücken Sie EINGABE.

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

Direktkommando-Syntax

Für die verschiedenen Angaben, die Sie auf dem Schirm Objekte in Library katalogisieren 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 Objekte katalogisieren von und bis des Bildschirms Objekte in Library katalogisieren, siehe Objekte katalogisieren von/bis.
{XSET / XREFSET} set-number	Enstpricht dem Feld Predict Set im Bildschirm Objekte in Library katalogisieren, siehe Predict Set und Set User.
[SETUSER set-user]	Enstpricht dem Feld Set Benutzer im Bildschirm Objekte in Library katalogisieren, siehe Predict Set und Set User.
RECAT / ALL	Entspricht den Optionen Nur katalogisierte Objekte auswählen oder Alle Source-Objekte auswählen des Bildschirms Objekte in Library katalogisieren. RECAT ist der Standardwert, siehe Vorhandene Module neu katalogisieren oder alle Quellecode-Objekte katalogisieren.
TYPES types	Entspricht den markierten Objekttypen des Bildschirms Objekte in Library katalogisieren. Mögliche (in der unten aufgeführten Reihenfolge verarbeitete) types sind: G - Global Data Areas L - Local Data Areas A - Parameter Data Areas C - Copycodes T - Texte 7 - Functions N - Subprogrammme S - Externe Subroutinen H - Helproutinen M - Maps 8 - Adapter P - Programme 4 - Classes * - 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 Bildschirms Objekte in Library katalogisieren, siehe Funktion auswählen. CATALOG ist der Standardwert.
options	Diese Optionen entsprechen den Optionen auswählen auf dem Bildschirm Objekte in Library katalogisieren, siehe Optionen auswählen. Mögliche options sind: CC Condition Code wird zurückgegeben. NOREN  Keine automatische Neunummerierung von Quellcode-Zeilen. KEEP Ergebnisliste wird aufbewahrt. NOSCROLL Online: Keine laufende Anzeige von Verarbeitungsstatus-Informationen. Batch: Ausgabe derjenigen Objekte, die einen Fehler verursacht haben. NOREPORT Keine Fehlerliste. FULL Erweiterte Fehlerliste. EL <text-object> [R] EL text-object Ausgabe der Fehlerliste in ein Natural-Text-Objekt. R Wenn ein Objekt schon existiert, ist der EL-Parameter funktionslos, wenn kein R (Replace/Ersetzen) nach text-object angegeben wird. Anmerkung: Bei Angabe von NOREPORT und NOSCROLL, gilt automatisch auch KEEP.
text-name	Entspricht der Angabe eines Text-Namens im Feld Objekte katalogisieren von des Bildschirms Objekte in Library katalogisieren, siehe Objekte katalogisieren von/bis.

Beispiele:

Um nur die Objekte in Quellcode- und Objektform zu speichern, für die schon ein katalogisiertes Objekt vorhanden ist:

• 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 Quellcode- und Objektform zu speichern

• Geben Sie folgendes Kommando ein:

  CATALL * ALL STOW KEEP CC NOREN