CATALL

#### Search Results

Search

# CATALL

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

Anmerkung
Predict muss installiert sein. Weitere Informationen zu Predict Sets siehe Predict-Dokumentation.

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

Anmerkung
Objekte des Typs Copycode und des Typs Text werden immer mit `SAVE` gespeichert, auch wenn Sie die Funktion `STOW` auswählen. Sie werden jedoch nicht gespeichert, wenn Sie `CATALOG` auswählen.

## 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-`CATAL`L-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

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.

### On this page

- 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