Natural Com-plete/SMARTS-Schnittstelle auf z/OS installieren

#### Search Results

Search

# Natural Com-plete/SMARTS-Schnittstelle auf z/OS installieren

Dieses Dokument beschreibt die Schritte zur Installation der Natural Com-plete/SMARTS-Schnittstelle, die der Natural Com-plete-Schnittstelle (Produktcode NCF) auf z/OS entspricht.

- Voraussetzungen

- Installationsdatenträger

- Installationsvorgang

- Installation überprüfen

#### Verwandte Themen:

Informationen über den Betrieb von Natural in einer Com-plete/SMARTS-Umgebung finden Sie in den folgenden Dokumenten:

- Verwendung von Natural mit TP-Monitoren in der TP-Monitor-Schnittstellen-Dokumentation

- Natural unter Com-plete/SMARTS in der TP-Monitor-Schnittstellen-Dokumentation

- Natural unter Com-plete/SMARTS-Benutzerabbruchcodes in der TP-Monitor-Schnittstellen-Dokumentation

Informationen zur Installation und Benutzung von Com-plete finden Sie in der Com-plete-Dokumentation.

#### Notation vrs oder vr:

In diesem Dokument steht die Notation `vrs` oder `vr` für die jeweilige Produktversion (siehe auch Version im Glossar).

## Voraussetzungen

Bevor Sie die Natural Com-plete/SMARTS-Schnittstelle installieren können, muss eine unterstützte Version des folgenden Produkts installiert sein:

- Com-plete

  Siehe die Com-plete-Installation-Dokumentation.

Siehe auch Allgemeine Voraussetzungen und Systemunterstützung und Übersicht über den Installationsvorgang.

## Installationsdatenträger

Der Installationsdatenträger enthält die folgenden Datasets, die für die Produktinstallation erforderlich sind:

Dataset-Name | Inhalt
--- | ---
`NCFvrs.LOAD` | Lademodule
`NCFvrs.SRCE` | Quellcodemodule und Makros
`NCFvrs.LICS` | Produktlizenzdatei für Natural for Com-plete for zIIP Informationen über die Lizenzdatei und die Produktlizenzierung finden Sie unter Mainframe-Produktlizenzierung.

Kopieren Sie die Datasets in Ihre Umgebung, wie unter Datasets auf eine z/OS-Platte kopieren im Kapitel Natural auf z/OS installieren beschrieben.

#### Beispiel-Jobs

Beispiel-Installationsjobs sind im Dataset `NATvrs.JOBS` enthalten. Ihre Namen beginnen mit dem Produktcode. Der Dataset befindet sich auf dem Installationsdatenträger, der mit dem Basisprodukt Natural geliefert wird.

## Installationsvorgang

Bevor Sie mit der Installation beginnen, sollten Sie unbedingt die Abschnitte im Kapitel Installationsverfahren und wichtige Natural-Funktionen unter z/OS lesen.

Der Installationsvorgang umfasst die nachfolgend beschriebenen Schritte.

- Schritt 1: Lizenzdatei für Natural for Com-plete for zIIP vorbereiten, konvertieren, assemblieren und verlinken

- Schritt 2: Startprogramm erstellen

- Schritt 3: Natural-Parametermodul erstellen

- Schritt 4: Nukleus verlinken

- Schritt 5: Natural Com-plete/SMARTS Interface Server verlinken

- Schritt 6: Natural Com-plete/SMARTS Interface Server definieren

- Schritt 7: Natural Com-plete/SMARTS-Schnittstelle katalogisieren

- Schritt 8: Natural zIIP-Shutdown-Statistiken

### Schritt 1: Lizenzdatei für Natural for Com-plete for zIIP vorbereiten, konvertieren, assemblieren und verlinken

(Job I007, Steps 2301, 2302, 2304)

Dieser Schritt ist optional und nur erforderlich, wenn Sie Natural for Com-plete for zIIP installieren möchten.

Sie müssen eine gültige Natural-Lizenzdatei installieren. Eine zusätzliche Lizenzdatei ist erforderlich, wenn Sie Natural for Com-plete for zIIP installieren wollen, um die Unterstützung des IBM z/IIP (IBM System z Integrated Information Processor) zu aktivieren.

Ausführliche Informationen zur Lizenzdatei und zur Produktlizenzierung finden Sie unter Mainframe-Produktlizenzierung.

1. Kopieren Sie die Lizenzdatei von dem mitgelieferten Installationsdatenträger auf die Platte oder übertragen Sie sie vom PC, wie unter Lizenzdatei mittels FTP vom PC auf einen z/OS-Host übertragen in Mainframe-Produktlizenzierung beschrieben.

