Natural for VSAM auf VSAM-Systemdateien auf z/OS installieren

Dieses Dokument beschreibt die Schritte zur Installation von Natural for VSAM in einem VSAM-Dateisystem auf z/OS.

Die Natural-Systemdateien FNAT, FUSER, FDIC, FSEC und FSPOOL können sich auch auf VSAM-Dateien befinden.

Die Installation von Natural für VSAM in einem VSAM-Dateisystem ist im Wesentlichen eine Kombination aus den Installationsbeschreibungen für das Basisprodukt Natural und Natural für VSAM sowie einigen VSAM-spezifischen Punkten.

Für die Unterstützung von Source Object Locking sind eine separate FLOCK-Datei und entsprechende Pfade erforderlich.

Installationsdatenträger für VSAM

Der Installationsdatenträger enthält die folgenden für die Produktinstallation erforderlichen Datasets:

Wenn Sie Natural in einem VSAM-Dateisystem installieren wollen, benötigen Sie die Datasets sowohl für das Basisprodukt Natural als auch für Natural f0r VSAM. Die erforderlichen Datensätze sind in der folgenden Tabelle aufgeführt:

Dataset-Name Inhalt
NATvrs.LOAD Lademodule
NATvrs.SRCE Quellcodemodule und Makros
NATvrs.JOBS Beispiel-Installationsjobs
NATvrs.INPL Natural-Objekte
NATvrs.EXPL Natural-Beispiel-Objekte
NVSvrs.LOAD Lademodule
NVSvrs.SRCE Quellcodemodule und Makros
NVSvrs.JOBS Beispiel-Installationsjobs
NVSvrs.VINI FDIC-Initialisierungsdatei für Natural for VSAM
NVSvrs.LINI FLOCK-Initialisierungsdatei für Natural for VSAM
NVSvrs.EMPL EMPLOYEES-Beispieldaten
NVSvrs.EXPL Natural-Beispielobjekte

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

Installationsvorgang für VSAM

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

Die in diesem Abschnitt angegebenen VSAM-Jobs (z.B. VSAMI008) sind identisch mit den von System Maintenance Aid (z.B. I008) generierten Jobs.

Der Installationsvorgang umfasst die nachfolgend beschriebenen Schritte.

Schritt 1: CICS-RDO-Definitionen auf VSAM-Systemdateien definieren

(Job VSAMI005)

  • Definieren Sie die CICS-RDO-Definitionen für die VSAM-Beispieldateien.

Schritt 2: Employees-Beispieldaten auf VSAM-Systemdateien laden

(Job VSAMI008, Steps 1403 - 1407)

  1. Definieren Sie den VSAM-Cluster und die Dateien, die die Beispieldatei Employees (Beispieldaten einer Mitarbeiterverwaltung) enthalten sollen.

  2. Laden Sie den Dataset NVSvrs.EMPL in die erste dieser Dateien (Suffix .EMPL).

  3. Erstellen Sie einen sekundären Index davon in der zweiten Datei (Suffix .EMPLX) und definieren Sie den Pfad dafür.

Schritt 3: VSAM-Cluster für die Natural-Systemdateien vorbereiten

(Job VSAMI008, Steps 1420 - 1446)

  • Definieren Sie drei VSAM-Cluster, die als Systemdateien für Natural verwendet werden sollen (FNAT, FUSER und FDIC), einen alternativen Index und einen Pfad für den alternativen Index für FDIC.

    Es wird dringend empfohlen, diese drei Systemdateien auf separaten VSAM-Clustern zu speichern.

Schritt 4: VSAM-Cluster für die Spool-Datei vorbereiten

(Job VSAMI008, Steps 0300 - 0309)

Dieser Schritt muss nur durchgeführt werden, wenn Sie Natural Advanced Facilities installiert haben und Ihre Spool-Datei auch eine VSAM-Datei sein soll.

  • Definieren Sie einen zusätzlichen VSAM-Cluster, der als Spool-Datei verwendet werden soll (FSPOOL), und fünf alternative Indizes.

    Anmerkung
    Die Pfadverarbeitung wird bei FSPOOL nicht unterstützt.

