INPL Utility

#### Search Results

Search

# INPL Utility

Mit dem Dienstprogramm INPL (Initial Natural Program Load) können Sie Natural-Objekte aus von der Software AG gelieferten Datasets (Dateien) laden und scannen.

Dieses Dokument ist in die folgenden Abschnitte untergliedert:

- Einführung in das Dienstprogramm INPL

- Load Libraries Only - Nur Libraries laden

- Load DDMs Only - Nur DDMs laden

- Load Error Messages Only - Nur Fehlermeldungen laden

- Load All Objects - Alle Objekte laden

- Replace Product Installation - Produktinstallation ersetzen

- Scan INPL File - INPL-Datei scannen

- Natural Security Recover - Initialisierung der Natural Security-Umgebung erzwingen

- User-Exit-Routinen

## Einführung in das Dienstprogramm INPL

Das Dienstprogramm INPL verarbeitet die von der Software AG bereitgestellten Natural-Objekte.

Das folgende Diagramm zeigt das Funktionsprinzip des Dienstprogramms INPL:

Die Natural-Objekte werden als Installations- oder Update-Datasets (Dateien) geliefert, die der Arbeitsdatei 1 (Work File 1) zugeordnet werden. Das Dienstprogramm INPL lädt die Natural-Objekte aus Arbeitsdatei 1 in Natural-Systemdateien.

Zu den Natural-Objekten gehören katalogisierte Objekte und Quellcodeobjekte, die in Libraries in den Natural-Systemdateien FNAT und FUSER oder in der Systemdatei FDIC, in der DDMs (Datendefinitionsmodule) gespeichert werden, enthalten sind.

Neben dem Laden von Natural-Objekten bietet das Dienstprogramm INPL folgende Funktionen:

- Eine Scan-Funktion zur Überprüfung des Inhalts des der Arbeitsdatei 1 zugeordneten Dataset und eine Natural Security Recover-Funktion, die die Initialisierung der Natural Security-Umgebung erzwingt.

- Laden von Korrekturen (Fixes) für die Natural Business Services, die Natural-Objekte, Construct-Modelle, Construct-Rahmen und Construct-Hilfetexte enthalten, wenn die Natural Business Services 5.3.1.8 oder höher installiert sind und die INPL-Funktion Load All Objects ausgeführt wird.

  Wenn Fixes für Natural Business Services geladen werden, wird `PRINTER(1)` für den Natural Business Services-Load Report verwendet und muss entsprechend definiert werden.

Tritt während der INPL-Ausführung ein Fehler auf, wird der INPL-Vorgang unterbrochen und mit dem Condition Code 40 vorzeitig beendet.

In diesem Abschnitt werden die folgenden Themen behandelt:

- Restriktionen

- Sonderfälle

- Dienstprogramm INPL aufrufen

- Verfügbare Optionen

- INPL-Report

- Prüfkommandos

### Restriktionen

Sie können nur Datasets (Dateien) verarbeiten, die als "SAG system INPL data set (file)" gekennzeichnet sind.

### Sonderfälle

In allen folgenden Fällen muss das INPL-Kommando über den dynamischen Natural-Profilparameter `STACK` angegeben werden:

- wenn ein INPL bei einer leeren FNAT-Systemdatei ausgeführt werden soll,

- wenn ein neues Upgrade-INPL durchgeführt werden soll,

- wenn eine bestehende Produktinstallation ersetzt werden soll,

- wenn eine INPL-Verarbeitung in einer Natural Security-Umgebung durchgeführt werden soll.

### Dienstprogramm INPL aufrufen

Um das Dienstprogramm INPL aufzurufen:

1. Geben Sie das folgende Natural-Systemkommando ein:

       INPL

   Es wird ein INPL-Menü ähnlich dem folgenden Beispiel angezeigt:

       10:56:15               ***** NATURAL INPL UTILITY *****             2022-07-19
       User: SAG                                                    Library: SYSTEM
                            Code   Function

                              L    Load Libraries Only
                              D    Load DDMs Only
                              E    Load Error Messages Only
                              B    Load All Objects
                              P    Replace Product Installation
                              S    Scan INPL File
                              R    Natural Security Recover
                              ?    Help
                              .    Exit

                Code ........ B
                Replace ..... Y  (Y/N/P/O)   Load Except . N  (Y/N)
                DDM Name ....
                Library .....
                Object Name .                Date ........             (YYYY-MM-DD)
                Check Date .. N  (Y/N)       Number ...... 0

2. Im INPL-Menü können Sie eine der folgenden Funktionen auswählen, indem Sie den entsprechenden Funktionscode in das Feld Code eingeben:

   Code | Funktion | Beschreibung siehe:
   --- | --- | ---
   `L` | Load Libraries Only | Nur Libraries laden
   `D` | Load DDMs Only | Nur DDMs laden
   `E` | Load Error Messages Only | Nur Fehlermeldungen laden
   `B` | Load All Objects | Alle Objekte laden
   `P` | Replace Product Installation | Produktinstallation ersetzen
   `S` | Scan INPL File | INPL-Datei scannen
   `R` | Natural Security Recover | Natural Security Recover

   Ausführliche Informationen zu diesen Funktionen finden Sie in den angegebenen Abschnitten.

3. Ändern oder ergänzen Sie die übrigen Eingabefelder wie unter Verfügbare Optionen beschrieben.

4. Drücken Sie Enter, um Ihre Eingaben zu bestätigen.

### Verfügbare Optionen

Der folgende Abschnitt beschreibt die Eingabefelder im INPL-Menü, in denen Sie einen oder mehrere Parameter als Objektauswahlkriterien für die im Feld Code angegebene INPL-Funktion angeben können. Die Verwendung eines Parameters hängt von der jeweiligen Funktion ab, wie in den entsprechenden Abschnitten in dieser Dokumentation angegeben.

