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

Alle Objekte werden in der Reihenfolge verarbeitet, in der sie im Schirm Catalog Objects in Library 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 Catalog Objects in Library-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 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 Namenskonventionen für Objekte im Dokument Natural benutzen.

Dieses Dokument behandelt folgende Themen:


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 von einer Auswahlliste auswählen (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 beibehaltenen Set ("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 from und to nicht benutzen. Zusätzlich können Sie im Feld Set User die Benutzerkennung des Benutzers angeben, der den Predict Set erstellt hat. Wenn Sie keine Benutzerkennung angeben, wird der Wert der Systemvariablen *USER verwendet.

Ein beibehaltener 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 Sourcen katalogisieren

Diese Option bewirkt Folgendes:

  • Wenn Sie das Feld Select cataloged source objects only markieren, werden nur die Source-Objekte in der aktuellen Library katalogisiert, die bereits früher katalogisiert worden waren (ein entsprechendes katalogisiertes Objekt existiert).

  • Wenn Sie das Feld Select all source objects markieren, werden alle Source-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).
Sourcecode-Zeilen neu numerieren Standardmäßig werden mit den Funktionen SAVE und STOW die Sourcecode-Zeilen von Source-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 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. 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 Objekte in Library katalogisieren-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 Objekte katalogisieren von und bis des Objekte in Library katalogisieren-Schirms, siehe Objekte katalogisieren von/bis.
{XSET / XREFSET} set-number Enstpricht dem Feld Predict Set im Schirm Objekte in Library katalogisieren, siehe Predict Set und Set Benutzer.
[SETUSER set-user] Enstpricht dem Feld Set Benutzer im Schirm Objekte in Library katalogisieren, siehe Predict Set und Set Benutzer.
RECAT / ALL Entspricht den Optionen Vorhandene Module neu katalogisieren oder Alle Sourcen katalogisieren des Objekte in Library katalogisieren-Schirms. RECAT ist der Standardwert, siehe Vorhandene Module neu katalogisieren oder Alle Sourcen katalogisieren.
TYPES types Entspricht den markierten Objekttypen des Catalog Objects in Library-Schirms. 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 - Funktionen (Functions)
N - Subprogrammme
S - Externe Subroutinen
H - Helproutinen
M - Maps
8 - Adapter
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 Objekte in Library katalogisieren-Schirms, siehe Funktion auswählen. CATALOG ist der Standardwert.
options
Diese Optionen entsprechen den Optionen auswählen auf dem Objekte in Library katalogisieren-Schirm, siehe Optionen auswählen. 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 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 Objekte katalogisieren von-Feld des Objekte in Library katalogisieren-Schirms, siehe Objekte katalogisieren von/bis.

Beispiele:

Beginn der AnweisungslisteUm nur die Objekte in Source- 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 

Beginn der AnweisungslisteUm 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.