Schritt 5: VSAM-Cluster für die Security-Datei vorbereiten

(Job VSAMI008, Steps 9900 - 9907)

Dieser Schritt muss nur durchgeführt werden, wenn Sie Natural Security installiert haben und Ihre Security-Datei auch eine VSAM-Datei sein soll.

  • Definieren Sie einen zusätzlichen VSAM-Cluster, der als Security-Datei (FSEC) verwendet werden soll, und drei alternative Indizes.

    Anmerkung
    Die Pfadverarbeitung wird bei FSEC nicht unterstützt.

Schritt 6: VSAM-Cluster für das Scratch Pad File vorbereiten

(Job VSAMI008, Steps 1450, 1451)

Dieser Schritt muss nur ausgeführt werden, wenn Sie ein Scratch Pad File verwenden wollen, d.h. wenn Sie schreibgeschützte Natural-Systemdateien verwenden wollen (ROSY=ON); siehe auch den Natural-Profilparameter ROSY und das Makro NTLFILE, die in der Parameter-Referenz-Dokumentation beschrieben sind.

  • Definieren Sie einen zusätzlichen VSAM-Cluster, der als Scratch Pad File verwendet werden soll (Schritt 1450).

  • Initialisieren Sie das VSAM-Scratch Pad File (Schritt 1451).

  • Setzen Sie die folgenden Parameter im Natural-Parametermodul entsprechend Ihren Anforderungen: 

    NTLFILE 212,dbid,nt-file-number,dd-name-scratch-pad-file
ROSY=ON

  • Wenn Sie möchten, dass Ihre Natural-Systemdatei(en) zur Eingabe geöffnet werden, müssen Sie Ihr Natural-Parametermodul wie folgt anpassen: 

    FNAT=(dbid,fnr,filename,,RO),
FUSER=(dbid,fnr,filename,,RO),
FSEC=(dbid,fnr,filename,,RO),

Schritt 7: VSAM-Cluster für das Source Locking File FLOCK vorbereiten

(Job VSAMI008, Steps 1460, 1461)

Dieser Schritt muss nur durchgeführt werden, wenn Sie Quellcodeobjekte in einem VSAM-Dateisystem sperren wollen (SLOCK=PRE); siehe auch den Parameter SLOCK und das Makro NTLFILE (beschrieben in der Parameter-Referenz-Dokumentation).

  • Definieren Sie einen zusätzlichen VSAM-Cluster, der als Source Locking File verwendet werden soll (Schritt 1460).

  • Laden und drucken Sie den in dem VSAM Source Locking File enthaltenen Beispiel-Dataset (Schritt 1461).

  • Setzen Sie die folgenden Parameter im Natural-Parametermodul entsprechend Ihren Anforderungen: 

    NTLFILE 002,dbid,nt-file-number,dd-name-source-locking-file,,PATH
SLOCK=PRE

    Der Standard-DD-Name (dd-name) ist FLOCK, die zugehörigen Standardpfade sind FLOCKA, FLOCKB und FLOCKC.

Schritt 8: Natural for VSAM I/O Modul erstellen

(Job VSAMI055, Steps 1410, 1411, 1415, 1416)

  • Bearbeiten, assemblieren und verlinken Sie das Natural for VSAM I/O-Modul NVSMISC mit den LSR-Optionen: 

    DEFER=YES
COMMIT=NO
READINT=NO

    Die Parameter, die im Modul NVSMISC module angegeben werden können, finden Sie im entsprechenden Abschnitt in der Datenbankmanagementsystem-Schnittstellen-Dokumentation.

Schritt 9: Natural-Parametermodul für den Batch-Modus für VSAM erstellen