2. Prüfen, konvertieren, assemblieren und verlinken Sie die mitgelieferte Lizenzdatei für Natural for Com-plete for zIIP:

   Step 2301 | Lizenzdatei `NCFvrs.LICS` prüfen. Dieser Job führt die CHECK-Funktion des Lizenzdienstprogramm LICUTIL aus (siehe unten).
   Step 2302 | Lizenzdatei in einen Assembler-Quellcode umwandeln. Dieser Job führt die MAKE-Funktion des Lizenzdienstprogramm LICUTIL (siehe unten).
   Step 2304 | Assembler-Quellcode assemblieren und verlinken, um das Lademodul `NCFLIC` zu erzeugen. Dieses Modul wird dann in Job I080 mit dem Nukleus verlinkt.

   Die von LICUTIL zur Verfügung gestellten Funktionen und Optionseinstellungen sind im Kapitel Lizenzdienstprogramm LICUTIL benutzen in Mainframe-Produktlizenzierung beschrieben.

### Schritt 2: Startprogramm erstellen

(Job I070, Steps 2320, 2321)

Dieser Schritt ist optional.

Sie können ein Startprogramm für die Natural Com-plete/SMARTS-Schnittstelle verwenden, um dynamische Parameter an Natural zu übergeben.

1. Passen Sie das in der Quellcodebibliothek enthaltene Beispielprogramm `NCO001` an Ihre Anforderungen an.

2. Assemblieren und verlinken Sie das Startprogramm in Ihre Com-plete-Anwenderprogrammbibliothek.

### Schritt 3: Natural-Parametermodul erstellen

(Job I080, Steps 2300, 2310)

Die in diesem Abschnitt erwähnten Natural-Profilparameter und Parameter-Makros sind, sofern nicht anders angegeben, in der Parameter-Referenz-Dokumentation beschrieben.

1. 1. Passen Sie das Natural- Parametermodul für Com-plete/SMARTS an:

   - Konfigurieren Sie die Com-plete/SMARTS-Batch-Schnittstelle:

     Ändern Sie die Einstellungen der Schlüsselwort-Subparameter, die im Makro `NTCOMP` geliefert werden, gemäß Ihren Anforderungen. Eine Beschreibung dieser Schlüsselwort-Subparameter finden Sie bei dem entsprechenden Natural-Profilparameter `COMP`.

   - Ändern Sie die folgenden Natural-Profilparameter:

         FNAT=(database-id,file-number)
         FUSER=(database-id,file-number)

     wobei `database-id` und `file-number` die Werte sind, die Sie beim Laden der Systemdateien während des Installationsvorgangs für das Basisprodukt Natural angegeben haben.

2. Definieren Sie einen lokalen Natural Buffer Pool unter Com-plete, indem Sie die Werte der Schlüsselwort-Subparameter, die im Parameter-Makro `NTBPI` geliefert werden (siehe den Natural-Profilparameter `BPI`), nach Bedarf ändern.

   Ein lokaler Buffer Pool wird während der Initialisierung der ersten Natural-Sitzung nach dem Start von Com-plete zugewiesen.

   Sie können sich den Status der lokalen Buffer Pools auf der Bedienerkonsole anzeigen lassen, indem Sie das folgende Com-plete-Operator-Kommando absetzen:

       SERV,server-name,BPSTAT

   wobei `server-name` der Name des Servers ist, der mit der Com-plete-Startoption `SERVER` angegeben wurde.

3. 1. Wenn Sie einen globalen Natural Buffer Pool unter Com-plete verwenden wollen, müssen Sie für den Profilparameter `SUBSID` im Parameter-Makro `NTPRM` (siehe Operations-Dokumentation) und für den Schlüsselwort-Subparameter `NAME` im Parameter-Makro `NTBPI` (siehe Parameter-Referenz-Dokumentation) die gleichen Werte angeben wie beim Natural-Installationsvorgang.

4. Assemblieren und verlinken Sie das Natural-Parametermodul.

### Schritt 4: Nukleus verlinken

(Job I080, Step 2320)

Verlinken Sie den umgebungsabhängigen Nukleus für die Natural Com-plete/SMARTS-Schnittstelle.

- Verlinken Sie den umgebungsabhängigen Nukleus in Ihre Com-plete-Anwenderprogrammbibliothek.

  Die Liste der zu verlinkenden Module für den umgebungsabhängigen Nukleus wird mit Schritt 2320 geliefert.

  Wenn Sie möchten, dass Natural im IBM Language Environment (LE) läuft, setzen Sie in der System Maintenance Aid (SMA) `NAT-LE` auf `Y` (Ja). Die Standardeinstellung ist `N` (No).

- Geben Sie den umgebungsabhängigen Nukleus als Com-plete-Startoption an, indem Sie den folgenden Com-plete-Schlüsselwort-Parameter setzen:

      RESIDENTPAGE=name

  wobei `name` der Name des umgebungsabhängigen Nukleus für die Natural Com-plete/SMARTS-Schnittstelle ist.

### Schritt 5: Natural Com-plete/SMARTS Interface Server verlinken

