Die in den Natural-Systemdateien FNAT und FUSER gespeicherten Natural-Objekte sind in logische Konstrukte unterteilt, die als Libaries (Bibliotheken) bezeichnet werden. Eine Natural-Library dient dazu, Objekte nach bestimmten funktionalen Kriterien zusammenzufassen. So kann eine Library beispielsweise aus einem Satz von Objekten bestehen, die eine bestimmte Aufgabe zu erledigen haben. Wenn das Add-on-Produkt Natural Security installiert ist, kann man eine Library auch verwenden, um den Zugriff auf Objekte auf bestimmte Benutzergruppen, z.B. Administratoren, einzuschränken.

Eine Natural-Anwendung kann, je nachdem wie die Umgebung eingerichtet ist, auf Objekte in mehreren Libraries zugreifen.

Alle Operationen bei Libraries werden mit Hilfe von Menüfunktionen oder entsprechenden Kommandos ausgeführt. Siehe auch den Abschnitt Kommandos und Menü-Funktionen benutzen.

Dieser Abschnitt behandelt folgende Themen:

• In einer Library enthaltene Objekte

• Library-Typen

• Steplib-Libraries

• Suchreihenfolge bei der Objekt-Ausführung

• Standard-Library-Zuweisung

• Anmelden (Einloggen) bei einer Library

• Neue Library anlegen

• Libraries auflisten

• Objekte in einer Library auflisten

• Objektliste drucken

• Objekte in einer Library suchen

• Libraries kopieren, verschieben und umbenennen

• Objekte in einer Library löschen

Verwandte Themen:

• Natural-Systemdateien - System-Architektur-Dokumentation

• Libraries in Systemdateien - System-Architektur-Dokumentation

• Library Maintenance - Natural Security-Dokumentation

Siehe auch Namenskonventionen für Libraries.

---

In einer Library enthaltene Objekte

Eine Library enthält Objektmodule, d.h. Quellcode-Objekt ("Source-Objekt") und ggf. zugehöriges katalogisiertes Objekt, der folgenden Natural-Objekttypen: Programm, Subprogramm, Subroutine, Copycode, Helproutine, Class, Function, Text, Recording, Map, Local Data Area, Global Data Area, Parameter Data Area, Command Prozessor Source, Error Message, Dialog, Debug Environment, Adapter und Resource.

Verwandte Themen:

• Katalogisiertes Objekt

• Quellcode-Objekt

Library-Typen

Im folgenden Abschnitt werden die verschiedenen Typen von Libraries vorgestellt:

• Benutzer-Library

• System-Library

Benutzer-Library

Eine Benutzer-Library enthält Objekte einer Benutzer-Anwendung, die speziell zu dieser Anwendung gehören und zum Ausführen dieser Anwendung benötigt werden. Benutzer-Libraries sind in der Systemdatei FUSER untergebracht.

System-Library

Die Pflege einer System-Library obliegt der Software AG. System-Libraries sind in der Systemdatei FNAT untergebracht.

In einer System-Library sind alle Objekte enthalten, die zum Ausführen einer Natural-Systemanwendung benötigt werden.

Darüber hinaus gibt es System-Libraries, die Objekte des Typs Programm enthalten, die zu Demonstrationszwecken geliefert werden, siehe Beispiel-Libraries.

Auf die System-Libraries SYSLIB und SYSLIBS können Sie nicht zugreifen. Diese sind zur internen Verwendung durch die Software AG bestimmt. Wenn Sie es dennoch versuchen, erhalten Sie die Fehlermeldung: Libraries SYSLIB and SYSLIBS reserved for system usage.

Steplib-Libraries

Eine Steplib ist eine Natural-Benutzer-Library oder System-Library, die mit der aktuellen Benutzer- oder System-Library verkettet ist. Eine Steplib kann als alleiniger Speicherort für mehrere Objekte dienen, die von verschiedenen Anwendungen gemeinsam genutzt werden. Dadurch wird die redundante Speicherung von identischen Objekten vermieden und die Strukturierung von Anwendungen erleichtert.

Eine Steplib ist eine Library, in der Natural sucht, wenn ein Objekt in der aktuellen Library nicht gefunden werden konnte (siehe auch den folgende Abschnitte). Als Standard-Steplibs dienen die Libraries SYSTEM in den Systemdateien FUSER und FNAT.

Verwandte Themen in der Parameter-Referenz-Dokumentation:

• STEPLIB - Zusätzliche Steplib Library

• BPSFI - Objektsuche zuerst im Buffer Pool

Dieser Abschnitt behandelt folgende Themen:

• Zusätzliche Steplibs bei Einsatz von Natural Security

• Zusätzliche Steplibs ohne Einsatz von Natural Security

• Überprüfen der Steplib-Einstellung

Zusätzliche Steplibs bei Einsatz von Natural Security

Wenn Natural Security aktiv ist, können Sie im Security-Profil zu jeder Library zusätzliche Steplibs festlegen. Die Einträge in einem Library-Security-Profil haben Vorrang vor jeglichen außerhalb von Natural Security vorgenommenen Festlegungen. Diese Steplibs werden nach einem Objekt durchsucht, bevor in den Standard-Steplibs SYSTEM in den Systemdateien FUSER und FNAT danach gesucht wird.

Verwandtes Thema:

• Steplibs - Natural Security-Dokumentation

Zusätzliche Steplibs ohne Einsatz von Natural Security