Feld | Beschreibung
--- | ---
Replace | Ersetzen Gibt an, ob die zu verarbeitenden Natural-Objekte bereits in den Systemdateien vorhandene Objekte ersetzen sollen. Mögliche Einstellungen:
`Y` | Alle vorhandenen Objekte werden ersetzt. Dies ist die Standardeinstellung.
`N` | Vorhandene Objekte werden nicht ersetzt.
`P` | Alle vorhandenen Objekte werden ersetzt. Zusätzlich werden vorhandene Natural- oder Natural-Add-on-Produktinstallationen ersetzt, abhängig von den entsprechenden Prüfkommandos (siehe unten), die während der INPL-Verarbeitung ausgeführt werden.
`O` | Setzt die Eigentümerinformationen der angegebenen Objekte zurück. Gilt nur für die Funktion Natural Security Recover.
Siehe auch Check Date, um nur Objekte zu ersetzen, die älter sind als die zu bearbeitenden Objekte. Wenn Sie die Funktion Natural Security Recover benutzen, können Sie in diesem Feld die Option `O` eingeben, um die Eigentümerinformationen der angegebenen Objekte zurückzusetzen.
DDM Name | DDM-Name Der Name eines Datendefinitionsmoduls (DDM) oder ein Bereich von Namen. Wenn Sie einen Wert eingeben, der mit einem Stern (*) endet, wird jedes DDM, dessen Name mit dem angegebenen Wert beginnt, verarbeitet. Wenn nur ein Stern (*) eingegeben wird oder wenn dieses Feld leer ist, werden alle DDMs verarbeitet.
Library | Library-Name Der Name einer Library oder ein Bereich von Namen. Wenn Sie einen Wert eingeben, der mit einem Stern (*) endet, wird jede Library mit einem Namen verarbeitet, der mit dem angegebenen Wert beginnt. Der Library-Name ist obligatorisch, wenn Object Name angegeben ist.
Object Name | Objektname Der Name eines Natural-Objekts (außer DDMs) oder ein Bereich von Namen. Wenn der Wert mit einem Stern (*) endet, wird jedes Objekt mit einem Namen, der mit dem angegebenen Wert beginnt, verarbeitet. Wenn dieses Feld leer ist, werden alle Objekte verarbeitet, die in der im Feld Library angegebenen Library enthalten sind.
Check Date | Datum prüfen Gibt an, ob vorhandene Natural-Objekte in Abhängigkeit von ihrem Zeitstempel ersetzt werden sollen. Dieser Parameter hat keine Auswirkung, wenn Replace (Ersetzen) auf `N` gesetzt ist. Mögliche Einstellungen:
`Y` | Ein Objekt ist älter, wenn es vor dem zu ladenden Objekt gespeichert oder katalogisiert wurde.
`N` | Alle Objekte werden ersetzt. Dies ist die Standardeinstellung.
Load Except | Laden außer Gibt an, ob Natural-Objekte von der Verarbeitung ausgeschlossen werden sollen. Dieser Parameter gilt nicht bei Fehlermeldungen. Mögliche Einstellungen:
`Y` | Alle Objekte werden verarbeitet, außer den in den Feldern DDM Name, Library und/oder Object Name angegebenen Objekten.
`N` | Keine Ausnahmen - alle Objekte werden verarbeitet. Dies ist die Standardeinstellung.
Beispiele für Ausnahmen beim Laden: Alle Libraries außer der Library ABC werden geladen: Code = `L` Library = `ABC` Alle DDMs mit einem anderen Präfix als XY werden geladen: Code = `D` DDM Name = `XY*` Alle Objekte, die in Libraries mit einem anderen Präfix als AB enthalten sind, und alle DDMs mit einem anderen Präfix als CD werden geladen: Code = `B` Library = `AB*` DDM Name = `CD*`
Date | Datum Schränkt die Verarbeitung auf Natural-Objekte ein, die an oder nach dem in diesem Feld eingegebenen Datum gespeichert oder katalogisiert wurden. Das Datum muss im Format YYYY-MM-DD (YYYY = Jahr, MM = Monat, DD = Tag) eingegeben werden.
Number | Anzahl Begrenzt die Verarbeitung von Natural-Objekten auf eine bestimmte Anzahl. Gezählt werden alle Objekte, die gemäß den im INPL-Menü angegebenen Auswahlkriterien geladen oder gescannt werden. Wenn die Anzahl der verarbeiteten Objekte den im Feld Number eingegebenen Wert erreicht hat, wird die Verarbeitung mit einer entsprechenden Meldung beendet.

### INPL-Report

Wenn die ausgewählte INPL-Funktion beendet ist, wird ein entsprechender INPL-Report auf dem Bildschirm angezeigt.

### Prüfkommandos

Das Dienstprogramm INPL verarbeitet interne Prüfkommandos, die bei der Durchführung einer INPL-Funktion automatisch ausgeführt werden. Prüfkommandos werden verwendet, um den Lade- oder Scanvorgang zu steuern und auf bestimmte Ereignisse zu reagieren. Die Prüfkommandos, die während eines INPL-Vorgangs ausgeführt werden, werden in den INPL-Report geschrieben.

Die Parameter, mit denen das Prüfkommando auf ein Ereignis reagiert, sind z.B. `STOP`, `LOAD`, `CONTINUE`, `SKIP`, `USERLOAD` oder `USERCONTINUE`. Sie können sich alle Parameter mit der Funktion Scan INPL File anzeigen lassen. Diese Parameter werden zum Beispiel verwendet, um zu überprüfen, ob die Version eines zu installierenden Produkts höher ist als die Version des bereits installierten Produkts.

Sie können ein Prüfkommando nicht ändern, aber Sie können die Wirkung der Parameter `USERLOAD` und `USERCONTINUE` beeinflussen, indem Sie die Funktion Replace Product Installation (Funktionscode `P`) wählen oder die Option Replace auf `P` setzen.