(Job I060, Step 0010)

  1. Ändern Sie die Einstellungen der mitgelieferten Natural-Profilparameter wie für den Batch-Modus erforderlich. Die Parameter und die entsprechenden Makros (falls zutreffend) sind in der Parameter-Referenz-Dokumentation beschrieben. Die wichtigsten Parameter-/Makro-Einstellungen werden im Folgenden beschrieben.

    • Konfigurieren Sie die z/OS-Batch-Schnittstelle:
      Ändern Sie die Einstellungen der mit dem Makro NTOSP gelieferten Parameter, so dass sie Ihren Anforderungen entsprechen. Eine Beschreibung dieser Parameter finden Sie im entsprechenden Profilparameter OSP.

    • Ändern Sie zusätzlich zu den VSIZE- und NTDB-Angaben die Parameter FNAT, FUSER und FDIC wie folgt: 

      VSIZE=126,
FNAT=(vsam-dbid,fnr-fnat,dd-name-fnat),
FUSER=(vsam-dbid,fnr-fuser,dd-name-fuser),
FDIC=(vsam-dbid,fnr-fdic,dd-name-fdic),
NTDB VSAM,vsam-dbid
NTVSAM

      Die VSAM-Datenbankkennung vsam-dbid muss in allen vier Einträgen den gleichen Wert haben.

      Wir empfehlen Ihnen, für FNAT und FUSER unterschiedliche Dateien und unterschiedliche Dateinummern zu verwenden. Die FDIC-Datei muss eine andere Datei sein als FNAT und FUSER. Daher dürfen Sie den Parameter FDIC nicht weglassen.

      Die DD-Namen (dd-name) sind die logischen Namen der Natural-Systemdateien. Jeder DD-Name kann bis zu sieben Zeichen lang sein. Der DD-Name für den FDIC-Pfad wird durch Anhängen eines X an den DD-Namen der FDIC-Datei erstellt.

    • Falls Sie Natural Advanced Facilities installiert haben und Ihre Spooldatei eine VSAM-Datei sein soll, müssen Sie den Parameter FSPOOL entsprechend ändern: 

      FSPOOL=(vsam-dbid,fnr-fspool,dd-name-fspool)

    • Falls Sie Natural Security installiert haben und Ihre Security-Datei eine VSAM-Datei sein soll, müssen Sie den Parameter FSEC entsprechend ändern: 

      FSEC=(vsam-dbid,fnr-fsec,dd-name-fsec)

      Für FSEC muss eine andere Datei verwendet werden als für FNAT.

    • Für eine schnelle Installation können Sie die LSR-Funktion von Natural for VSAM verwenden und die folgenden NTVLSR-Definitionen im Natural-Parametermodul angeben (siehe auch NTVLSR Macro-Makro in der Parameter-Referenz-Dokumentation): 

      NTVLSR fnat-dd-name,1
NTVLSR fuser-dd-name,2
NTVLSR fdic-dd-name,3
NTVLSR fdicx-dd-name,3

      Wenn Sie FSEC-Systemdateien verwenden möchten: 

      NTVLSR fsec-dd-name,4
NTVLSR fseca-dd-name,4
NTVLSR fsecb-dd-name,4
NTVLSR fsecc-dd-name,4

  2. Assemblieren und verlinken Sie das Batch-Parametermodul.

Schritt 10: Nukleus für Batch Natural verlinken

(Job I060, Step 0020)

  1. Ändern Sie die JCL, mit der Sie Ihren umgebungsabhängigen Nukleus für Batch Natural verlinken, indem Sie die folgenden INCLUDE-Anweisungen hinzufügen: 

     INCLUDE NVSLIB(NVSNUC)
 INCLUDE NVSLIB(NVSFNAT)
 INCLUDE NVSLIB(NVSFSPO)
 INCLUDE NVSLIB(NVSFSEC)
 INCLUDE SMALIB(NVSFLOCK)
 INCLUDE SMALIB(NVSMISC)

    Das Modul NVSFSPO ist nur erforderlich, wenn Sie Natural Advanced Facilities installiert haben und Ihre Spool-Datei in einem VSAM-Dateisystem installiert werden soll.

    Das Modul NVSFSEC ist nur erforderlich, wenn Sie Natural Security installiert haben und Ihre Security-Datei in einem VSAM-Dateisystem installiert werden soll.

    Das Modul NVSFLOCK ist nur erforderlich, wenn Sie Quellcode-Objekte, die in einer FUSER- oder FNAT-Systemdatei enthalten sind, in einem VSAM-Dateisystem sperren möchten.

    Wenn Ihr umgebungsabhängiger Nukleus nicht mit Ihrem umgebungsunabhängigen Nukleus verlinkt ist, muss NVSMISC statt dessen mit dem Natural-Parametermodul verlinkt werden.

  2. Fügen Sie die entsprechenden DD-Anweisungen in den Link-Schritt für Natural ein.