Wenn kein Natural Security aktiv ist, können Sie beim Session-Start eine zusätzliche Steplib mit Hilfe des Natural-Profilparameters STEPLIB angeben. Darüber hinaus können Sie weitere Steplibs unter Verwendung der Programmierschnittstellen (APIs, z.B. USR1025N oder USR3025N) definieren. Diese und weitere APIs finden Sie in der System-Library SYSEXT.

Diese Steplibs werden nach einem Objekt durchsucht, bevor in den Standard-Steplibs SYSTEM in den Systemdateien FUSER und FNAT danach gesucht wird.

Verwandtes Thema:

• STEPLIB - Zusätzliche Steplib Library - Parameter-Referenz-Dokumentation

Überprüfen der Steplib-Einstellung

Um die Steplib-Einstellung Ihrer aktuellen Library zu überprüfen

1. Geben Sie folgendes Systemkommando ein:

   TECH

   Das Fenster TECH erscheint.

2. Blättern Sie nach unten, indem Sie solange EINGABE drücken, bis die Tabelle mit der Spalte Steplib erscheint.

Verwandtes Thema:

• TECH - Systemkommandos-Dokumentation

Suchreihenfolge bei der Objekt-Ausführung

Dieser Abschnitt beschreibt, in welcher Reihenfolge Natural-Libraries und Systemdateien nach einem angeforderten Objekt durchsucht werden, das entweder aus einer Benutzer-Library oder einer System-Library heraus ausgeführt werden soll.

Suchreihenfolge nach Benutzer-Objekten, die aus einer Benutzer-Library ausgeführt werden sollen:

1. Die aktuelle Library in der Systemdatei FUSER gemäß Definition in der Systemvariablen *LIBRARY-ID.

2. Die Steplibs (sequenziell) gemäß Angaben im Natural-Security-Profil für die aktuelle Library oder in der Steplib-Tabelle.

3. Die Standard-Steplib gemäß Definition in der Systemvariablen *STEPLIB.

4. Die Library SYSTEM in der Systemdatei FUSER.

5. Die Library SYSTEM in der Systemdatei FNAT.

Suchreihenfolge nach einem Natural-Objekt, das aus einer System-Library ausgeführt werden soll:

1. Die aktuelle Library in der Systemdatei FNAT gemäß Definition durch die Systemvariable *LIBRARY-ID.

2. Die Steplibs (sequenziell) gemäß Angaben im Natural-Security-Profil für die aktuelle Library oder in der Steplib-Tabelle.

3. Die Library SYSLIBS in der Systemdatei FNAT, die Objekte enthält, die gemeinsam von Systemkommandos und Dienstprogrammen (Utilities) verwendet werden.

4. Die Library SYSTEM in der Systemdatei FNAT.

5. Die Library SYSTEM in der Systemdatei FUSER.

