Konfiguration

In diesem Dokument wird beschrieben, wie ein Natural Subprogram Server (NPI-Server) für z/OS (Batch) konfiguriert wird.

Dieses Dokument behandelt die folgenden Themen:

Konfigurationserfordernisse

Für einen Natural Subprogram Server for z/OS (Batch) ist folgende Konfiguration der z/OS-Language Environment-Parameter erforderlich:

Parameter Definition
POSIX(ON) Ermöglicht einem Natural Subprogram Server den Zugriff auf die POSIX-Funktionalität von z/OS. Wenn Sie einen Natural Subprogram Server mit POSIX(OFF) starten, wird er sofort mit einem User Abend vom Typ U4093 und der Systemmeldung EDC5167 beendet. IBM liefert die Standardeinstellung OFF.
TRAP(ON,NOSPIE)

Definiert die Behandlung von Programmabbrüchen in der LE/370-Umgebung:

ON

Aktiviert den Language Environment Condition Handler.

NOSPIE

Legt fest, dass das Language Environment Programmunterbrechungen und Programmabbrüche über einen ESTAE behandelt. Das bedeutet, dass der Natural Abend Handler für Programmabbrüche die Kontrolle erhält, um Programmunterbrechungen und Programmabbrüche zu behandeln.

Wenn Sie TRAP(ON,NOSPIE) nicht angeben, funktioniert die Natural-Abend-Behandlung nicht ordnungsgemäß. IBM liefert die Standardeinstellung (ON,SPIE).

TERMTHDACT(UADUMP) Legt fest, welche Informationen im Falle eines Abends ausgegeben werden. Die Option UADUMP erzeugt einen Sprachumgebungs-, einen CEEDUMP und einen System-Dump des Benutzeradressraums. Der CEEDUMP enthält keine für Natural relevanten Speicherbereiche. IBM liefert die Standardeinstellung (TRACE).
ENVAR(TZ=…) Mit der Option ENVAR können Sie Linux-Umgebungsvariablen festlegen. Die einzige für den NPI-Server relevante Umgebungsvariable ist TZ (Zeitzone). Mit dieser Variablen können Sie den Zeitstempel in der Trace-Datei des NPI-Servers an Ihre Ortszeit anpassen.

Beispiel (minus 1 Stunde Sommerzeit):

ENVAR(TZ=CET-1DST) CET

Sie können die Parameter der z/OS Language Environment wie folgt festlegen:

  • Durch Angabe des Parameters PARM auf der EXEC-Karte des Natural Subprogram Server-Startjobs. Die Länge der Optionen ist durch die maximale Länge des Parameters PARM begrenzt.

  • Assemblierenen Sie ein LE/370-Laufzeitoptionsmodul CEEUOPT und verlinken Sie es mit dem Natural Subprogram Server-Lademodul.

Konfiguration der externen Security