Informationen zu den Komponenten und der Struktur der Natural-Schnittstelle zu VSAM finden Sie auch unter Bestandteile von Natural für VSAM und Struktur der Natural-Schnittstelle zu VSAM in der Datenbankmanagementsystem-Schnittstellen-Dokumentation.

Schritt 11: Natural-Objekte laden

(Job I061, Step 0100)

  • Laden Sie mit dem Natural-Dienstprogramm INPL die Natural-Beispiel-Objekte aus dem Dataset NATvrs.INPL in die Natural-Systemdatei.

    Stellen Sie sicher, dass die im Natural-Parametermodul (siehe Installationsschritt Natural-Parametermodul für den Batch-Modus für VSAM erstellen) angegebenen DD-Namen auch für die mit dem Natural-Dienstprogramm INPL durchgeführte Ladefunktion angegeben sind. Zusätzlich muss ein alternativer Index-DD-Name (dd-name-fdicX) für FDIC angegeben werden.

Anmerkung
Wenn Sie andere Produkte installieren wollen, die das Laden von Natural-Objekten mit dem Natural-Dienstprogramm INPL erfordern, müssen Sie sicherstellen, dass die entsprechenden Installationsschritte gemäß Job VSAMI061 angepasst werden.

Schritt 12: Natural-Beispiel-Objekte laden

(Job I061, Step 0103, und Job VSAMI061, Step 1400)

  • Laden Sie mit dem Natural-Dienstprogramm INPL die Natural-Beispiel-Objekte aus dem Dataset NATvrs.EXPL in die Natural-Systemdatei (Job I061, Step 0103).

  • Laden Sie mit dem Natural-Dienstprogramm INPL die für Natural for VSAM spezifischen Natural-Beispiel-Objekte aus dem Dataset NVSvrs.EXPL in die Natural-Systemdatei (Job VSAMI061, Schritt 1400).

Stellen Sie sicher, dass die im Natural-Parametermodul angegebenen DD-Namen (siehe Installationsschritt Natural-Parametermodul für den Batch-Modus für VSAM erstellen) auch für die mit dem Natural-Dienstprogramm INPL durchgeführte Ladefunktion angegeben sind. Zusätzlich muss für FDIC ein Pfad-DD-Name (dd-name-fdicX) angegeben werden.

Schritt 13: FNAT-Systemdatei reorganisieren

  • Reorganisieren Sie die FNAT-Systemdatei, indem Sie die VSAM-Funktion AMS REPRO zum Entladen und erneuten Laden der Datei verwenden.

Schritt 14: Natural for VSAM I/O Modul für CICS erstellen

(Job VSAMI070, Step 1400)

Dieser Schritt muss nur ausgeführt werden, wenn Sie Natural for VSAM unter CICS installieren wollen.

  • Assemblieren und verlinken Sie das Modul NVSCICS.

Schritt 15: Den Nukleus für Natural unter einem TP-Monitor verlinken

(Job VSAMI080)

