Entire System Server Interface installieren

#### Search Results

Search

# Entire System Server Interface installieren

Das Entire System Server Interface ist erforderlich, wenn der Entire System Server verwendet werden soll.

Dieses Dokument beschreibt die Schritte zur Installation des Entire System Server Interface unter z/OS. Sie können zwischen einer Standardinstallation (empfohlen) und einer angepassten Installation wählen.

- Voraussetzungen

- Standardinstallation oder angepasste Installation

- Parametermodul für die Entire System Server Interface-Komponente assemblieren

- Entire System Server Interface mit dem Nukleus verlinken

- Write-to-Spool Feature installieren und aktivieren

- Entire System Server im Einzelbenutzermodus installieren

#### Verwandtes Thema:

Informationen zur Installation und Verwendung des Entire System Server finden Sie in der entsprechenden Produktdokumentation.

#### 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 das Entire System Server Interface verwenden können, müssen Sie eine unterstützte Version des Entire System Server installieren, die unter Von Natural unterstützte Produkt-Versionen in der aktuellen Natural for z/OS Freigabemitteilung (Release Notes) angegeben ist.

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

## Standardinstallation oder angepasste Installation

Wenn Sie die Standardwerte in den Modulen `ESYNODTB` und `NATPNIP` (die von Entire System Server und Natural ISPF verwendet werden) verwenden möchten, fahren Sie mit Entire System Server Interface mit dem Nukleus verlinken fort.

Wenn Sie die Standardwerte nicht verwenden möchten, müssen Sie die in diesem Abschnitt beschriebenen Module `NATPNIP` und `ESYNODTB` ändern.

- NATPNIP

- ESYNODTB

### NATPNIP

Das Modul `NATPNIP` enthält die folgenden Parameter und Standardwerte:

    NAMVIEWP BUFLEN=12288,NUMREQ=5,MAXCBL=3000,MAXEDL=6000,EXTUSER=INIT-USER

Die Parameter werden im Folgenden erläutert:

Parameter | Erläuterung
--- | ---
`BUFLEN` | Länge aller Adabas Buffer in Bytes
`NUMREQ` | Anzahl der möglichen verschachtelten `FIND`-Schleifen in Natural, die den Entire System Server aufrufen
`MAXCBL` | Komplexe `FIND`-Buffer-Länge
`MAXEDL` | Länge des Editor Session Buffer `MAXEDL` wird vom NSPF-Editor und der Incore-Datenbank verwendet. Der Standardwert ist `6000`, was für eine NSPF-Editor-Sitzung und typische Incore-Datenbankanwendungen ausreichend sein sollte. Für große Layouts innerhalb einer Incore-Datenbankdatei ist dieser Wert jedoch möglicherweise nicht groß genug. Dann wird die folgende Meldung ausgegeben: `NAT3077: Not enough space for extent. DB/FNR/Subcode :1:/:2:/:3:.` Siehe Messages and Codes-Dokumentation). In diesem Fall muss der Wert von `MAXEDL` erhöht werden.
`EXTUSER` | Externe Benutzerkennung, die dem Entire System Server für Security-Überprüfungen übergeben wird. Siehe auch `EXTUSER` im folgenden Abschnitt.

> EXTUSER

>   Der Parameter `EXTUSER` beschreibt, wie Sicherheitsdefinitionen von einem externen Sicherheitssystem wie RACF, ACF2 und TOP-SECRET übernommen werden können.

>   Die geeignete Parametereinstellung hängt davon ab, ob in Ihrer Umgebung ein Multi-User-Adressraum oder ein Single-User-Adressraum verwendet wird:

>   - Ein Multi-User-Adressraum bietet die Möglichkeit, verschiedene Benutzer-Security-Definitionen zu pflegen, z.B. eine für einen CICS- und eine für einen Com-plete-Benutzer).

>   - Ein Einzelbenutzer-Adressraum unterstützt ein Subsystem, z.B. eine Natural-Subtask für Entire Output Management oder Entire Operations, oder einen Natural RPC, ein Natural Web/IO Interface oder einen Batch-Server.

>     Empfohlene Werte für `EXTUSER`:

>     `EXTUSER=INIT-USER` | Empfohlen für einen Multi-User-Adressraum. Der Inhalt der Natural-Systemvariablen `*INIT-USER` muss mit der Benutzerdefinition im externen Security-System (z. B. RACF) identisch sein. Der Entire System Server überträgt den Wert von `*INIT-USER` an das externe Security-System, und alle Aufrufe an sicherheitsbedingt eingeschränkte Ressourcen werden unter dieser Benutzerkennung behandelt. In diesem Fall wird die Security-Definition eines CICS- oder Com-plete-Benutzers (z. B.) vom Entire System Server übernommen, und eine Neuanmeldung ist nicht erforderlich. Wenn der Wert von `*INIT-USER` (siehe Systemvariablen-Dokumentation) nicht in RACF gefunden wird (z. B.), tritt ein Fehler auf, der anzeigt, dass eine Anmeldung erforderlich ist.
>     `EXTUSER=USER` | Empfohlen für einen Multi-User-Adressraum in einer Natural Security-Umgebung. Die Verarbeitung ist ähnlich wie bei `EXTUSER=INIT-USER`, außer dass die Natural-Systemvariable `*USER` (siehe Systemvariablen-Dokumentation) verwendet wird.
>     `EXTUSER=ADDRESS-SPACE` | Empfohlen für eine TSO-, Batch- oder Serverumgebung. Die Security-Beschreibung dieses Adressraums wird für die Sicherheitsevaluierung vererbt.

### ESYNODTB

Das Modul `ESYNODTB` enthält die folgenden Parameter und Standardwerte:

    NAMXNOD ID=148,NAME=PRODUCTION-1
    NAMXNOD ID=149,NAME=PRODUCTION-2
    NAMXNOD ID=1490,NAME=DBID-ABOVE-255,LAST=Y
    END

Die Parameter und Standardwerte werden im Folgenden erläutert:

`ID` | Knotennummer des Entire System Server (auch bekannt als DBID)
`NAME` | Knotenname des Entire System Server
`LAST` | Kennzeichnung des letzten Eintrags in der Tabelle

#### Optionaler Knotenname für Entire System Server-Aufrufe

Aufrufe von Natural an den Entire System Server werden in der Regel mit dem `NODE`-Parameter gehandhabt, der die Knotennummer angibt, die für den Aufruf verwendet werden soll, zum Beispiel:

    FIND ACTIVE-JOBS WITH JOB-NAME = 'ADA*' AND NODE = 148

Wenn die Knotennummer im Modul `ESYNODTB` definiert ist, können Sie alternativ den logischen Namen des gewünschten Entire System Server mit dem Parameter `NODE-NAME` angeben, z. B:

    FIND ACTIVE-JOBS WITH JOB-NAME = 'ADA*' AND NODE-NAME = 'PRODUCTION-2'

## Parametermodul für die Entire System Server Interface-Komponente assemblieren

### Natural ISPF

Wenn Natural ISPF als INCORE-Datenbank verwendet wird:

- (Job I055, Step 1106)

  Verlinken Sie das Parametermodul `NATPNIP`. In diesem Fall wird das Modul `ESYNODTB` nicht benötigt.

### Entire System Server

Wenn der Entire System Server verwendet wird:

- (Job I055, Steps 1106, 1107)

  Assemblieren und verlinken Sie die Module `NATPNIP` (Step 1106) und (optional) `ESYNODTB` (Step 1107).

## Entire System Server Interface mit dem Nukleus verlinken

(Job I060, Step 3720)

- Verlinken Sie die folgenden Entire System Server Interface-Module entweder mit dem umgebungsunabhängigen Nukleus oder mit dem umgebungsabhängigen Nukleus, indem Sie die entsprechenden `INCLUDE`-Anweisungen verwenden:

       INCLUDE NATLIB(NATPNIP)
  | Parameter für das Entire System Server Interface
       INCLUDE NATLIB(ESXNUC)
  | Entire System Server Interface-Modul
       INCLUDE NATLIB(ESYNODTB)
  | Optional, Knotentabelle

## Write-to-Spool Feature installieren und aktivieren

Wenn Sie das Write-to-Spool Feature nutzen wollen, müssen Sie entweder die Zugriffsmethode mit Ihrem Nukleus verlinken oder die Methode dynamisch laden. Siehe auch die Natural-Parameter `RCA` und `RCALIAS`.

