Dieses Dokument beschreibt die Installation von Natural Review (Produktcode RNM) unter z/OS.
Informationen zu den Merkmalen und Funktionen von Natural Review finden Sie in der Natural Review-Dokumentation.
In diesem Dokument steht die Notation vrs oder
vr für die jeweilige Produktversion (siehe
auch Version im
Glossar).
Siehe Allgemeine Voraussetzungen und Systemunterstützung und Übersicht über den Installationsvorgang.
Das Natural Review Monitoring System benötigt CICS Shared Storage für die Sammlung seiner
Monitoring-Daten. Für jede Natural-Sitzung wird ein Benutzerkontobereich von 656 Byte plus
Platz für eine Natural-Aufruftabelle (Natural Call Table, NCT) zugewiesen. Diese Tabelle
wird verwendet, um die Natural-Programme und Datenbankaufrufe innerhalb einer Transaktion
zu verfolgen. Die Anzahl der NCT-Einträge wird durch den Parameter NCTSIZE im
Quellcode-Member RNMSCB3.A bestimmt (siehe Installationsschritt
Natural Review System Control
Block erstellen). Jeder Tabelleneintrag ist 48 Byte lang und die
Tabelle enthält 32 Einträge (standardmäßig). Daraus ergibt sich eine Gesamtmenge von
656+32*48=2192 Byte pro laufender Sitzung. Der Speicherplatz wird bei Beendigung der
Sitzung freigegeben.
Jeder aktive Antwortzeitbericht erfordert einen 400 Byte langen Grundkontrollblock. Jeder
Detailsatz ist 128 Byte lang. Die maximale Anzahl der Detaildatensätze pro Bericht wird
durch die Anzahl der Datensätze (Number of Records) in der Berichtsdefinition
gesteuert. Wenn die Option Transaction Summary (Transaktionszusammenfassung)
in der Berichtsdefinition gesetzt ist, wird für jede Transaktionskennung (ID) ein 64 Byte
großer Transaktionszusammenfassungsbereich zugewiesen.
Nachdem ein Bericht von der History Session in die Natural Review Repository-Datei geschrieben wurde, wird der gesamte berichtsabhängige Speicher freigegeben.
Der Installationsdatenträger enthält die folgenden Datasets, die für die Produktinstallation erforderlich sind:
| Dataset-Name | Inhalt |
|---|---|
RNMvrs.LOAD |
Lademodule |
RNMvrs.SRCE |
Quellcode-Module und Makros |
RNMvrs.SYSF |
Natural-Systemdateidefinition |
RNMvrs.JOBS |
Beispiel-Installationsjobs |
RNMvrs.INPL |
Natural-Objekte |
Kopieren Sie die Datasets in Ihre Umgebung, wie unter Datasets auf eine z/OS-Platte kopieren im Kapitel Natural auf z/OS installieren beschrieben.
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: CICS-Control-Table-Einträge für Natural Review hinzufügen
Schritt 3: Vorhandene Natural Review-Repository-Datei migrieren
Schritt 7: SYSRNM-Bibiliothek in Natural Security definieren
Schritt 9: Startmodul für die Natural Review History Session verlinken
(Job I005, Step 2211)
Definieren Sie die folgenden CICS-Tabelleneinträge mit RDO. Je nach Ihren Anforderungen müssen Sie möglicherweise zusätzliche Parameter hinzufügen. Natural Review unterstützt die Transaktionsisolation (d. h., es kann im User Key laufen).
Definieren Sie die Start-/Stopptransaktion der Natural Review History Session:
CEDA DEFINE TRANSACTION(RVH1) PROGRAM(RNMHIST3)
GROUP(RNMvr)
Definieren Sie die Transaktion für die asynchrone Natural Review History-Sitzung:
CEDA COPY TRANSACTION(xxxx) GROUP(yyyy) AS(RVH2)
TO(RNMvr)
Dies kopiert Ihre bestehende Natural-Transaktionskennung
xxxx aus Ihrer
Natural-Definitionsgruppe yyyy als
Alias-Transaktion für Natural Review. Diese Definition ist optional und Sie können
auch den Online-Natural-Transaktionscode
xxxx verwenden, aber sie hilft dem
Administrator bei der Identifizierung der asynchronen History Session für Natural
Review.
Die Transaktionscodes RVH1 und RVH2 sind frei wählbar
(d. h. Sie können sie bei Bedarf ändern). Der Transaktionscode der Natural-Sitzung
muss derselbe sein, der mit dem Parameter NATTRAN definiert
wurde (in diesem Beispiel NATTRAN=RVH2). Siehe Installationsschritt
Steuerblock für das
Natural Review System erstellen und Installationsüberprüfung (Unterpunkt 4).
Definieren Sie das Start-/Stopp-Programm für die Natural Review History Session:
CEDA DEFINE PROGRAM(RNMHIST3) LANGUAGE(ASSEMBLER)
GROUP(RNMvr)
Definieren Sie den Natural Review-Systemsteuerblock:
CEDA DEFINE PROGRAM(RNMSCB3) LANGUAGE(ASSEMBLER)
RESIDENT(YES) GROUP(RNMvr)
Nachdem Sie die Online-Definitionen eingegeben haben, müssen Sie sie unter
Verwendung von CEDA INSTALL GROUP(RNMvr)
aktivieren. Die neue GROUP sollte zu der für einen CICS-Kaltstart
definierten GRPLIST hinzugefügt werden.
Dieser Tabelleneintrag ist optional. Sie können ihn zum automatischen Starten und Beenden der Natural Review History Session beim CICS Startup und Shutdown verwenden.
Definieren Sie das Start-/Stopp-Programm für der Natural Review History Session:
DFHPLT TYPE=ENTRY,PROGRAM=RNMHIST3
Fügen Sie den Tabelleneintrag in Ihrer assemblierten PLTPI- und/oder PLTSD-CICS-Tabelle hinzu. Dadurch wird ein manuelles Starten und Stoppen der Natural Review History Session vermieden (siehe Installationsschritt Natural Review System Control Block erstellen.
(Job I050, Step 2620)
Sie können diesen Schritt überspringen, wenn Sie bereits eine Natural Review-Repository-Datei installiert haben.
Bei der Repository-Datei handelt es sich um eine Adabas-Datei, in der Antwortzeitberichte und Verlaufsdaten gespeichert werden. Es ist möglich, die Repository-Datei für mehrere CICS-Regionen gemeinsam zu nutzen. Die Repository-Datei für Natural Review kann in einer beliebigen Adabas-Datei gespeichert werden. Die entsprechende Dateinummer muss in Natural als logische Systemdatei definiert werden (siehe Installationsschritt Natural Review Repository-Datei initialisieren Natural-Parameter-Modul erstellen). Die Repository-Datei muss über Natural initialisiert werden (siehe Installationsschritt Natural Review Repository-Datei initialisieren).
Bevor Sie den Job übergeben, müssen Sie ihn wie folgt ändern:
Ändern Sie die Dataset-Definitionen entsprechend Ihren Anforderungen.
Ändern Sie DB=dbid in den
Adabas-ADARUN-Statements auf die richtige Datenbankkennung.
Ändern Sie SVC=nnn auf die korrekte
Adabas-SVC-Nummer.
Ändern Sie das Adabas-ADALOD-Statement auf die Dateinummer
(fnr) der Adabas-Datei, die die
Natural Review-Repository-Datei enthält, und die Natural Review-Version
(vrs), die Sie verwenden::
ADALOD LOAD FILE=fnr,NAME='REPOS-RNMvrs'
(Job I050, Step 2620)
Sie können diesen Schritt überspringen, wenn Sie eine Natural Review-Repository-Datei mit dem Installationsschritt Natural Review-Repository-Datei laden installiert haben.
Falls Sie von einer älteren Natural Review-Repository-Datei mit einer niedrigeren Version als Natural 9.2 migrieren, muss ein Migrationsschritt durchgeführt werden.
Alternativ können Sie einen ADADBS-Job ausführen, der die folgenden Karten
enthält:
//DDKARTE DD * ADADBS OPERCOM STOPF=fnr,PURGE ADADBS NEWFIELD FILE=fnr ADADBS NEWFIELD FNDEF='01,DY,8,A,NU'
wobei Sie fnr durch die Dateinummer Ihrer
Natural Review-Repository-Datei ersetzen müssen.
(Job I060, Steps 0010, 0015)
Ändern Sie die Einstellungen der mit dem Natural-Parametermodul gelieferten Parameter wie folgt:
RDCSIZE=2 MADIO=5000 MAXCL=0 RCA=NATGWREV NTLFILE 180,dbid,fnr
wobei:
RDCSIZE der
Natural-Profilparameter ist, der bestimmt, ob eine Sitzung von Natural Review
überwacht wird. Wenn Sie für eine Sitzung RDCSIZE=0 setzen (dies ist
der Standardwert), wird sie nicht von Natural Review überwacht.
Der Natural-Profilparameter RCA ist erforderlich, wenn Sie das Natural
Review Monitor-Schnittstellenmodul getrennt vom Nukleus (siehe Installationsschritt
Natural Review System
Control Block erstellen) mit Hilfe der RCA-Technik
verknüpfen möchten.
NTLFILE (bzw. der dynamische LFILE-Parameter) ist das Makro,
das die Natural Review-Repository-Datei bestimmt, die von der
SYSRNM-Anwendung zum Abrufen und Pflegen von Berichtsdefinitionen und
zum Speichern von Verlaufsberichtsdaten für die Verlaufssitzung verwendet wird. Die
Repository-Datei, auf die aktuell zugegriffen wird, kann mit dem Kommando
LFILE innerhalb von Natural Review geändert werden
(siehe Natural
Review-Dokumentation).
dbid ist die Datenbankkennung (ID) und
fnr die im Installationsschritt
Natural Review-Repository-Datei
laden angegebene Dateinummer.
Einzelheiten zu den oben genannten Parametern finden Sie in der Parameter-Referenz-Dokumentation.
Assemblieren und verlinken Sie das Natural-Parameter-Modul.
(Job I060, Step 0020)
Verlinken Sie den Nukleus für Natural Review, indem Sie das folgende Modul aus der
Natural Review-Ladebibliothek RNMLIB einbinden:
INCLUDE RNMLIB(RNMNUC3)
Natural Review verwendet die Exit-Schnittstelle des Natural Data Collector, um Daten von Natural abzurufen. Weitere Informationen zum SYSRDC Data Collector finden Sie unter SYSRDC Utility in der in der Debugger- und Dienstprogramme (Utilities)-Dokumentation.
Das Natural-Review-Modul RNMNUC3 unterstützt alle verschiedenen Arten von statisch verknüpften Natural- Subprogrammen. Weitere Informationen zur Verlinkung des Nukleus finden Sie unter Natural-Objekte mit dem Natural-Nukleus verlinken in der Natural-Operations-Dokumentation.
Wenn Sie einen umgebungsunabhängigen Nukleus für mehrere Umgebungen (z. B. CICS und
Batch) verwenden, müssen Sie RNMNUC3 mit dem umgebungsabhängigen
Nukleus verlinken, da das Natural Review Monitoring nur unter CICS läuft. Dies
verhindert eine unnötige Überlastung Ihrer Nicht-CICS-Systeme.
Wenn RNMNUC3 nicht mit dem umgebungsabhängigen Nukleus verlinkt
ist, muss der folgende CICS Assembler Command Level-Stub aus der CICS-Ladebibliothek
mit RNMNUC3 verlinkt werden:
INCLUDE CICSLIB(DFHEAI)
Anstatt RNMNUC3 mit dem Nukleus zu verlinken, können Sie es als
separates Modul verlinken, das mit dem Natural-Profil-Parameter RCA definiert ist
(beschrieben in der Parameter-Referenz-Dokumentation). Die
folgenden Anweisungen des Linkage-Editors sind dann erforderlich:
MODE RMODE(ANY) INCLUDE CICSLIB(DFHEAI) INCLUDE RNMLIB(RNMNUC3) ENTRY NATGWREV NAME NATGWREV
Die MODE-Anweisung ist optional. Für das Modul NATGWREV
ist ein CICS PPT-Eintrag erforderlich. Er muss mit dem Profilparameter RCA angegeben werden
(siehe Installationsschritt
Natural-Parametermodul
erstellen). Das Modul kann von mehreren Natural- Nuklei
gemeinsam genutzt werden.
(Job I061, Step 2661)
Wenn Sie ein von Ihnen geändertes Profiltextobjekt DEFAULT weiter
verwenden möchten, müssen Sie Ihr DEFAULT-Objekt in der
SYSRNM-Bibliothek umbenennen, bevor Sie mit dem Laden der neuen
Natural-Objekte beginnen.
Laden Sie mit dem Dienstprogramm Natural INPL die für Natural Review spezifischen Natural-Objekte aus dem
Dataset RNMvrs.INPL in Ihre
FNAT-Systemdatei.
Es genügt, die Natural-Objekte nur in eine FNAT-Systemdatei zu laden,
selbst wenn Sie auch andere FNAT-Systemdateien überwachen möchten.
Das Natural Review User Profile Subsystem wird initialisiert, wenn das
Profiltextobjekt DEFAULT in die Bibliothek SYSRNM kopiert
wird.
Wenn Sie das Profiltextobjekt DEFAULT im ersten Installationsschritt
umbenannt haben, müssen Sie das neu geladene DEFAULT durch dieses
Objekt ersetzen.
Dieser Schritt ist nur relevant, wenn Natural Security installiert ist.
Definieren Sie die Natural-Review-Bibliothek SYSRNM in Natural
Security.
Sie können ein Startmenü für die Bibliothek SYSRNM definieren. Wenn
die Bibliothek personengeschützt (People-protected) ist, muss jeder
Benutzer dieser Bibliothek mit ihr verlinkt werden.
Definieren Sie REVHIST als Benutzer vom Typ PERSON mit
einer Standardanwendung SYSRNM. REVHIST wird von der
Natural Review History Session als Benutzerkennung verwendet.
(Job I070, Steps 2622, 2623)
Der Natural Review System Control Block RNMSCB3 ist als Programm in CICS
definiert. Bei RNMSCB3 handelt es sich nicht um ein ausführbares Programm.
Sein Speicher wird von Natural Review als gemeinsamer Anker und Kontrollpunkt für alle
überwachten Natural-Sitzungen und Berichte innerhalb eines CICS-Adressraums verwendet.
Es gibt einige installationsspezifische Generierungsparameter, die Sie im Objekt
RNMSCB3 in der Natural Review-Quellcodebibliothek angeben können.
Setzen Sie die folgenden Parameter in RNMSCB3 entsprechend Ihren
Anforderungen:
| Parameter | Erläuterung | ||||||
|---|---|---|---|---|---|---|---|
NATTRAN= |
Dies ist der Natural/CICS-Transaktionscode für die Natural Review History Session. Sie müssen diesen Parameter angeben, um den korrekten Natural-Transaktionscode festzulegen (siehe Installationsschritt CICS-Control-Table-Einträge für Natural Review hinzufügen). | ||||||
NPARMS= |
Zusätzliche dynamische Natural-Parameter für die Natural-Review History
Session.
Dieser Parameter ist optional. |
||||||
CLOSE= |
|
||||||
DATE= |
|
||||||
EMPTY= |
|
||||||
NCTSIZE= |
Dieser Parameter bestimmt die Anzahl der Einträge in der Natural Call Table (NCT) von Natural Review. Die NCT wird im gemeinsamen CICS-Speicher zugeordnet und wird verwendet, um die Nutzung der Natural-Programme pro Sitzung zu verfolgen. Die Standardeinstellung ist |
||||||
Ändern Sie den Job RNMI070 und führen Sie ihn aus, um den Natural
Review System Control Block zu generieren. Das Modul muss mit der Option
NORENT verlinkt werden. Die Ziel-Link-Bibliothek kann eine beliebige,
für CICS definierte Bibliothek sein.
(Job I070, Step 2625)
Natural Review- History-Daten werden von einer asynchronen (d. h. nicht terminalgebundenen) Natural-Sitzung in die Natural Review-Repository-Datei geschrieben.
Ändern Sie den Job RNMLINK in der Natural Review-Quellcodebibliothek
und führen Sie ihn aus.
Dieser Job verlinkt das CICS-abhängige History-Session-Startmodul
RNMHIST3. Die Ziel-Link-Bibliothek kann eine beliebige, für CICS
definierte Bibliothek sein.
Innerhalb eines CICS-Adressraums kann es nur eine History Session geben. Die
Natural-Objekte, die für Natural Review spezifisch sind (siehe Installationsschritt
Neue Natural-Objekte
laden), müssen in die FNAT-Systemdatei geladen
werden, die mit der History Session läuft.
Verwenden Sie die folgende CEMT-Transaktion, um das Nukleus-Modul zu aktivieren,
mit dem RNMNUC3 und das geänderte Natural-Parametermodul verlinkt
sind:
CEMT SET PROGRAM(. . . .) NEWCOPY
Falls Sie das Nukleusmodul nicht aktivieren können, müssen Sie CICS neu starten.
Wenn Ihre Natural Review-Repository-Datei bereits initialisiert ist, können Sie diesen Schritt überspringen.
Initialisieren Sie die Repository-Datei, nachdem Sie sie im Installationsschritt Natural Review-Repository-Datei laden geladen haben:
Melden Sie sich bei der Bibliothek SYSRNM an. Dazu geben Sie bei der
NEXT-Eingabeaufforderung Folgendes ein:
INSTALL NM
Daraufhin werden die folgenden Meldungen angezeigt:
Now creating sample report system response time Now creating sample report highest response Natural Review repository initialization complete. Press <ENTER> to continue
Während des Initialisierungsvorgangs werden zwei Standardberichte (Beispielberichte) zur Reaktionszeit hinzugefügt, wie oben gezeigt.
Sie können die erfolgreiche Installation von Natural Review überprüfen, indem Sie die folgenden Schritte ausführen:
Geben Sie bei einer beliebigen Natural-Eingabeaufforderung Folgendes ein:
SYSRNM
Natural Review wird gestartet und ein Natural Review-Logo-Bildschirm ähnlich dem folgenden Beispiel wird angezeigt:
17:30:01 ***** REVIEW NM UTILITY ***** date
RRRRRRRR EEEEEEE VVV VVV III EEEEEEE WWW WWW
RRRRRRRRR EEEEEEE VVV VVV III EEEEEEE WWW WWW
RRR RRR EEE VVV VVV III EEE WWW WWW
RRR RRR EEE VVV VVV III EEE WWW WWW
RRRRRRRR EEEEEE VVV VVV III EEEEEE WWW W WWW
RRRRRRRR EEEEEE VVV VVV III EEEEEE WWW WW WWW
RRR RRR EEE VVV VVV III EEE WWW WWWW WWW
RRR RRR EEE VVV VVV III EEE WWW WWWWWW WWW
RRR RRR EEEEEEE VVVVVV III EEEEEEE WWWWW WWWWW
RRR RRR EEEEEEE VVVV III EEEEEEE WWW WWW
N A T U R A L M O N I T O R
A P R O D U C T O F S O F T W A R E A G |
(Sie können die Anzeige dieses Bildschirms unterdrücken, indem Sie
BANNER=N im Textobjekt CONFIG in der Bibliothek
SYSRNM angeben.)
Drücken Sie ENTER, um das Natural Review-Hauptmenü (Main Menu) aufzurufen:
17:30:17 ***** REVIEW NM UTILITY ***** date
- Main Menu -
Code Function
NM Natural Monitor System
UP User Profile System
Command ===>
REV00001 - Welcome to Review NM running under CICS
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Fin |
Alternativ können Sie das Hauptmenü aufrufen, indem Sie sich bei der Bibliothek
SYSRNM anmelden und dann das folgende Kommando eingeben:
MENU
Geben Sie in der Kommandozeile (Command) des Natural
Review-Hauptmenü-Bildschirms eines der folgenden Kommandos ein:
NM
(für das )
oder
UP
(für das )
Je nach dem eingegebenen Kommando erscheint der Hauptbildschirm des gewünschten Subsystems. Sie können dann Ihre Installationsparameter und den Status der History Sessions überprüfen. Ausführliche Informationen zu den Funktionen der Subsysteme finden Sie in der Natural Review-Dokumentation.
Wenn Sie Historienberichte ausführen möchten, müssen Sie die Historiensitzung starten. Sie läuft als asynchrone (nicht-terminalgebundene) Natural-Sitzung und schreibt die gesammelten Berichtsdaten nach Ablauf eines Berichtszeitintervalls in die Repository-Datei.
Sie können die History-Sitzung entweder automatisch mit dem CICS PLTPI/PLTSD (siehe
Schritt 1: CICS-Steuertabelleneinträge für Natural Review hinzufügen) oder manuell
außerhalb von Natural mit der RVH1-Transaktion (siehe
Installationsschritt CICS-Control-Table-Einträge für Natural Review
hinzufügen) wie folgt starten und beenden:
RVH1 |
Startet die Natural Review History Session mit dem Transaktionscode
RVH2, wie mit NATTRAN im Installationsschritt
Natural Review System
Control Block erstellen definiert.
Die
History-Sitzung kann auch mit dem |
RVH1 STOP |
Beendet die Natural Review History Session.
Die History-Sitzung kann
auch mit dem Kommando |
RVH1 TEST |
Startet die Natural Review History Session am aktuellen Terminal.
Diese Option kann zu Debugging-Zwecken verwendet werden, z. B. um die History-Sitzung mit CEDF (der CICS-Debugging-Funktion) zu debuggen. Beachten Sie, dass während der normalen Verarbeitung der History-Sitzung keine Natural-Terminal-Ein-/Ausgaben unterstützt werden. Daher müssen Sie die History-Sitzung von einem anderen Terminal aus beenden. |
Überprüfen Sie die Natural Review-Initialisierungsmeldungen im Konsolenprotokoll
Ihres CICS-Systems, um herauszufinden, ob die History-Sitzung erfolgreich gestartet
wurde. Es sollte die folgende Meldung angezeigt werden: REV20200 - REVIEW
NM HISTORY SESSION STARTED.
Ausführlichere Erläuterungen zu den Meldungen in Natural Review erhalten Sie, wenn
Sie in der Kommandozeile von Natural Review MSG gefolgt von der
Meldungsnummer (z. B. MSG 1) eingeben.