Fahren Sie mit den TP-Monitor-spezifischen Installationsschritten für das Basisprodukt Natural fort, die in den entsprechenden Kapiteln der vorliegenden Installationsanleitung beschrieben sind, und berücksichtigen Sie dabei die folgenden Ergänzungen:

  • Ändern Sie Ihr VSAM-spezifisches Natural-Parametermodul gemäß Installationsschritt Natural-Parametermodul für den Batch-Modus für VSAM erstellen.

  • Fügen Sie die folgenden INCLUDE-Anweisungen zu allen Links des Online-Nukleus hinzu: 

     INCLUDE NVSLIB(NVSNUC)
 INCLUDE NVSLIB(NVSFNAT)
 INCLUDE NVSLIB(NVSFSPO)
 INCLUDE NVSLIB(NVSFSEC)
 INCLUDE NVSLIB(NVSFLOCK)

    Das Modul NVSFSPO ist nur erforderlich, wenn Sie Natural Advanced Facilities installiert haben und Ihre Spool-Datei in einem VSAM-Dateisystem installiert werden soll. Die Online-Umgebung für Natural Advanced Facilities muss eine CICS-Umgebung sein, und die in einem VSAM-Dateisystem installierten Spool-Dateien müssen in der CICS-FCT definiert sein.

    Das Modul NVSFSEC ist nur erforderlich, wenn Sie Natural Security installiert haben und Ihre Natural Security-Systemdatei in einem VSAM-Dateisystem installiert werden soll. Die in einem VSAM-Dateisystem installierten VSAM Natural Security-Systemdateien müssen in der CICS-FCT definiert werden.

    Das Modul NVSFLOCK wird nur benötigt, wenn Sie Quellcode-Objekte, die in einer FUSER- oder FNAT-Systemdatei enthalten sind, in einem VSAM-Dateisystem sperren wollen. Die in einem VSAM-Dateisystem installierten Sperrdateien müssen in der CICS-FCT definiert werden.

  • Ändern Sie die JCL, mit der Sie Ihren umgebungsabhängigen Nukleus für die Natural CICS-Schnittstelle verlinken, indem Sie die folgende INCLUDE-Anweisung hinzufügen: 

    INCLUDE SMALIB(NVSCICS)

  • Ändern Sie die JCL, mit der Sie Ihren umgebungsabhängigen Nukleus für andere Natural TP Monitor-Schnittstellen als die Natural CICS-Schnittstelle verlinken, indem Sie die folgende INCLUDE-Anweisung hinzufügen: 

    INCLUDE SMALIB(NVSMISC)

  • Bevor Sie Natural starten, müssen Sie sicherstellen, dass die DD- und DSN-Namen der Natural-Systemdateien im VSAM-Dateisystem in Ihrer Batch- und Online-Umgebung bekannt sind.

Schritt 16: TP-Monitor anpassen

Passen Sie Ihre TP-Monitor-Umgebung an:

TP-Monitor Maßnahme
Com-plete

Katalogisieren Sie die Systemdateien FNAT, FUSER und FDIC im VSAM-Dateisystem unter Com-plete mit der CA-Funktion des Com-plete-Dienstprogramms UFILE (Beschreibung siehe Com-plete-Dokumentation).

Wenn Natural Security installiert ist, katalogisieren Sie die Systemdateien FSEC, FSECA, FSECB und FSECC im VSAM-Dateisystem unter Com-plete mit der CA-Funktion des Com-plete-Dienstprogramms UFILE.

Wenn Sie Quellcode-Objekte sperren wollen, die in der Systemdatei FUSER oder FNAT enthalten sind, müssen Sie die VSAM-Dateien FLOCK, FLOCKA, FLOCKB und FLOCKC unter Com-plete mit der CA-Funktion des Com-plete-Dienstprogramms UFILE katalogisieren.

Wenn Sie in NTVSAM PATH=CHECK angegeben haben, müssen Sie Ihr Frontprogramm mit der CA-Funktion des Com-plete-Dienstprogramms ULIB ( Beschreibung siehe Com-plete-Dokumentation) mit einer Regionsgröße von 36 KB nach Com-plete katalogisieren, wenn Sie den ersten Standardwert für die WPSIZE (Beschreibung siehe Parameter-Referenz-Dokumentation) im Natural-Parametermodul nicht geändert haben.