Sie können die Standardeinstellungen für Ihren Nukleus definieren und assemblieren, indem Sie das Quellcode-Member `NATPWSDF` verwenden, bevor Sie die Standardeinstellungen mit dem Nukleus verlinken. Das Quellcode-Member `NATPWSDF` finden Sie in der Quellcode-Bibliothek (Source Library) von Natural.

Die Standardeinstellungen des Quellcode-Members `NATPWSDF` sind wie folgt:

    NAMPWSPL NODE=148,
    PROGRAM=,
    CLASS=A,
    HOLD=YES,
    CNTL=A,
    FORM=,
    RMT=,
    FORMDEF=,
    PAGEDEF=

Die folgende Tabelle zeigt die veränderbaren Parameter des Quellcode-Members `NATPWSDF` und enthält die ausführliche Beschreibung dieser Parameter:

Parameter | Beschreibung
--- | ---
`Node` | Node NPR-Zielknoten. Die Knotennummer kann aus bis zu 5 Ziffern bestehen. Sie adressiert die gestartete Destination Task des Entire System Server und wohin die Ausgabe geschrieben wird.
`Program` | JES Writer, das bis zu 8 Zeichen enthalten kann. JES übergibt die Kontrolle an das Writer-Programm. Wenn JES es nicht findet, wird es ignoriert. Möglicher Wert: `*OUTPUT` bedeutet, dass die Eingabe des Natural-Statement `DEFINE PRINTER` verwendet wird, um als JES Writer interpretiert zu werden.
`Class` | `SYSOUT`-Klasse innerhalb von JES, in die die Ausgabe geschrieben werden soll. Sie kann nur ein Zeichen oder eine Ziffer enthalten. Sie ist ein Deskriptor für weitere Software (z.B. Entire Output Management), um den Ausgabedatenstrom für die Verarbeitung zu erkennen.
`Hold = yes/no` | Gibt an, ob der Ausgabedatenstrom in der JES-Spool gehalten werden soll, falls die zuvor vom Entire System Server gestartete Task abbricht.
`CNTL` | Stellt das Steuerzeichen für den `SYSOUT`-Dataset dar. `CNTL` enthält ein Zeichen:
`A` | ASA-Steuerzeichen
`M` | Maschinensteuerzeichen
`FormRMT` | Beschreibt den Formular-Steuerpuffer für JES. Dieser Wert wird an JES übergeben, das dann die Verarbeitung abwickelt. `RMT` steht für die JES-Remote-User-ID, wenn `SYSOUT` an ein anderes JES-System weitergeleitet werden soll. Sie finden den Namen des JES-Systems im Destination-Feld des `DEFINE PRINTER`-Statements (z.B. `DEFINE PRINTER OUTPUT='DAEM'`).
`Formdef` `Pagedef` | Kann bis zu 6 Zeichen enthalten.

Nachdem Sie das Quellcode-Member `NATPWSDF` mit dem Bedarf entsprechenden Werten angepasst haben, können Sie es assemblieren und verlinken. Wenn Sie die Standardeinstellungen verwenden möchten, können Sie diesen Schritt auslassen.

Wenn Sie das Write-to-Spool Feature mit statisch verlinkter Zugriffsmethode an Ihrem Standort verwenden möchten, müssen Sie das Natural-Modul folgendermaßen neu verlinken:

    INCLUDE NATLIB(NATPWSPL)     The Write-to-Spool access method for Natural
    INCLUDE NATLIB(NATPWSDF)     The Write-to-Spool defaults
                                 (your adapted parameter module)

Wenn Sie dynamisches Laden verwenden wollen, können Sie entweder das ausgelieferte Modul `NATPWSAM` mit standardmäßig eingestellten Parametern oder Ihr an den Bedarf angepasstes Parametermodul verwenden:

    INCLUDE NATLIB(NATPWSPL)
    INCLUDE USRLIB(NATPWSPA)     Your adapted module
    NAME NATWSPvr(R)             Your adapted Write-to-Spool module.
                                 This name must be used in RCALIAS=(NATAM11,NATWSPvr).

Weitere Informationen finden Sie unter System-Spool-Zugang verwalten in der Operations-Dokumentation.

## Entire System Server im Einzelbenutzermodus installieren

(Optionale Installation nur für den Batch-Modus oder TSO.)

In diesem Abschnitt werden die Vorteile von Entire System Server im Einzelbenutzermodus (Single-User Mode) und die für die Installation erforderlichen Schritte beschrieben.