`USERLOAD` (oder `USERCONTINUE`) bedeutet: Laden (bzw. Fortsetzen des Ladens) nur, wenn der Funktionscode `P` gewählt wurde oder wenn die Option Replace auf `P` gesetzt ist.

#### Beispiel für USERLOAD und USERCONTINUE

Im folgenden Beispiel für ein Prüfkommando wird die aktuell installierte Natural-Version geprüft, bevor der INPL-Vorgang durchgeführt wird:

    CHECK VERSION NAT vrs LT USERLOAD EQ LOAD GT USERLOAD

wobei `vrs` die Natural-Version des zu ladenden INPL-Inhalts ist.

Liegt die installierte Natural-Version (`NAT`) unter (`LT`) oder über (`GT`) `vrs`, so wird die INPL-Funktion nur ausgeführt, wenn der Funktionscode `P` angegeben oder die Option Replace auf `P` gesetzt wurde. Andernfalls bricht das INPL-Dienstprogramm ab oder wird mit Condition Code 40 im Batch abgebrochen und eine entsprechende Meldung in den INPL-Report geschrieben.

Ist die Version gleich `vrs`, wird die INPL-Funktion immer ausgeführt, unabhängig davon, ob der Funktionscode `P` angegeben oder die Option Replace auf `P` gesetzt ist.

## Load Libraries Only - Nur Libraries laden

Mit dieser Funktion des Dienstprogramms INPL können Sie katalogisierte Natural-Objekte und Quellcodeobjekte in die angegebenen Libraries in der Natural-Systemdatei FNAT oder FUSER laden.

Um Libraries zu laden:

1. Geben Sie im INPL-Menü den Funktionscode `L` ein. Sie können Parameter angeben, die bei der Ausführung dieser Funktion gültig sein sollen:

   - Ersetzen: `Replace` (`Y`/`N`)

   - Laden außer: `Load Except` (`Y`/`N`)

   - Bibliothek: Library

   - Objekt-Name: `Object Name`

   - Datum: `Date` (`YYYY-MM-DD`)

   - Datum prüfen: `Check Date` (`Y`/`N`)

   - Anzahl: `Number`

   Ausführliche Informationen zu diesen Parametern finden Sie unter Verfügbare Optionen im Abschnitt Einführung in das Dienstprogramm INPL.

2. Bestätigen Sie Ihre Eingaben.

Nach Beendigung der Funktion wird ein entsprechender INPL-Report (siehe Abschnitt Einführung in das Dienstprogramm INPL) ausgegeben.

## Load DDMs Only - Nur DDMs laden

Diese Funktion des Dienstprogramms INPL wird verwendet, um DDMs in die Systemdatei FDIC zu laden.

Um DDMs zu laden:

1. Geben Sie im INPL-Menü den Funktionscode `D` ein. Sie können Parameter angeben, die während der Ausführung dieser Funktion gültig sein sollen:

   - Ersetzen: `Replace` (`Y`/`N`)

   - Laden außer: `Load Except` (`Y`/`N`)

   - DDM-Name: `DDM Name`

   - Anzahl: `Number`

   Ausführliche Informationen zu diesen Parametern finden Sie unter Verfügbare Optionen im Abschnitt Einführung in das Dienstprogramm INPL.

2. Bestätigen Sie Ihre Eingaben.

Nach Beendigung der Funktion wird ein entsprechender INPL-Report (siehe Abschnitt Einführung in das Dienstprogramm INPL) ausgegeben.

## Load Error Messages Only - Nur Fehlermeldungen laden

Mit dieser Funktion des Dienstprogramms INPL können benutzerdefinierte Fehlermeldungen oder Systemfehlermeldungen in bestimmte Libraries in der Natural-Systemdatei FUSER bzw. FNAT geladen werden.

Um Fehlermeldungen zu laden:

1. Geben Sie im INPL-Menü den Funktionscode `E` ein. Sie können Parameter angeben, die während der Ausführung dieser Funktion gültig sein sollen:

   - Ersetzen: `Replace` (`Y`/`N`)

   - Bibliothek: `Library`

   Ausführliche Informationen zu diesen Parametern finden Sie unter Verfügbare Optionen im Abschnitt Einführung in das Dienstprogramm INPL.

2. Bestätigen Sie Ihre Eingaben.

Nach Beendigung der Funktion wird ein entsprechender INPL-Report (siehe Abschnitt Einführung in das Dienstprogramm INPL) ausgegeben.

## Load All Objects - Alle Objekte laden

Mit dieser Funktion des Dienstprogramms INPL werden alle Natural-Objekte (einschließlich Fehlermeldungen und DDMs) in die in Arbeitsdatei 1 angezeigten Libraries geladen. Die DDMs werden in die Systemdatei FDIC geladen.

Um alle Objekte zu laden:

1. Geben Sie im INPL-Menü den Funktionscode `B` ein. Sie können Parameter angeben, die während der Ausführung dieser Funktion gültig sein sollen:

   - Ersetzen: `Replace` (`Y`/`N`)

   - Laden außer: `Load Except` (`Y`/`N`)

   - DDM-Name: `DDM Name`

   - Bibliothek: `Library`

   - Objekt-Name: `Object Name`

   - Datum: `Date` (`YYYY-MM-DD`)

   - Datum prüfen: `Check Date` (`Y`/`N`)

   - Anzahl: `Number`

   Ausführliche Informationen zu diesen Parametern finden Sie unter Verfügbare Optionen im Abschnitt Einführung in das Dienstprogramm INPL.

2. Bestätigen Sie Ihre Eingaben.

Nach Beendigung der Funktion wird ein entsprechender INPL-Report (siehe Abschnitt Einführung in das Dienstprogramm INPL) ausgegeben.

## Replace Product Installation - Produktinstallation ersetzen

Zusätzlich zur Funktion Load All Object (Alle Objekte laden) ersetzt diese Funktion alle vorhandenen Natural- oder Natural-Add-on-Produkte, die in der aktuellen Systemumgebung installiert sind. Das Ersetzen bestehender Produktinstallationen hängt von der Ausführung der entsprechenden Prüfkommandos ab, die im Abschnitt Einführung in das Dienstprogramm INPL beschrieben sind.

Um alle Objekte zu laden und bestehende Produktinstallationen zu ersetzen:

1. Geben Sie im INPL-Menü den Funktionscode `P` ein. Sie können Parameter angeben, die bei der Ausführung dieser Funktion gültig sein sollen:

   - Ersetzen: `Replace` (`Y`/`N`)

   - Laden außer: `Load Except` (`Y`/`N`)

   - DDM-Name: `DDM Name`

   - Bibliothek: `Library`

   - Objekt-Name: `Object Name`

   - Datum: `Date` (`YYYY-MM-DD`)

   - Datum prüfen: `Check Date` (`Y`/`N`)

   - Anzahl: `Number`

   Ausführliche Informationen zu diesen Parametern finden Sie unter Verfügbare Optionen im Abschnitt Einführung in das Dienstprogramm INPL.

2. Bestätigen Sie Ihre Eingaben.

Nach Beendigung der Funktion wird ein entsprechender INPL-Report (siehe Abschnitt Einführung in das Dienstprogramm INPL) ausgegeben.

## Scan INPL File - INPL-Datei scannen

Mit dieser Funktion des Dienstprogramms INPL wird der Inhalt des der Arbeitsdatei 1 zugeordneten Dataset (Datei) gescannt.

Um eine INPL-Datei zu scannen:

1. Geben Sie im INPL-Menü den Funktionscode `S` ein. Sie können Parameter angeben, die während der Ausführung dieser Funktion gültig sein sollen:

   - Ersetzen: `Replace` (`Y`/`N`)

   - Laden außer: `Load Except` (`Y`/`N`)

   - DDM-Name: `DDM Name`

   - Bibliothek: `Library`

   - Objekt-Name: `Object Name`

   - Datum: `Date` (`YYYY-MM-DD`)

   - Anzahl: `Number`

   Ausführliche Informationen zu diesen Parametern finden Sie unter Verfügbare Optionen im Abschnitt Einführung in das Dienstprogramm INPL.

2. Bestätigen Sie Ihre Eingaben.

Nach Beendigung der Funktion wird ein entsprechender INPL-Report (siehe Abschnitt Einführung in das Dienstprogramm INPL) ausgegeben.

## Natural Security Recover - Initialisierung der Natural Security-Umgebung erzwingen

Mit dieser Funktion des INPL-Dienstprogramms können Sie die Initialisierung der Natural Security-Umgebung erzwingen.

Die folgenden Optionen sind verfügbar:

- Reset Environment - Umgebung zurücksetzen

- Remove Owners - Eigentümer entfernen

### Reset Environment - Umgebung zurücksetzen

| Warnung: Durch die Ausführung dieser Funktion werden das Benutzerprofil DBA und das Library-Profil SYSSEC sowie die Verlinkung zwischen diesen beiden Objekten auf den Stand nach der Erstinstallation zurückgesetzt. Alle anderen Verlinkungen mit der Library SYSSEC werden aufgehoben. Andere Natural Security-Profile und Verlinkungen werden nicht geändert. Wenden Sie sich für weitere Informationen an den technischen Support der Software AG.

Um die Umgebung zurückzusetzen:

- Geben Sie im INPL-Menü den Funktionscode `R` ein.

### Remove Owners - Eigentümer entfernen

Um Eigentümer zu entfernen:

- Geben Sie im INPL-Menü den Funktionscode `R` ein und tragen Sie im Feld Replace ein `O` ein, um die Eigentümerinformationen der angegebenen Objekte zurückzusetzen.

## User-Exit-Routinen

Eine INPL-User-Exit-Routine wird als Quellcode-Objekt INPLSXnn in der Natural System Library SYSLIB ausgeliefert, wobei nn die ID (Kennung) der User-Exit-Routine angibt.

Um eine User-Exit-Routine zu aktivieren:

1. Kopieren Sie den Quellcode aus der Natural System Library SYSLIB in eine User Library.

2. Katalogisieren Sie ihn unter dem Namen `INPLUXnn.`

3. Kopieren Sie ihn zurück in die Natural System Library SYSLIB.

   Anmerkung
   Das von Ihnen möglicherweise geänderte Quellcodeobjekt und das katalogisierte Objekt der User-Exit-Routine werden umbenannt, um zu verhindern, dass sie bei einer Update-Installation überschrieben werden.

Die folgenden User-Exit-Routinen sind verfügbar:

Name | Funktion
--- | ---
`INPLUX01` | Verhindert, dass Fehlermeldungstexte ersetzt werden.

#### User-Exit-Routine `INPLUX01`

Mit diesem User-Exit können Sie Bereiche für Fehlermeldungen (benutzerdefinierte oder Natural-System-Fehlermeldungen) definieren, die während einer INPL-Sitzung nicht ersetzt werden können. Weitere Informationen finden Sie im Quellcode von `INPLSX01` in der Natural System Library SYSLIB.

### On this page

- Einführung in das Dienstprogramm INPL
- Load Libraries Only - Nur Libraries laden
- Load DDMs Only - Nur DDMs laden
- Load Error Messages Only - Nur Fehlermeldungen laden
- Load All Objects - Alle Objekte laden
- Replace Product Installation - Produktinstallation ersetzen
- Scan INPL File - INPL-Datei scannen
- Natural Security Recover - Initialisierung der Natural Security-Umgebung erzwingen
- User-Exit-Routinen