CICS CICS Fügen Sie in Ihrem FCT die folgenden Einträge hinzu:

  • die für VSAM erforderlichen Natural-Systemdateien FNAT, FUSER, FDIC und FDICX;

  • die für VSAM vorgesehenen Natural-Beispiel-Dateien EMPLVS und EMPLVX;

  • die Natural Security-Dateien FSEC, FSECA, FSECB und FSECC, wenn Sie Natural Security installiert haben;

  • die VSAM-Dateien FLOCK, FLOCKA, FLOCKB und FLOCKC, wenn Sie Quellcode-Objekte, die in der Systemdatei FUSER oder FNAT enthalten sind, im VSAM-Dateisystem sperren wollen.

Beispiele finden Sie im Job VSAMI005. Sie können DD-Anweisungen für diese Datasets auch zu Ihrem CICS-Startjob hinzufügen.

TSO Fügen Sie die folgenden Anweisungen in die CLIST ein, die zum Starten von Natural verwendet wird: 
ALLOCATE F(FNAT)   DATASET('SAGLIB.VSAM.FNAT')        SHR
ALLOCATE F(FUSER)  DATASET('SAGLIB.VSAM.FUSER')       SHR
ALLOCATE F(FDIC)   DATASET('SAGLIB.VSAM.FDIC')        SHR
ALLOCATE F(FDICX)  DATASET('SAGLIB.VSAM.FDIC.PATH')   SHR
ALLOCATE F(FSEC)   DATASET('SAGLIB.VSAM.FSEC')        SHR
ALLOCATE F(FSECA)  DATASET('SAGLIB.VSAM.FSEC.AIXA')   SHR
ALLOCATE F(FSECB)  DATASET('SAGLIB.VSAM.FSEC.AIXB')   SHR
ALLOCATE F(FSECC)  DATASET('SAGLIB.VSAM.FSEC.AIXC')   SHR
ALLOCATE F(FLOCK)  DATASET('SAGLIB.VSAM.FLOCK')       SHR
ALLOCATE F(FLOCKA) DATASET('SAGLIB.VSAM.FLOCK.PATHA') SHR
ALLOCATE F(FLOCKB) DATASET('SAGLIB.VSAM.FLOCK.PATHB') SHR
ALLOCATE F(FLOCKC) DATASET('SAGLIB.VSAM.FLOCK.PATHC') SHR
ALLOCATE F(EMPLVS) DATASET('SAGLIB.VSAM.EMPLVS')      SHR
ALLOCATE F(EMPLVX) DATASET('SAGLIB.VSAM.EMPLVX.PATH') SHR

Installation auf VSAM-Systemdateien überprüfen

Sie können die erfolgreiche Installation von Natural for VSAM überprüfen, indem Sie die folgenden Schritte ausführen:

  • Melden Sie sich bei der Natural-Systembibliothek SYSEXNVS an und führen Sie die folgenden Programme aus:

    • NVSINST1

    • NVSINST2

    • NVSINST3

    • NVSINST4

    • NVSINST5

    • NVSINST6

    Wenn diese Programme alle erfolgreich ausgeführt werden können, ist die Installation von Natural in einem VSAM-Dateisystem abgeschlossen und verifiziert.

Hinweis für den Batch-Modus:

Zur Überprüfung im Batch-Modus können Sie den Job VSAMI200 ausführen, der die oben genannten Programme ausführt.

Einschränkung

Die für VSAM-Dateisysteme bereitgestellten Systemdateien Natural FSEC und FSPOOL können nicht für die gemeinsame Nutzung von Datensätzen (Record-Level Sharing, RLS) verwendet werden, da auf die zugehörigen AIX-Dateien nicht über eine Pfaddefinition zugegriffen werden kann. Der Grund dafür ist, dass Nullwerte bei der VSAM-Upgrade-Behandlung für AIX-Schlüssel nicht unterdrückt werden. Bei AIX-Schlüsseln, die mit Leerzeichen oder binären Nullen gefüllt sind, würde die Satzlänge der AIX-Dateien für FSEC und FSPOOL überschritten werden. Dies würde unter CICS zu Problemen führen, da die unterstützte Datensatzlänge auf 32 K begrenzt ist. Natural for VSAM unterstützt die Unterdrückung von Nullwerten für AIX-Schlüssel und das Upgrade-Handling für AIX-Dateien.

On this page