Wenn Sie den Natural Subprogram Server so konfigurieren, dass er die NPI-Clients im Natural Subprogram Server impersoniert (Konfigurationsparameter SECURITY_MODE auf IMPERSONATE_LOCAL gesetzt), muss der Natural Subprogram Server "programmgesteuert" ausgeführt werden. Unter RACF sind für den Natural Subprogram Server folgende Definitionen erforderlich:

  • Die Ressource BPX.SERVER muss definiert werden, und das Natural Subprogram Server-Konto muss über Lesezugriff (READ) auf diese Ressource verfügen.

  • Die in der Startup-Job-Definition definierten LOAD-Datensätze müssen der Programmklasse ** zugeordnet werden. 

    ralt program ** addmem('natural load library') uacc(read)
                ralt program ** addmem('NPI load library'//NOPADCHK) uacc(read)
                ralt program ** addmem('user load library'//NOPADCHK) uacc(read)

  • SETR WHEN(PROGRAM) REFRESH

Zusätzlich muss jeder Client, der eine Verbindung zum Server herstellt, in RACF definiert werden und die Berechtigung zur Nutzung der z/OS Linux System Services erhalten.

Konfigurationsdatei

Eine Konfigurationsdatei wird dem Namen STGCONFG zugeordnet.

Die Konfigurationsdatei ist eine Textdatei, die sich unter z/OS in einem Dataset oder in einer HFS-Datei befindet.

Die Konfigurationsdatei enthält die Serverkonfigurationsparameter in der Syntax keyword=value (Schlüsselwort=Wert). Darüber hinaus kann sie Kommentare enthalten, deren Anfang mit einem Rautezeichen (#).

Weitere Informationen siehe Beispiel für eine Konfigurationsdatei.

Konfigurationsparameter

Die folgenden Konfigurationsparameter stehen zur Verfügung:

FRONTEND_NAME | FRONTEND_OPTIONS | FRONTEND_PARAMETER | HANDLE_ABEND | HOST_NAME | IGNORE_PRESENT_SERVER | INITIAL_USERID | PORT_NUMBER | SECURITY_MODE | SESSION_PARAMETER | THREAD_NUMBER | THREAD_SIZE | TRACE_LEVEL | WORKER_DELAY

FRONTEND_NAME

Dieser Konfigurationsparameter gibt den Namen des Natural-Frontends an, das zum Starten einer Natural-Sitzung verwendet werden soll. Das Frontend befindet sich in einem PDS-Member. Es muss eintrittsinvariant (reentrant) oder wiederverwendbar verlinkt sein.

Wert Erläuterung
frontend-name

Name des zu verwendenden Natural-Frontends. Die maximale Länge beträgt 8 Zeichen.

Es ist kein Standardwert vorgegeben.

Beispiel:

FRONTEND_NAME=NATvrsSV

Dabei steht vrs für Versions-, Release- und System Maintenance Level-Nummer.

FRONTEND_OPTIONS

Die Werte dieses Konfigurationsparameters können verwendet werden, um zusätzliche Optionen für das Natural-Frontend festzulegen.

Wert Erläuterung
40 Klonen nicht verwenden.

Um die Initialisierung der Natural-Sitzung zu beschleunigen, wird jede neue Sitzung aus der bei der Serverinitialisierung erstellten Master-Sitzung geklont. Wenn Sie diese Option aktivieren, wird jede neue Sitzung von Grund auf neu initialisiert. Dies hat erhebliche Auswirkungen auf die Antwortzeit des Servers.

Beispiel:

FRONTEND_OPTIONS=40

FRONTEND_PARAMETER

Dieser optionale Konfigurationsparameter enthält zusätzliche Natural-Frontend-Parameter, wie im Bereich Startup-Parameter angegeben.

Wert Erläuterung
parameter-name Sie können mehrere Parameter definieren. Jede Parameterangabe besteht aus einem Paar von 8-stelligen Zeichenfolgen, wobei die erste das Parameterschlüsselwort und die zweite den Parameterwert enthält.

Es ist kein Standardwert vorgegeben.

Beispiel:

FRONTEND_PARAMETER='MSGCLASSX       '

Die Einstellung in diesem Beispiel legt fest, dass die Standardausgabeklasse für CMPRINT X ist.

Weitere Informationen siehe Operations (Verwaltung/Betrieb) > Natural als Server.

HANDLE_ABEND

Tritt während der Serververarbeitung außerhalb der Natural-Verarbeitung ein Ablaufabbruch auf, wird dieser vom Natural Abend Handling nicht abgefangen. Aus diesem Grund verfügt der Natural Subprogram Server über eine eigene Abend Recovery.

Wert Erläuterung
YES

Fängt Abbrüche bei der Serververarbeitung ab, erstellt einen Snap-Dump und bricht die Sitzung des betroffenen Benutzers ab.

Dies ist der Standardwert. Es wird empfohlen, den Standardwert zu verwenden, um die Auswirkungen eines Abbruchs auf einen einzelnen Benutzer zu beschränken.

NO Unterbindet die Server-Abbruchbehandlung. Jeder Abbruch bei der Serververarbeitung beendet die gesamte Serververarbeitung, was sich auf alle Benutzer dieses Servers auswirkt.

Beispiel:

HANDLE_ABEND=NO

HOST_NAME

Dieser optionale Konfigurationsparameter ist nur erforderlich, wenn der Server-Host mehrere TCP/IP-Stacks unterstützt.

Wert Erläuterung
host_name

Wenn HOST_NAME angegeben ist, empfängt der Server Verbindungen über den durch HOST_NAME angegebenen Stack; andernfalls empfängt der Server Verbindungen über alle Stacks.

Es ist kein Standardwert vorgegeben.

Beispiel:

HOST_NAME=node1

oder

HOST_NAME=157.189.160.55

IGNORE_PRESENT_SERVER

Ein Natural Subprogram Server ordnet eine sogenannte Serverumgebung zu, die die serverabhängigen gemeinsamen Ressourcen enthält. Diese Umgebung ist für jeden Server eindeutig und bezieht sich auf den Natural Subprogram Server-Namen.

Wenn ein Natural Subprogram Server nicht ordnungsgemäß beendet wird, kann dies dazu führen, dass die Serverumgebung in einem inkonsistenten Zustand verbleibt, wodurch nachfolgende Serverneustarts mit dem Fehler NAT9913 fehlschlagen.

Wenn Sie einen Natural Subprogram Server mit der Option IGNORE_PRESENT_SERVER=YES starten, kann dies zu einer Beschädigung eines bereits laufenden Servers führen, wenn dieser denselben Servernamen benutzt.

Wert Erläuterung
YES Beendet die vorhandene Serverumgebung.
NO Bricht die Serverinitialisierung ab, wenn bereits eine Serverumgebung vorhanden ist. Dies ist der Standardwert.

Beispiel:

IGNORE_PRESENT_SERVER=YES

INITIAL_USERID

Bei der Serverinitialisierung erstellt der Natural Subprogram Server eine temporäre Natural-Sitzung, um die Properties der installierten Natural-Umgebung abzurufen.

Dieser Konfigurationsparameter legt die Benutzerkennung fest, die für diese Natural-Sitzung verwendet werden soll.

Wert Erläuterung
userid Der angegebene Wert darf nicht länger als 8 Zeichen sein, andernfalls wird er gekürzt.
SYSTEM Dies ist der Standardwert.

Beispiel:

INITIAL_USERID=NPIINITU

Siehe auch Natural API Server > Natural Subprogram Server auf z/OS > Installation > Installation des Natural Subprogram Server auf z/OS > Schritt 5: Clients müssen in Natural Security definiert werden.

PORT_NUMBER

Dieser Konfigurationsparameter legt die TCP/IP-Portnummer fest, über die eine Verbindung zum Server hergestellt werden kann.

Wert Erläuterung
1 - 65535

TCP/IP-Portnummer.

Es ist kein Standardwert vorgegeben.

Beispiel:

PORT_NUMBER=3140

SECURITY_MODE

Der Natural Subprogram Server bietet ein Sicherheitskonzept, das auch die Betriebssystemressourcen umfasst. Die Anmeldedaten des Clients werden im betriebssystemabhängigen Security-System überprüft, und die Anfrage des Clients wird gemäß den Kontodaten des Clients ausgeführt.

Mit dem Parameter SECURITY_MODE können Sie festlegen, ob Clients unter z/OS mit Impersonierung ausgeführt werden. In diesem Fall läuft die Subtask des Clients entsprechend dem Konto des Clients.

Wert Erläuterung
IMPERSONATE_LOCAL

Die Impersonierung erfolgt innerhalb der Natural Subprogram Server-Umgebung. Der Client muss im externen Security-System des Natural Subprogram Servers (z. B. RACF) definiert sein.

Es ist kein Standardwert vorgegeben.

Anmerkungen:

  1. Der Parameter SECURITY_MODE setzt Natural Security (NSC) voraus.
  2. Es gilt für Natural for Db2 (nur Batch Server): Um den Natural Subprogram Server mit aktivierter Impersonierung auszuführen, muss das Db2-Schnittstellenmodul DSNRLI (anstelle von DSNALI) mit dem Natural-Nukleus verlinkt sein.

Beispiel:

SECURITY_MODE=IMPERSONATE

SESSION_PARAMETER

Dieser optionale Konfigurationsparameter definiert dynamische Session-Parameter, die für alle auf dem Natural Subprogram Server ausgeführten Sitzungen gelten.

Wert Erläuterung
parameter-string

Diese Zeichenfolge kann sich über mehrere Zeilen erstrecken. Ein Pluszeichen (+) am Ende einer Zeichenfolgezeile bedeutet, dass eine weitere Zeile folgt.

Es ist kein Standardwert vorgegeben.

Beispiel:

SESSION_PARAMETER='NUCNAME=NATNUCvr,' +
'FNAT=(10,930),FSEC=(10,310),' +
'FUSER=(10,32),' +
'PROFILE=(NPIPARM,18006,48),ADAMODE=1,' +
'BPI=(TYPE=NAT,SIZE=6044)'

Dabei steht vr für die Versions- und Release-Nummer.

THREAD_NUMBER

Dieser Konfigurationsparameter legt die Anzahl der vom Natural-Frontend zuzuordnenden physischen Speicher-Threads fest, d. h. die Anzahl der Sitzungen, die parallel ausgeführt werden können.

Wert Erläuterung
thread-number

Anzahl der zuzuordnenden physischen Speicher-Threads.

Anmerkung
Diese Zahl begrenzt nicht die Anzahl der Sitzungen innerhalb des Servers, sondern die Anzahl der Sitzungen, die gleichzeitig im Ausführungsstatus sein können. Die Anzahl der Sitzungen wird durch die Größe des Natural-Auslagerungsmediums begrenzt.

3

Dies ist der Standardwert.

Beispiel:

THREAD_NUMBER=5

THREAD_SIZE

Dieser Konfigurationsparameter legt die Größe jedes physischen Speicher-Threads fest, der zur Ausführungszeit die Natural-Sitzungsdaten enthält.

Wert Erläuterung
thread-size

Größe (in KB) jedes physischen Speicher-Thread.
500

Dies ist der Standardwert.

Beispiel:

THREAD_SIZE=800

TRACE_LEVEL

Wert Erläuterung
trace-level

Siehe Abschnitt Natural API Server > Natural Subprogram Server auf z/OS > Operation > Runtime Trace Facility > Trace Level.

0

Dies ist der Standardwert.

Beispiel:

TRACE_LEVEL=0x00000011

oder

TRACE_LEVEL=31+27

Die Einstellung in diesem Beispiel schaltet die Bits 31 und 27 ein.

WORKER_DELAY

Dieser Konfigurationsparameter legt fest, wie lange (in Sekunden) ein Worker auf aufeinanderfolgende Anfragen wartet. Siehe auch Worker Pool.

Wert Erläuterung
worker-delay

Wert, der angibt, wie lange (in Sekunden) ein Worker auf nachfolgende Anfragen wartet.

0

Dies ist der Standardwert. Es wird kein Worker Pool verwendet.

Beispiel:

WORKER_DELAY=10

Beispiel für eine Konfigurationsdatei

 # This is a comment
SESSION_PARAMETER= +
'profile=(npiqa,10,930),' +
'fuser=(10,32)'
THREAD_NUMBER=2
THREAD_SIZE=700
FRONTEND_NAME=NATOS92L       # and another comment
PORT_NUMBER=4711

Natural Subprogram Server Datasets

Der Natural Subprogram Server benötigt die folgenden Datasets:

STGCONFG Definiert die Serverkonfigurationsdatei.
STGTRACE Die Trace-Ausgabe des Servers.
STGSTDO Der stdo-Dataset.
STGSTDE Die stde-Fehlerausgabe.

On this page