- Vorteile des Einzelbenutzermodus

- Installation für den Batch-Modus

- Installation für TSO

### Vorteile des Einzelbenutzermodus

Der Betrieb des Entire System Server im Einzelbenutzermodus ist beispielsweise in den folgenden Fällen vorteilhaft:

- Ausführen lang laufender Batch-Jobs, die eine große Anzahl von Aufrufen des Entire System Server erfordern.

- Durchführen von Testszenarien mit vielen Aufrufen an den Entire System Server in einer Natural-Sitzung unter TSO, ohne die Produktionsumgebung zu stören.

- Erproben neuer Funktionen oder Versionen von Entire System Server.

Aus Sicht von Natural ist der Entire System Server zugänglich im Einzelbenutzermodus als Entire System Server-Knoten 148, unabhängig davon, ob ein solcher Knoten bereits auf Ihrem Rechner oder im Netzwerk vorhanden ist.

Im Folgenden finden Sie ein Beispiel für ein Natural-Programm, das in einer Einzelbenutzerumgebung ausgeführt wird:

    FIND ACTIVE-JOBS WITH NODE = 148 AND JOB-NAME = 'XCOM*'

Dieses Statement ruft einen Single-User Entire System Server auf, der im gleichen Adressraum läuft. Der Aufruf eines anderen Entire System Server-Knotens, der an einer anderen Stelle im Netzwerk läuft, ist durch die Verwendung einer anderen Knotennummer möglich, wie im folgenden Beispiel gezeigt wird:

    FIND ACTIVE-JOBS WITH NODE = 53 AND JOB-NAME = 'NUC*'

Dieses Statement ruft einen Multi-User Entire System Server mit der Knotennummer 53 aus demselben Natural-Programm auf, das die Single-User Entire System Server-Sitzung aufgerufen hat.

### Installation für den Batch-Modus

1. Erstellen Sie eine neue PDS-Ladebibliothek, die APF-autorisiert sein muss.

2. Kopieren Sie alle Members der Entire System Server-Ladebibliothek in die neue Ladebibliothek.

3. Verlinken Sie das Modul `NATPSNGL`, das Entire System Server Single-User Features handhabt, mit dem umgebungsabhängigen Nukleus für Batch Natural.

   Alternativ können Sie den Parameter `RCA` verwenden, um dieses Modul dynamisch zu laden, indem Sie `RCA=NATPSNGL` setzen.

   In beiden Fällen muss der umgebungsabhängige Nukleus durch den Parameter `AC=1` autorisiert und in die neue Ladebibliothek gelinkt werden.

4. Fügen Sie Ihrer JCL die obligatorischen Karten `PARMS` und `SYSPRINT` hinzu, um die für den Entire System Server relevanten Schritte abzuwickeln. Darüber hinaus können Sie die optionalen Karten `ESYTRACE` und `CLOG` hinzufügen.

       //ESYTRACE DD  SYSOUT=*             Internal trace
       //SYSPRINT DD  SYSOUT=*             Modules/Zap directory of Entire System Server
       //CLOG     DD  DISP=SHR,DSN=xxx     Command log data set
       //PARMS    DD  DISP=SHR,DSN=xxx     Entire System Server parameter

5. Fügen Sie eine Adabas-Ladebibliothek zu Ihrer JCL hinzu, die ebenfalls APF-autorisiert sein muss.

6. Editieren Sie Ihr Entire System Server-Parameter-Member. Hier wird der Parameter `NODE` ignoriert, da Natural alle Aufrufe an den Knoten 148 an den Single-User Entire System Server-Knoten weiterleitet.

### Installation für TSO

1. Fügen Sie den Namen des Knotens als `AUTHPGM` in das TSO-Definitions-Member mit dem Namen IKJTSO00 ein. Normalerweise befindet sich dieses Member im Dataset `SYS1.PARMLIB`.

2. Gehen Sie analog zur oben beschriebenen Installation für den Batch-Modus vor.

### On this page

- Voraussetzungen
- Standardinstallation oder angepasste Installation
- Parametermodul für die Entire System Server Interface-Komponente assemblieren
- Entire System Server Interface mit dem Nukleus verlinken
- Write-to-Spool Feature installieren und aktivieren
- Entire System Server im Einzelbenutzermodus installieren