Da die Systemdatei FUSER zuletzt durchsucht wird, dürfen Sie ein Objekt, das sowohl in der Systemdatei FUSER als auch in FNAT verwendet wird (z.B. eine User Exit Routine für ein Natural-Dienstprogramm (Utility) nur an einer Stelle vorhalten, und zwar in FUSER.

Verwandte Themen in der Systemvariablen-Dokumentation:

• *LIBRARY-ID

• *STEPLIB

Standard-Library-Zuweisung

Wenn Sie eine Natural-Session starten, melden Sie Sie sich automatisch bei einer von Natural zugewiesenen Library ein. Auf Natural-Bildschirmen ist normalerweise ein Feld vorhanden (z.B. Library oder LIB=), in dem der Name (die Kennung) Ihrer Library angezeigt wird, d.h. die aktuelle Library (z.B. LIB=SYSTEM), in der Natural-Objekte gespeichert werden und aus der sie abgerufen werden.

Um festzustellen, welche Ihre aktuelle Library ist

• Geben Sie folgendes Systemkommando ein:

  TECH

  Das Fenster TECH erscheint. Der Name (die Kennung) der Library, in der Sie zurzeit angemeldet sind, wird im Feld Library angezeigt.

Wenn der Natural-Profilparameter AUTO auf OFF gesetzt ist, weist Natural Ihnen standardmäßig die Library ID SYSTEM zu. Sie können beim Starten der Session die Standard-Library ändern, indem Sie AUTO auf ON setzen. AUTO=ON bewirkt die automatische Anmeldung (Einloggen) bei der Library, die Ihrer Benutzerkennung entspricht.

Wenn Ihr Natural unter Natural Security läuft, gelten besondere Regeln für das Anmelden. Diese sind in der Natural Security-Dokumentation beschrieben.

Es kann sein, dass Sie sich bei einer anderen Library anmelden müssen, wenn Sie eine Verwaltungsfunktion ausführen oder an einer anderen Anwendung arbeiten möchten. Siehe Abschnitt Anmelden (Einloggen) bei einer Library.

Verwandte Themen:

• TECH - Systemkommandos-Dokumentation

• AUTO - Automatische Anmeldung - Parameter-Referenz-Dokumentation

• Logging On - Natural Security-Dokumentation

Anmelden (Einloggen) bei einer Library

Wenn Sie ein Natural-Objekt anlegen oder pflegen oder ein Natural-Programm in einer bestimmten Library ausführen möchten, müssen Sie unter Umständen zuerst die Library wechseln und sich bei der Library oder Steplib (siehe Steplib-Libraries) anmelden, die das Objekt enthält bzw. aufnehmen soll.

Zum Anmelden bei einer Library benutzen Sie normalerweise das Systemkommando LOGON. Wenn Ihr Natural unter Natural Security läuft, gelten besondere Regeln. Diese sind in der Natural Security-Dokumentation beschrieben.

Nach dem erfolgreichen Anmelden bei einer Library, die noch keine Objekte enthält, lautet die Bestätigungsmeldung: This library is empty (Diese Library ist leer).

Darüber hinaus können Sie auch das Systemkommando LIST (siehe Objekte in einer Library auflisten) benutzen, um festzustellen, ob eine Library leer ist.

Die Library, bei der Sie sich angemeldet haben, bleibt solange aktiv, bis Sie sich bei einer anderen Library anmelden oder Ihre Natural-Session beenden.

Um sich bei einer anderen Library anzumelden

1. Geben Sie folgendes Systemkommando ein:

   LOGON library-ID

   Dabei ist library-ID der Name (Kennung) der Library, auf die Sie zugreifen wollen.

   Oder:
   Im Natural-Hauptmemü oder einem der untergeordneten Menüs:

   Überschreiben Sie in der rechten oberen Ecke des Bildschirms im Feld Library die dort vorhandene Library-Kennung mit der Kennung der gewünschten Library (siehe auch Beispiel für eine Menü-Funktion.

2. Drücken Sie EINGABE.

   Vorausgesetzt, die von Ihnen eingegebene Library ID erfüllt Namenskonventionen für Libraries, dann erscheint die folgende Meldung zur Bestätigung: Logon in Library library-ID accepted (Anmeldung bei Library library-ID akzeptiert).

Verwandte Themen:

• LOGON und LOGOFF - Systemkommandos-Dokumentation

• Logging On - Natural Security-Dokumentation

Neue Library anlegen

Um eine neue Library anzulegen, benutzen Sie entweder das Systemkommando LOGON, mit dem Sie eine leere Library erhalten, in der Sie ein Objekt erstellen können, oder Sie verwenden die Verschieben-(Move-) oder Kopier-(Copy-)Funktion eines Natural-Dienstprogramms (Utility), wenn Sie Objekte übertragen.

Um eine neue Library anzulegen

1. Wenn Sie das Systemkommando LOGON benutzen, folgen Sie der Beschreibung im Abschnitt Anmelden (Einloggen) bei einer Library. Geben Sie die ID der neuen Library an. Diese enthält noch keine Objekte. Legen Sie in dieser Library mindestens ein katalogisiertes Objekt oder ein Quellcode-Objekt an.

2. Wenn Sie Objekte aus einer vorhandenen Library in eine neue Library verschieben oder kopieren möchten, folgen Sie der Beschreibung im Abschnitt Libraries kopieren, verschieben und umbenennen.

Libraries auflisten

Eine Liste aller in Ihrer aktuellen Natural-Systemumgebung vorhandenen Libraries erhalten Sie, indem Sie die Utility SYSMAIN benutzen.

Um alle Libraries mittels Menüfunktionen aufzulisten

1. Wählen Sie im Natural-Hauptmenü den Eintrag Pflegen und Übertragen von Objekten aus.

   Drücken Sie EINGABE.

   Der Bildschirm Pflegen und Übertragen von Objekten erscheint.

2. Wählen Sie Übertragen von Objekten in andere Libraries - SYSMAIN

   Oder:
   Geben Sie in der Kommandozeile das folgende Systemkommando ein:

   SYSMAIN

   Drücken Sie EINGABE.

   Das Hauptmenü des Dienstprogramms (Utility) SYSMAIN erscheint, zum Beispiel:

   12:10:14 ***** NATURAL SYSMAIN UTILITY ***** 2022-11-18 User SAG - Main Menu - Code Object Code Function A Programming Objects C Copy D Debug Environments D Delete E Error Message Texts F Find P Profiles L List R Rules M Move S DL/I Subfiles R Rename V DDMs ? Help X Predict Sets ? Help . Exit . Exit Object Code .. A Function Code .. _ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Copy Del Find List Move Ren

3. Geben Sie im Feld Object Code ein A ein (Standardeinstellung), um alle Libraries aufzulisten, die Natural-Objekte (Fehlermeldungen und Debug-Umgebungen) enthalten. (Für Fehlermeldungen müssen Sie ein E eingeben, für Debug-Umgebungen ein D).

4. Geben Sie im Feld Function Code ein L (für List) ein.

   Drücken Sie EINGABE.

   Es erscheint der Bildschirm List Programming Objects.

5. Geben Sie im Feld Code ein A ein, um nach Libraries zu suchen, die alle Arten von Objektmodulen enthalten: katalogisierte Objekte und Quelcode-Objekte.

   Geben Sie im Feld Source Library einen Stern (*) ein, um nach allen Libraries zu suchen.

   (Informationen zu gültigen Namensbereichen siehe Angabe eines Namensbereichs in der SYSMAIN-Dokumentation.)

   Lassen Sie die übrigen Eingabefelder unverändert.

6. Drücken Sie EINGABE.

   Es erscheint der Bildschirm Library Selection. Er enthält eine Liste aller in der aktuellen Systemdatei vorhandenen Libraries.

   Drücken Sie EINGABE, um in der Liste nach unten zu blättern.

Auf dem Bildschirm Library Selection können Sie eine bestimmte Library auswählen und die in ihr enthaltenen Objekte auflisten. Weitere Informationen finden Sie im Abschnitt Library Selection, siehe Verwandtes Thema weiter unten.

Um alle Libraries mit einem Kommando aufzulisten

1. Geben Sie das folgende Kommando in der Kommandozeile ein:

   SYSMAIN LIST ALL * IN LIBRARY *

2. Drücken Sie EINGABE.

   Der Bildschirm Library Selection erscheint mit einer Liste aller in der aktuellen Systemdatei vorhandenen Libraries.

Verwandtes Thema:

• Auflisten und Auswählen von Libraries in der SYSMAIN-Dokumentation

Objekte in einer Library auflisten

Eine Liste der in einer Library enthaltenen Objekte erhalten Sie, indem Sie entweder das Systemkommando LIST oder die entsprechende Funktion des Natural-Dienstprogramms (Utility) SYSMAIN oder den Object Handler benutzen.

Dieser Abschnitt beschreibt, wie Sie sich eine Liste von Objekten mit Hilfe des Systemkommandos LIST anzeigen lassen können.

Um Objekte mit LIST aufzulisten

1. Geben Sie das folgende Kommando ein:

   LIST *

   Dabei bedeutet die Angabe eines Sterns (*), dass alle Quellcode-(Source-)Objekte und alle katalogisierten Objekte aufgelistet werden sollen.

   (siehe auch: object-name-range im Abschnitt LIST in der Systemkommandos-Dokumentation).

2. Drücken Sie EINGABE.

   Es erscheint der Bildschirm LIST Objects in a Library (siehe Beispiel). Er enthält eine Liste der Quellcode-Objekte und der katalogisierten Objekte, die in der aktuellen Library (in diesem Beispiel: TEST) in der aktuellen Systemdatei vorhanden sind.

   18:27:05 ***** NATURAL LIST COMMAND ***** 2022-11-23 User SAG - LIST Objects in a Library - Library TEST Cmd Name Type S/C SM Version User ID Date Time --- *________ *__________ *__ * *______ *________ *__________ *________ __ COPYLDA Copycode S R SAG 2012-07-23 17:58:19 __ DEMOSPGM Subprogram S/C S SAG 2012-07-23 17:58:34 __ EMP-L Local S/C SAG 2012-07-23 17:58:47 __ GDATEST Global S SAG 2012-07-24 10:09:25 __ HELPR1 Helproutine S/C S SAG 2012-07-24 10:02:59 __ LDATEST Local S/C SAG 2012-07-23 17:59:16 __ MAPTEST Map S/C S SAG 2012-07-24 10:04:44 __ MAP01 Map S/C S SAG 2012-07-24 10:04:25 __ PDASTUB Subprogram S/C S SAG 2012-07-24 10:03:41 __ PDATEST Parameter S/C SAG 2012-07-24 10:03:47 __ PGMTEST Program S/C S SAG 2012-07-24 10:03:53 __ PGM01 Program S S SAG 2012-07-23 17:59:02 __ SUBPGM1 Subprogram S S SAG 2012-07-23 17:59:08 __ SUBRTEST Subroutine S/C R SAG 2012-07-24 10:07:58 14 Objects found Top of List. Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Print Exit Sort -- - + ++ > Canc

   Sortiert ist die Liste nach dem Objektnamen (in der Spalte Name). Sie enthält zusätzlich Informationen zu jedem Objekt (z. B. den Objekttyp: Program), zur Art des vorhandenen Objektmoduls (in der Spalte S/C: S = Quellcode-Objekt, C = katalogisiertes Objekt) und die Benutzerkennung (User ID) des Benutzers, der das Objekt angelegt oder geändert hat.

Auf dem Bildschirm LIST Objects in a Library können Sie ein Objekt zur weiteren Verarbeitung auswählen. Sie können sich z. B. den Quellcode eines Objekts anzeigen lassen oder Objekte aus einer Library löschen. Siehe Um Objekte mit LIST zu löschen.

Weitere Informationen zum Bildschirm LIST Objects in a Library sowie zu weiteren Optionen, die Ihnen beim Systemkommando LIST zur Verfügung stehen, siehe Verwandte Themen unten.

Verwandte Themen:

• object-name-range - LIST, Systemkommandos-Dokumentation

• Bedeutung der Spaltenüberschriften - LIST, Systemkommandos-Dokumentation

• Liste der Objekte sortieren - LIST, Systemkommandos-Dokumentation

• Eine Funktion auf einem Objekt ausführen - LIST, Systemkommandos-Dokumentation

Objektliste drucken

Sie können sich eine Liste der in der aktuellen Library in der aktuellen Systemdatei enthaltenen Objekte ausdrucken lassen.

Um eine Objektliste zu drucken

1. Geben Sie das folgende Kommando ein:

   LIST *

   Dabei bedeutet die Angabe eines Sterns (*), dass alle Quellcode-(Source-)Objekte und alle katalogisierten Objekte aufgelistet werden sollen.

   (Siehe auch: object-name-range im Abschnitt LIST in der Systemkommandos-Dokumentation).

   Drücken Sie EINGABE.

2. Drücken Sie PF2 (Print).

   Es erscheint das Fenster PRINT, zum Beispiel:

   +--------------- PRINT ---------------+ ! ! ! Page Size for Print ... 60 ! ! Destination ........... DAECOP09 ! ! Start Printing (Y/N) .. Y ! ! ! +-------------------------------------+

3. Geben Sie im Feld Destination einen gültigen Druckernamen ein. (Fragen Sie ggf. Ihren Natural-Administrator nach dem Namen eines in Ihrer Umgebung zur Verfügung stehenden Druckers.) Falls Sie dies wünschen, können Sie im Feld Page Size for Print die Seitenlänge ändern (standardmäßig hat eine Seite 60 Zeilen).

4. Drücken Sie EINGABE.

   Es erscheint der Bildschirm Printout Specification, auf dem Sie Druckereinstellungen, z. B. die Anzahl der zu druckenden Exemplare vornehmen können.

5. Drücken Sie EINGABE.

   Die Liste der in der Library enthaltenen Objekte wird auf dem angegebenen Drucker gedruckt.

Verwandte Themen:

• Objekte drucken

• LIST - Systemkommandos-Dokumentation

Objekte in einer Library suchen

Sie können die in der Liste angezeigten Objekte weiter eingrenzen, indem Sie zusätzliche Auswahlkriterien angeben, z. B. die Benutzerkennung (ID) des Benutzers, der ein bestimmtes Objekt oder eine bestimmte Zeichenkette in einem Objekt-Quellcode (Source) angelegt hat.

Dieser Abschnitt beschreibt, wie Sie unter Angabe von Suchkriterien Objekte suchen können. Dazu können Sie entweder die Utility SYSMAIN oder das Systemkommando SCAN benutzen.

• Objekte suchen mit SYSMAIN

• Objekte durchsuchen mittels Systemkommando SCAN

Objekte suchen mit SYSMAIN

Der folgende Abschnitt enthält Beispiele dafür, wie Sie Objekte durch Angabe von Suchkriterien suchen können, indem Sie entweder die Funktionen des SYSMAIN-Menüs oder das entsprechende Kommando benutzen.

Objekte mit Hilfe der Menüfunktionen suchen

Um Objekte mit SYSMAIN zu suchen

1. Wählen Sie im Natural-Hauptmenü den Eintrag Pflegen und Übertragen von Objekten aus.

   Drücken Sie EINGABE.

   Der Bildschirm Pflegen und Übertragen von Objekten wird angezeigt.

   Wählen Sie Übertragen von Objekten in andere Libraries - SYSMAIN

   Oder:
   Geben Sie in der Natural-Kommandozeile das folgende Kommando ein:

   SYSMAIN

   Drücken Sie EINGABE.

   Das Hauptmenü der Utility SYSMAIN wird angezeigt.

2. Geben Sie im Feld Object Code ein A (für Programming Objects) ein (Standardeinstellung), um nach allen Objekttypen zu suchen.

   Ausnahmen: Für Fehlermeldungen müssen Sie ein E (für Error Message Texts), für Debug-Umgebungen ein D (für Debug Environments) eingeben.

   Geben Sie im Feld Function Code ein F für (Find) ein.

3. Drücken Sie EINGABE.

   Der Bildschirm Find Programming Objects wird angezeigt (Beispiel):

   09:07:25 ***** NATURAL SYSMAIN UTILITY ***** 2022-11-24 User SAG - Find Programming Objects - Code Function A Find All/Individual Objects C Find only Cataloged Objects S Find only Saved Objects W Find only Stowed Objects ? Help . Exit Code ...... _ Object Name ...... *________ Type ........ _______________ Source Library ... TEST____ Database .... 10___ File .. 32___ Options Criteria .... N Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Copy Del Find List Move Ren Fsec Fdic Fnat

4. Geben Sie im Feld Code ein A (für Find All/Individual Objects) ein, um nach allen Arten von Objektmodulen zu suchen: katalogisierte Objekte und Quellcode-(Source-)Objekte.

   Geben Sie im Feld Object Name einen Stern (*) ein, um nach allen Objektnamen zu suchen. Dies ist die Standardeinstellung.

   (Gültige Namensbereiche siehe Angabe eines Namensbereichs in der SYSMAIN Utility-Dokumentation.)

   Geben Sie im Feld Source Library die Kennung (ID) der Library ein, die die zu suchenden Objekte enthält.

   Überschreiben Sie im Feld Criteria das N (No) durch Y (Yes). N ist die Standardeinstellung.

   Lassen Sie alle übrigen Eingabefelder unverändert.

5. Drücken Sie EINGABE.

   Es erscheint das Fenster Additional Criteria (zusätzliche Kriterien), in dem Sie Suchkriterien eingeben können, zum Beispiel:

   09:12:30 ***** NATURAL SYSMAIN UTILITY ***** 2022-11-24 User SAG - Find Programming Objects - +------------------------------------------+ ! --- Additional Criteria --- ! ! ! ! Object Type ..... PM__________________ ! ! Date/Time From .. 2022-01-01 _____ ! ! Date/Time To .... 2022-11-24 _____ ! ! User ID ......... SAG______ ! ! Terminal ID ..... ________ ! ! ! ! ! ! ! Code .. ! Command ===> ! Object Name .. ! ! +------------------------------------------+ Source Library ... TEST____ Database .... 10___ File .. 32___ Options Criteria .... Y Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Copy Del Find List Move Ren Fsec Fdic Fnat

6. Geben Sie eines oder mehrere Suchkriterien ein und drücken Sie EINGABE.

   Das Fenster wird geschlossen. Ein Plus-Zeichen (+) vor dem Feld Criteria zeigt an, dass in dem Fenster außer dem Objekttyp noch andere Suchkriterien angegeben wurden.

   + Criteria .... N

7. Drücken Sie noch einmal EINGABE.

   Der Bildschirm Find Selection erscheint. Er enthält eine Liste aller Quellcode-Objekte und katalogisierten Objekte, die in der angegebenen Library in der aktuellen Systemdatei vorhanden sind.

   In dem obigen Beispiel werden alle Objekte der Typen P (Programm) und M (Map) angezeigt, die zwischen 2022-01-01 und 2022-11-24 durch den Benutzer SAG angelegt oder geändert wurden.

8. Drücken Sie EINGABE, um in der Liste nach unten zu blättern, bis die folgende Meldung erscheint: Library has been successfully listed (Die Library wurde erfolgreich aufgelistet.).

Auf dem Bildschirm Find Selection haben Sie die Möglichkeit, ein Objekt zur Weiterverarbeitung auszuwählen, zum Beispiel, können Sie sich den Quellcode eines Objekts anzeigen lassen. Siehe Auswahllisten für Programmierobjekte in der SYSMAIN Utility-Dokumentation.

Verwandtes Thema:

• Menüfunktionen und Kommandos benutzen in der SYSMAIN Utility-Dokumentation

Objekte direkt mittels Kommando SYSMAIN suchen

Um Objekte direkt mittels Kommando SYSMAIN zu suchen

1. Geben Sie das folgende Kommando ein:

   SYSMAIN FIND ALL * TYPE PN WITH USER  user-ID IN library-ID

   Dabei gibt ALL an, dass alle Quellcode-(Source-)Objekte und katalogisierten Objekte in die Suche einbezogen werden sollen.

   Der Stern (*) gibt an, dass alle Objektnamen in die Suche einbezogen werden sollen (siehe auch: Angabe eines Namensbereichs in der SYSMAIN Utility-Dokumentation).

   PN gibt die Objekttypen an, nach denen gesucht werden soll (P bedeutet Programm, N bedeutet Subprogramm.

   library-ID ist die Kennung (ID) der zu durchsuchenden Library.

   user-ID ist die Benutzerkennung (ID) des Benutzers, nach dem gesucht werden soll.

2. Drücken Sie EINGABE.

   Es erscheint der Bildschirm Find Selection. Er enthält eine Liste aller Quellcode-(Source-)Objekte und katalogisierten Objekte der Typen Programm und Subprogramm, die von dem angegebenen Benutzer angelegt oder geändert wurden.

Verwandtes Thema:

• Schlüsselwörter und Variablen in Direktkommandos in der SYSMAIN Utility-Dokumentation

Objekte durchsuchen mittels Systemkommando SCAN

Der folgende Abschnitt enthält Beispiele dafür, wie Sie Objekte finden können, indem Sie ihre Quellcode-(Source-)Objekte nach einer bestimmten Zeichenkette mit Hilfe des Systemkommandos SCAN durchsuchen.

• Objekte mit Hilfe des SCAN-Menüs durchsuchen
• Objekte direkt mittels Systemkommando SCAN durchsuchen

Objekte mit Hilfe des SCAN-Menüs durchsuchen

Um Quellcode-(Source-)Objekte mit Hilfe von Menüfunktionen zu durchsuchen

1. Geben Sie in der Natural-Kommandozeile das folgende Systemkommando ein:

   SCAN

2. Drücken Sie EINGABE.

   Der Bildschirm Scan Objects in Libraries erscheint (siehe folgendes Beispiel). Sie können hier einen Objektbereich und einen Suchwert eingeben:

   12:50:55 ***** NATURAL SCAN COMMAND ***** 2022-11-18 User SAG - Scan Objects in Libraries - Library TEST Code Function T Statistics L List of Objects Containing Scan Value S Object Lines with Scan Value ? Help . Exit Code ................ L Scan value .......... LOCAL___________________________ Replace value ....... GLOBAL__________________________ Library ............. TESTLIB_ Object name ......... *________ Selection list .... N Object type(s) ...... *_____________ Absolute scan ....... N Trace ............. N Predict set number .. __ Predict set user .. ________ Ignore case ......... N Ignore comments ... N Defaults from SCAN profile (SCANPROF) read. Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Prof

   Geben Sie im Feld Code ein L (für List of Objects Containing Scan Value) ein und geben Sie einen Suchwert, eine Library und einen Objektbereich ein. Mit Stern-Notation (*) können Sie alle Objektnamen und Objekttypen auswählen.

   Geben Sie im Feld Replace value eine Zeichenkette (z. B. GLOBAL) ein, durch die der angegebene Suchwert (z. B. LOCAL) ersetzt werden soll.

3. Drücken Sie EINGABE.

   Der Bildschirm Select Objects for Library erscheint. Er enthält für die angegebene Library in der aktuellen Systemdatei eine Liste aller Quellcode-Objekte, die die angegebenen Suchkriterien erfüllen. Im Fall des obigen Beipiels werden alle Objekte in der Library TESTLIB ausgewählt, die die Zeichenkette LOCAL enthalten.

   Auf dem Bildschirm Select Objects for Library können Sie ein Objekt auswählen und die Source-Zeile, die den Suchwert enthält, anzeigen oder ändern.

   Weitere Informationen zum Bildschirm Scan Objects in Libraries siehe Menü-Optionen in der Beschreibung des Systemkommandos SCAN in der Systemkommandos-Dokumentation

Objekte direkt mittels Systemkommando SCAN durchsuchen

Um Quellcode-(Source-)Objekte mittels Direktkommando zu durchsuchen

1. Geben Sie in der Natural-Kommandozeile das folgende Kommando ein:

   SCAN FUNC=L,SVAL=scan-value,LIB=library-ID,*

   Dabei ist:

   scan-value die Zeichenkette (z. B. LOCAL), nach der die Sourcen durchsucht werden sollen.

   library-ID library-ID die ID der Library, die durchsucht werden soll (z. B. TESTLIB).

   Verwenden Sie Stern-Notation (*), wenn nach allen Quellcode-Objekten in der Library gesucht werden soll.

2. Drücken Sie EINGABE.

Weitere Informationen siehe SCAN mittels Direktkommando in der Systemkommandos-Dokumentation

Libraries kopieren, verschieben und umbenennen

Sie können eine Library kopieren oder verschieben, indem Sie alle Natural-Objekte von einer Quell-Library in eine vorhandene oder neue Ziel-Library kopieren oder verschieben.

Beim Umbenennen einer Library sind dieselben Schritte wie beim Verschieben einer Library nötig. Sobald alle Objekte einer Library in eine neue Ziel-Library verschoben worden sind, wird die alte Library automatisch gelöscht.

Sie können einzelne oder mehrere Objekte von einer Library in eine andere Library kopieren oder verschieben, indem Sie entweder das Natural-Dienstprogramm (Utility) SYSMAIN oder den Object Handler benutzen.

Dieser Abschnitt enthält Beispiele für das Kopieren oder Verschieben aller Objekte mit SYSMAIN, und zwar mit Hilfe von Menüfunktionen oder den entsprechenden Kommandos.

• Objekte mit Hilfe von SYSMAIN-Menüfunktionen kopieren oder verschieben

• Objekte mit Hilfe von Direktkommandos kopieren oder verschieben

Objekte mit Hilfe von SYSMAIN-Menüfunktionen kopieren oder verschieben

Um alle Objekte mit Hilfe von SYSMAIN-Menüfunktionen zu kopieren oder zu verschieben

1. Rufen Sie das Hauptmenü des Dienstprogramms (Utility) SYSMAIN auf.

2. Geben Sie im Feld Object Code ein A ein (Standardeinstellung), um alle Objekttypen auszuwählen.

   (Ausnahmen: für Fehlermeldungen (Error Messages) geben Sie ein E, für Debug-Umgebungen (Debug Environments) ein D ein.)

   Geben Sie im Feld Function Code ein C (für Copy) oder ein M (für Move) ein.

3. Drücken Sie EINGABE.

   Je nachdem, welchen Funktionscode Sie eingegeben haben, erscheint entweder der Bildschirm Copy Programming Objects oder der Bildschirm Move Programming Objects.

4. Geben Sie im Feld Code ein A ein, um alle Arten von Objektmodulen auszuwählen: katalogisierte Objekte und Quellcode-(Source-)Objekte.

   Überschreiben Sie im Feld Sel. List (Selection List) das Y (Yes) mit einem N (No). Y ist die Standardeinstellung.

   Geben Sie im Feld Object Name einen Stern (*) ein, um alle Objektnamen auszuwählen. Dies ist die Standardeinstellung.

   (Informationen zu gültigen Namensbereichen finden Sie unter Angabe eines Namensbereichs in der SYSMAIN Utility-Dokumentation.)

   Geben Sie im Feld Source Library die Kennung (ID) der Library ein, die die zu kopierenden oder zu verschiebenden Objekte enthält.

   Geben Sie im Feld Target Library die Kennung (ID) einer vorhandenen oder einer neuen Library ein, in die Sie die Objekte kopieren oder verschieben wollen.

   Alle anderen Eingabefelder lassen Sie unverändert.

5. Drücken Sie EINGABE.

   Alle Quellcode-(Source-)Objekte und katalogisierten Objekte werden von der angegebenen Quell- in die Ziel-Library in der aktuellen Systemdatei kopiert bzw. verschoben. Danach erscheint die Meldung Function completed successfully (Funktion erfolgreich beendet).

Objekte mit Hilfe von Direktkommandos kopieren oder verschieben

Um alle Objekte mit Hilfe von Direktkommandos zu kopieren oder zu verschieben

1. Geben Sie eines der folgenden Kommandos ein:

   SYSMAIN COPY ALL * FM old-library TO new-library

   (kopiert Objekte)

   bzw.

   SYSMAIN MOVE ALL * FM old-library TO new-library

   (verschiebt Objekte)

   Dabei gibt ALL an, dass alle Quellcode-(Source-)Objekte und katalogisierten Objekte ausgewählt werden sollen.

   Der Stern (*) gibt an, dass alle Objektnamen ausgewählt werden sollen (siehe auch Angabe eines Namensbereichs in der SYSMAIN Utility-Dokumentation).

   old-library ist die ID der Library, die die zu kopierenden oder zu verschiebenden Objekte enthält.

   new-library ist die ID einer vorhandenen oder neuen Library (siehe auch Namenskonventionen für Libraries).

2. Drücken Sie EINGABE.

   Wenn der Kopier- oder Verschiebevorgang erfolgreich beendet wurde, wird das verarbeitete Kommando angezeigt, und die folgende Meldung erscheint: Function completed successfully (Funktion erfolgreich beendet).

Weitere Informationen zu den Funktionen, die Ihnen beim Dienstprogramm (Utility) SYSMAIN zur Verfügung stehen, zum Beispiel zum Ersetzen (Replace) und Umbenennen (Rename) von Objekten, finden Sie unter Beschreibung der Funktionen des Dienstprogramms SYSMAIN in der Debugger und Dienstprogramme-Dokumentation.

Objekte in einer Library löschen

Eine Library wird in einer Natural-Umgebung nur so lange gepflegt, wie sie wenigstens ein Quellcode-(Source-)Objekt oder ein katalogisiertes Objekt enthält. Wenn Sie in einer Library alle Objekte löschen, ist diese Library nicht mehr vorhanden.

Sie können einzelne oder mehrere Objekte aus einer Library löschen, indem Sie das Systemkommando LIST oder eine Natural-Utility benutzen.

Die folgende Anleitung enthält Beispiele dafür, wie Sie Objekte mit Hilfe des Systemkommandos LIST aus der aktuellen Library löschen können und wie Sie unter Verwendung der Menüfunktionen bzw. Kommandos der Utility SYSMAIN Objekte aus einer anderen Library löschen können.

Objekte mit LIST-Kommando löschen

Um Objekte mit dem LIST-Kommando zu löschen

1. Geben Sie folgendes Kommando ein:

   LIST *

   Der Stern (*) gibt an, dass alle Quellcode-(Source-)Objekte und katalogisierten Objekte aufgelistet werden sollen.

   (siehe auch object-name-range im Abschnitt LIST in der Systemkommandos-Dokumentation).

2. Drücken Sie EINGABE.

   Es erscheint der Bildschirm LIST Objects in a Library. Er enthält eine Liste der in der aktuellen Library in der aktuellen Systemdatei vorhandenen Quellcode-(Source-)Objekte und katalogisierten Objekte.

3. Geben Sie in der Spalte Cmd neben dem oder den gewünschten Objekt oder Objekten folgendes Zeilenkommando ein:

   DE

   Siehe auch den Beispielschirm weiter unten.

4. Drücken Sie EINGABE.

   Es erscheint ein DELETE-Fenster (ähnlich dem unten gezeigten):

   17:04:25 ***** NATURAL LIST COMMAND ***** 2010-03-01 User SAG - LIST Objects in a Library - Library TEST Cmd Name Type S/C SM Version User ID Date Time --- *________ *__________ *__ * *______ *________ *__________ *________ DE COPYLDA Co +---------------DELETE---------------+ 010-03-01 15:10:48 DE DEMOSPGM Su | | 010-02-05 19:00:08 DE EMP-L Lo | Please select one item: | 010-03-01 15:31:31 DE GDATEST Gl | | 010-03-01 15:23:37 __ HELPR1 He | _ Confirm each deletion | 010-03-01 15:13:12 __ LDATEST Lo | _ Delete without confirmation | 010-02-05 18:49:14 __ MAPTEST Ma | _ Exit (no deletion) | 010-03-01 15:14:16 __ PDASTUB Su | | 010-03-01 15:31:18 __ PDATEST Pa +------------------------------------+ 010-03-01 15:31:24 __ PGM01 Program S S SAG 2010-03-01 15:29:31 __ SUBPGM1 Subprogram S S SAG 2010-03-01 15:25:02 __ SUBRTEST Subroutine S/C R SAG 2010-03-01 15:30:12 __ TESTPGM Program S S SAG 2010-03-01 15:26:40 __ TEXTTEST Text S SAG 2010-03-01 15:05:23 Top of List. Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Print Exit Sort -- - + ++ > Canc

5. Wählen Sie eine Option aus, indem Sie ein beliebiges Zeichen in dem Feld neben der gewünschten Option eingeben und EINGABE drücken:

   Wenn Sie Confirm each deletion wählen, erscheint ein Fenster zu jedem zu löschenden Objekt, in dem Sie jeweils den Namen des Objekts eingeben müssen, um die Löschung zu bestätigen.
   Wenn Sie Delete without confirmation wählen, erfolgt die Löschung sofort.
   Wenn Sie Exit wählen, erfolgt keine Löschung, und das Fenster verschwindet.

Objekte mit SYSMAIN-Menüfunktionen löschen

Um Objekte mit SYSMAIN-Menüfunktionen zu löschen

1. Rufen Sie das Hauptmenü des Dienstprogramms (Utility) SYSMAIN auf.

2. Geben Sie im Feld Object Code ein A ein (Standardeinstellung), um alle Typen von Objekten auszuwählen.

   (Ausnahmen: Für Fehlermeldungen geben Sie ein E, für Debug-Umgebungen ein D ein.)

   Geben Sie im Feld Function Code ein D (Delete) ein.

3. Drücken Sie EINGABE.

   Der Bildschirm Delete Programming Objects erscheint.

4. Geben Sie im Feld Code ein A ein, um alle Arten von Objekten auszuwählen: katalogisierte Objekte und Quellcode-(Source-)Objekte.

   Überschreiben Sie im Feld Sel. List (Selection List) das Y (Yes) mit einem N (No). Y ist die Standardeinstellung.

   Geben Sie im Feld Object Name einen Stern (*) ein, um alle Objektnamen auszuwählen. Dies ist die Standardeinstellung.

   (Bezüglich gültiger Namensbereiche siehe Angabe eines Namensbereichs in der SYSMAIN Utility-Dokumentation.)

   Geben Sie im Feld Source Library die Kennung (ID) der Library ein, die Sie löschen möchten.

   Die übrigen Eingabefelder lassen Sie unverändert.

5. Drücken Sie EINGABE.

   In der angegebenen Library in der aktuellen Systemdatei werden alle Quellcode-(Source-)Objekte und katalogisierten Objekte gelöscht, und es erscheint die folgende Meldung: Function completed successfully (Funktion erfolgreich ausgeführt).

Objekte mit einem SYSMAIN-Kommando löschen

Um alle Objekte mit einem SYSMAIN-Kommando zu löschen

1. Geben Sie folgendes Kommando ein:

   SYSMAIN DELETE ALL * FM library-ID

   Dabei gibt ALL an, dass alle Quellcode-(Source-)Objekte und katalogisierten Objekte ausgewählt werden sollen.

   Der Stern (*) gibt an, dass alle Objektnamen ausgewählt werden sollen (siehe auch Angabe eines Namensbereichs in der SYSMAIN Utility-Dokumentation).

   library-ID ist die Kennung (ID) der Library, die die zu löschen Objekte enthält.

2. Drücken Sie EINGABE.

   Wenn der Löschvorgang erfolgreich beendet wurde, wird das verarbeitete Kommando angezeigt, und die folgende Meldung erscheint: Function completed successfully (Funktion erfolgreich beendet).