(Job I080, Step 2350)

- Verlinken Sie den Natural Com-plete/SMARTS Interface Server.

Der Natural Com-plete/SMARTS Interface Server wird verwendet, um gemeinsame Speicher und Tabellen über Natural-Sitzungen übergreifend zu verwalten, z. B. den lokalen Buffer Pool.

### Schritt 6: Natural Com-plete/SMARTS Interface Server definieren

- Geben Sie den Natural Com-plete/SMARTS Interface Server als Com-plete-Startoption an, indem Sie den folgenden Com-plete-Schlüsselwortparameter setzen:

      SERVER=(server-name,module-name)

  wobei:

  `server-name` der Name des Servers ist, wie er mit dem Schlüsselwort-Subparameter `SERVER` im Parameter-Makro `NTCOMP` angegeben ist (siehe Parameter-Referenz-Dokumentation).

  `module-name` der Name des im Natural Com-plete/SMARTS- Interface Server verlinken verlinkten Lademoduls ist.

Das Modul des Natural Com-plete/SMARTS Interface Servers wird während der Initialisierung von Com-plete geladen. Das Modul muss daher in einer Ladebibliothek untergebracht werden, die in der `COMPINIT`-Ladebibliotheksverkettung enthalten ist (siehe auch die Com-plete-Installation-Dokumentation).

### Schritt 7: Natural Com-plete/SMARTS-Schnittstelle katalogisieren

Dieser Schritt ist erforderlich, wenn einer der folgenden Punkte zutrifft:

Sie führen Natural unter Com-plete/SMARTS aus und verwenden Threads unterhalb der 16-MB-Grenze (Einstellung `THABOVE=NO` im Makro `NTCOMP`).

Oder:

Sie wollen Natural Work Pools unterhalb der 16-MB-Grenze verwenden.

- Katalogisieren Sie die Natural Com-plete/SMARTS-Schnittstelle mit Hilfe des Com-plete-Dienstprogramms ULIB.

  - Für Threads unterhalb der 16-MB-Grenze:

    Die mit dem ULIB-Utility-Parameter `RG` anzugebende Bereichsgröße (Region Size) hängt von der Einstellung des Schlüsselwort-Subparameters `NTHSIZE` im Parameter-Makro `NTCOMP` ab, das in der Parameter-Referenz-Dokumentation beschrieben ist.

  - Für Work Pools unterhalb der 16-MB-Grenze:

    Die mit dem ULIB-Utility-Parameter `RG` anzugebende Bereichsgröße (Region Size) hängt von der Einstellung des Natural-Profilparameters `WPSIZE` (siehe Parameter-Referenz-Dokumentation) für das Parameter-Makro `NTPRM` (siehe Operations-Dokumentation) ab.

  Siehe auch Speichernutzung im Teil Natural unter Com-plete/SMARTS in der TP-Monitor-Schnittstellen-Dokumentation.

  Nach der Installation können Sie das Natural-Dienstprogramm SYSTP (siehe Debugger und Dienstprogrammer (Utilities)-Dokumentation) benutzen, um die tatsächlich verwendete Bereichsgröße (Region Size) zu ermitteln.

### Schritt 8: Natural zIIP-Shutdown-Statistiken

Dieser Schritt ist erforderlich, wenn Sie Natural zIIP-Statistiken drucken möchten, wenn die Com-plete-Umgebung heruntergefahren wird. Weitere Informationen finden Sie unter Verfügbare zIIP-Verarbeitungsberichte in der Natural for zIIP-Dokumentation.

Der Shutdown-Exit `NCFTRMEX` schreibt die zIIP-Statistiken, die seit dem Start von Com-plete gesammelt wurden, in das `APSLOG`. `NCFTRMEX` verwendet das Programm `NATZPST`, um auf die zIIP-Statistiken zuzugreifen.

Um die zIIP-Shutdown-Statistiken zu aktivieren, müssen die Module `NCFTRMEX` und `NATZPST` in einer Ladebibliothek untergebracht werden, die in der Com-plete-`COMPLIB`-Ladebibliothek-Verkettung enthalten ist. Weitere Informationen finden Sie in der Com-plete-Installation-Dokumentation.

## Installation überprüfen

Sie können die erfolgreiche Installation der Natural Com-plete/SMARTS-Schnittstelle überprüfen, indem Sie die folgenden Schritte durchführen:

1. Beenden Sie Com-plete und starten Sie es neu.

2. Rufen Sie das User-Menü von Com-plete auf und geben Sie den Namen des umgebungsabhängigen Nukleus für die Natural Com-plete/SMARTS-Schnittstelle ein.

   Der Einstiegsbildschirm von Natural sollte erscheinen.

3. Fahren Sie mit den im Abschnitt Online Natural testen beschriebenen Schritten fort.

### On this page

- Voraussetzungen
- Installationsdatenträger
- Installationsvorgang
- Installation überprüfen