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.

Verwandte Themen:

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

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

(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