Entire Operations Utilities benutzen

Entire Operations Utilities können Sie benutzen, um ausgewählte Entire Operations-Funktionen auszuführen.

Eine Entire Operations Utility ist für gewöhnlich ein eigenständiges Natural-Programm, das online benutzt oder durch einen Natural-Batch-Job aufgerufen werden kann.

Dieses Kapitel behandelt folgende Themen:

• Einleitung

• Auszug von Log-Daten auf die Log-Auswahl-Datei

• Alte Daten in der Log-Auswahl-Datei löschen

• Accounting-Daten aus dem Entire Operations-Log drucken

• Monitor- oder Task-Wartezeit ändern

• Monitor beenden

• Monitor starten

• BS2000-Jobs

• TO-ACTIVATE-Kommandosätze auflisten oder löschen

• Vorhandensein von Symboltabellen-Definitionen prüfen

• Massenänderung des Eigentümers und Eigentümer löschen

• Massenänderung der gewährten Zugriffsrechte für Netzwerke

• Massenänderung der Benutzerkennung in Netzwerk- und Job-Definitionen

• Massenänderung im Batch-Modus für Benutzer-Zugang zu Knoten

• Massenänderung von Knoten-Nummern

• Logon-Massenverarbeitung im Batch-Modus

• Massenänderung der Job-Netzwerk-/Symboltabellen-Version

• MACRO-Kommando-Massenverarbeitung im Batch-Modus

• Daten-Migration in die aktuelle Entire Operations-Version

Einleitung

• Erforderliche LFILE-Zuweisungen

• Log-Auswahl-Datei - Format 1

Erforderliche LFILE-Zuweisungen

Log-Auswahl-Datei - Format 1

Eine leere Log-Auswahl-Datei (LFILE=215, NOP-LOG-SELECT-1) für Accounting-Daten ist Teil der Entire Operations-Installations-Dateien.

Das DDM für die Log-Auswahl-Datei ist EOR-LOG-SELECTION-1.

Das DDM wird mit Deskriptoren auf fast jedem Feld zur Verfügung gestellt. Der Benutzer kann entscheiden, welche Deskriptoren nicht nötig sind, und diese freigeben.

Die Datei kann mit Natural gelesen und ausgewertet werden.

DB 255, Datei 215

Diese Datei gilt für die Standardfolge der NOP-LOG-SELECTION-1-Datei.

Auszug von Log-Daten auf die Log-Auswahl-Datei

Natural-Programm-Aufruf

LGAX1S-P P-DATE-FROM P-DATE-TO

Parameter

Anmerkungen:

1. Start- und Ende-Datum für den Auszug sind optional. Wenn gewünscht, müssen beide Parameter gleichzeitig angegeben werden. Ist das Start-Datum kleiner als der Zeitstempel in der privaten Steueranweisung (siehe Anmerkung 2 und 3), wird der Auszug nicht ausgeführt.
2. Der Auszug von Log-Daten fängt immer da an, wo der letzte Auszug aufhörte.
3. Dieser Zeitstempel ist in einer privaten Steueranweisung gespeichert. (Wird das Programm erstmals aufgerufen, so wird das Start-Datum 19.11.2008 benutzt.)
4. Bei den Auszugs-Daten handelt es sich um Accounting-Daten (siehe Bericht-Typen im Abschnitt Berichte).
5. Neue Auszugs-Daten überschreiben existierende Auszugs-Daten nicht.

Alte Daten in der Log-Auswahl-Datei löschen

Natural-Programm-Aufruf

LGAX1D-P  P-RETENTION-DAYS

Parameter

Accounting-Daten aus dem Entire Operations-Log drucken

Natural-Programm-Aufruf

LG-AP1-P  P-TIME-FROM  P-TIME-TO

Parameter

Monitor- oder Task-Wartezeit ändern

Natural-Programm-Aufruf

MO-WTM-P  P-MONITOR-WAIT-TIME [P-TASK-ID]

Parameter

Anmerkungen:

1. Falls eine Wartezeit von weniger als 5 Sekunden angegeben wird, wird die Wartezeit auf 5 Sekunden gesetzt.
2. Die mit diesem Programm vorgenommenen Änderungen gelten nur bis zum Ende des aktuellen Monitor-Laufes.

Monitor beenden

Natural-Programm-Aufruf

MO-SHD-P

Parameter

Keine.

Monitor starten

Natural-Programm-Aufruf

MO-ST--P P-MONITOR-NODE

Parameter

BS2000-Jobs

Diese Jobs werden genutzt, um Benutzerkennung, Passwort und Account-Nummer zu ändern.

Natural-Programm-Aufruf

BS2U01-P
     P-OWNER P-USERID-OLD P-PW-OLD P-USERID-NEW P-PW-NEW
     P-ACCOUNT-NEW

Parameter

Anmerkungen:

1. Ein Stern (*) für einen Parameter wird in ein Leerzeichen umgewandelt.
2. Job-Felder werden nur dann ausgetauscht, wenn der Entire Operations-Eigentümer, die alte BS2000-Benutzerkennung und das alte Jobstart-Passwort nicht übereinstimmen.
3. Felder werden nur dann ersetzt, wenn der neue Wert nicht leer ist.
4. Es wird ein Protokoll am Bildschirm ausgegeben. Im Batch-Modus erfolgt die Ausgabe des Protokolls auf den Natural-Drucker 1. Er muss daher in der JCL entsprechend zugewiesen werden.

TO-ACTIVATE-Kommandosätze auflisten oder löschen

Natural-Programm-Aufruf

TA-DEL-P P-FUNCTION

Parameter

Anmerkungen:

1. Mit dieser Batch-Utility können Sie die zu aktivierenden internen TO-ACTIVATE-Kommandosätze in der aktiven Datenbank von Entire Operations auflisten oder löschen.
2. Verwenden Sie diese Utility nur in Zusammenarbeit mit dem Software AG-Support, und wenn Sie die TO-ACTIVATE-Kommandosätze manuell entfernen müssen.
3. Diese Utility kann nur benutzt werden, wenn der Entire Operations-Monitor nicht läuft.

Vorhandensein von Symboltabellen-Definitionen prüfen

Natural-Programm-Aufruf

CHNWST-P P-FUNCTION

Parameter

Der Bericht wird im Batch-Modus in die Druckdatei 1 und im Online-Modus auf den Bildschirm geschrieben.

Massenänderung des Eigentümers und Eigentümer löschen

Natural-Programm-Aufruf

OW-MB--P 
P-OWNER-OLD P-OWNER-NEW P-ALLOW-UPDATE

Als Trennzeichen zwischen den Parametern muss je nach Festlegung im Natural-Profilparameter ID (Input Delimiter/Eingabe-Begrenzungszeichen) statt des Leerzeichens ein Komma (,) benutzt werden.

Parameter

Anmerkungen

• Der Natural-Session-Parameter IM (Input-Modus/Eingabe-Modus) muss auf IM=F (Forms-Modus) gesetzt sein.

• Der Entire Operations-Monitor muss während der Ausführung dieser Utility angehalten werden.

• Die alten und neuen Eigentümer-Namen dürfen nicht SYSDBA sein.

• Die Utility läuft in zwei Durchläufen ab. Während des ersten Durchlaufes werden die zu ändernden Daten auf mögliche Probleme abgeprüft. Eine Fehlermeldung (Zeile mit E:) führt dazu, dass der Änderungsmodus (P-ALLOW-UPD) auf N eingestellt wird. Ein typisches Problem ist "Ziel vorhanden", wenn ein Umbenennen des Eigentümers zum Mischen von Entire Operations-Objekten innerhalb eines Netzwerks führen würde. Eine Warnungsmeldung (Zeile mit W:) verweist auf eine Situation, die von Interesse ist, allerdings das Umbenennen des Objekts nicht verhindert.

• Der zweite Durchlauf erfolgt entweder das reale Ändern oder der Diagnose-Lauf. Dies ist abhängig vom Änderungsmodus-Wert.

• Jedes zu ändernde oder geänderte Objekt wird in einem Bericht vermerkt, der in die Natural-Hauptausgabe geschrieben wird.

• Die Utility muss mit der im exklusiven Adabas (EXU)-Modus geöffneten Entire Operations-Systemdatei 1 ablaufen, was bedeutet, dass der Entire Operations-Monitor und jede andere Natural-Sitzung mit der Entire Operations-Systemdatei 1 zuvor beendet werden muss. Die Erfüllung dieser Voraussetzung ist unabdinglich, um die Integrität der Entire Operations-Objekte und -Verknüpfungen zwischen ihnen zu schützen. Daher schlagen wir vor, den Natural-Profilparameters OPRB zur Angabe einer exklusiven Aktualisierungserlaubnis mit folgender Einstellung zu benutzen:

  OPRB=(EXU=fnop1,UPD=fnat,flog,ACC=fsec)

  Dabei ist:

  • fnop1 = Entire Operations-Systemdatei 1

  • fnat = Natural-Systemdatei FNAT

  • flog = Entire Operations- oder System Automation Tools-Log-Datei

  • fsec = Natural Security-Systemdatei

  Andere zum Ausführen von Natural erforderliche Dateien sollten in der Liste UPD= oder ACC= hinzugefügt werden.

• Wir schlagen zum Start von OW-MB--P einen Job mit folgenden Schritten vor :

  • Schritt 0: Adabas ADAORD/ADASAV/ADAULD, um die Entire Operations-Systemdatei 1 zu speichern, wenn der folgende OW-MB--P im Änderungsmodus läuft;

  • Schritt 1: Adabas ADADBS-Utility mit Parametern:

    ADADBS OPERCOM
    STOPF=fnop1
    ADADBS OPERCOM LOCKX=fnop1

  • Schritt 2: Natural-Session mit OW-MB--P;

  • Adabas ADADBS:

    ADADBS OPERCOM
    UNLOCKX=fnop1

• Wenn die Utility in einer "normalen" Natural-Session läuft, ist für sie im Adabas-WORK-Bereich (höchstwahrscheinlich) kein Speicherplatz mehr frei oder das maximale ISN Hold-Limit ist erreicht oder die Utility wartet auf Sätze, die von anderen gehalten werden (auch beim Änderungsmodus N). Wir empfehlen daher ausdrücklich, dass Sie die Utility nur im Batch-Modus ausführen.

• Es gibt einen anderen Natural-Profilparameter, DBUPD=OFF (Datenbankänderung nicht erlaubt), der benutzt werden kann, um diese Utility sicher und parallel zu anderen Sitzungen ablaufen zu lassen, allerdings kann der Utility-Bericht aufgrund anderer Aktivitäten an der Entire Operations-Systemdatei 1 unzutreffende Fehlermeldungen ausgeben.

• Wenn OW-MB--P den Fehler E: ... targets exist (xx: nnn) ausgibt, um anzuzeigen, dass die Ziele existieren, dann ist xx der zwei Zeichen umfassende Zielcode und nnn die Anzahl der gefundenen Zielsätze.

  Dabei bedeutet der Zielcode xx Folgendes:

  Zielcode	Bedeutung	Erläuterung
  NM	Network Master	Netzwerk-Definition
  JM	Job Master	Job-Definition
  EM	Event Master	Ereignis-Definition
  JA	Job Active	Aktiver Job
  EA	Event Active	Aktives Ereignis
  JC	JCL Active	Aktive JCL
  CO	Condition Active	Aktive Bedingungen
  SA	Symbol Active	Aktives Symbol
  RP	Resource Prerequisite	Ressource-Voraussetzung
  RU	Resource Usage	Ressource-Verwendung

• Vorhandene Ziele erscheinen in der oben angegebenen Reihenfolge im Bericht, z.B. EM bedeutet, dass die Ziele NM und JM nicht gefunden wurden.

  Wenn das Ziel im Bericht wie folgt lautet:

  • JM: Fehlende Netzwerk-Definition manuell erstellen, und darin erscheinen dann die Jobs. Sie wieder deaktivieren/löschen.

  • CO: Diese sind in Aktive Bedingungen sichtbar.

• Der Rest der Ziele kann mit der Batch Utility CL-ORP-P zum Bereinigen von verwaisten Objekten bereinigt werden:

  CL-ORP-P owner update-mode

  Alle Parameter sind Pflichtangaben:

  Name	Format	Beschreibung
  owner	A10	Eigentümer-Name. P-OWNER-NEW aus dem fehlerbehafteten OW-MB--P-Lauf. Die Angabe SYSDBA ist nicht zulässig.
  update-mode	L	Änderungsmodus: N oder Y.

• Alles weiter oben Gesagte zur Ausführung von OW-MB--P gilt gleichermaßen für CL-ORP-P, d.h. die Ausführung muss mit dem Natural-Profilparameter OPRB erfolgen, um die Entire Operations-Systemdatei 1 im exklusiven Änderungsmodus zu öffnen, oder der Profilparameter DBUPD=OFF kann für diagnostische Zwecke eingesetzt werden. Der Bericht über (möglicherweise) gelöschte verwaiste Objekte wird in die Natural-Hauptausgabe geschrieben.

• Stellen Sie sicher, dass alle Berichte von OW-MB--P- und CL-ORP-P-Läufen mit Änderungsmodus Y aufbewahrt werden.

Massenänderung der gewährten Zugriffsrechte für Netzwerke

Natural-Programm-Aufruf

LOGON SYSEOR
NV-MB--P
 P-FUNCTION,P-OWNER,P-NETWORK,P-VERSION,P-TYPE,P-NAME,P-OPTION
FIN

Mit dem Natural-Programm NV-MB--P können Sie gewährte Zugriffsrechte für Netzwerke hinzufügen, ändern oder löschen. Das Programm NV-MB--P kann im Online- und im Batch-Modus laufen.

Voraussetzung: Der Natural-Profil-/Session-Parameter ID (Input Delimiter/Eingabe-Begrenzungszeichen) muss auf ID=, (Komma) gesetzt sein.

Beispiel:

LOGON SYSEOR
NV-MB--P
U,EXAMPLE,*,*,O,NOPALL,DORA

Im obigen Beispiel werden die Zugriffsberechtigungen des Eigentümers NOPALL für alle Netzwerke und Netzwerkversionen des Eigentümers EXAMPLE auf DORA geändert.

Parameter

Massenänderung der Benutzerkennung in Netzwerk- und Job-Definitionen

Natural-Programm-Aufruf

US-UPD-P
     P-FUNCTION P-OLD-VALUE P-NEW-VALUE P-OWNER P-NETWORK

Parameter

Massenänderung im Batch-Modus für Benutzer-Zugang zu Knoten

Mit der Utility NOPUNA-P können Sie einzelne oder mehrere Benutzer für den Knoten-Zugang über definierte Betriebssystemkennungen hinzufügen oder ändern.

Natural-Programmaufruf

NOPUNA-P

Wenn die Utility NOPUNA-P im Batch-Modus ausgeführt wird, muss die Arbeitsdatei 1 mit LRECL 130 definiert sein. Die Arbeitsdatei darf Kommentarzeilen enthalten, die durch einen Stern (*), einen Doppel-Stern (**) oder einem Schrägstrich und Stern (/*) an der ersten und zweiten Stelle des Datensatzes als solche gekennzeichnet sind.

Für jede hinzuzufügende oder zu ändernde Benutzerkennung müssen Sie eine eigene Zeile im folgenden Format definieren:

nop-userid,node-number,os-userid,os-group,ld-value,aj-value,as-value

Jede erfolgreiche Benutzer-Änderung wird im Entire Operations-Protokoll (Log) protokolliert.

Beispiel:

EXAMPLE,517,nprusr01,Nprgrp01,Y,Y,Y

Felder in den Eingabezeilen

Die für den Programmaufruf benutzten Variablen-Felder sind in der folgenden Tabelle beschrieben:

Massenänderung von Knoten-Nummern

Natural-Programmaufruf

ND-MB--P
LOCATION NODE-OLD NODE-NEW OWNER NETWORK

Parameter

Anmerkungen

1. Sowohl NODE-OLD als auch NODE-NEW müssen definiert werden, Gültigkeit haben und zu derselben Betriebssystemart gehören, d.h. Sie können den Knoten z/OS in z/OS ändern, aber nicht z/VSE in z/OS.

2. Wenn für die Parameter OWNER, NETWORK und NETWORK-VERSION nichts angegeben wird, enthalten diese einen Stern (*). Dies ist der Standardwert.

   Platzhalterzeichen ("Wildcard-Notation") werden akzeptiert: Stern (*), größer als (>), kleiner als (<).

   Wenn OWNER ein Platzhalterzeichen enthält, dann enthält NETWORK einen Stern (*).

   Das Programm ND-MB--P kann (nur zum Auflisten von Objekten) in einer Natural-Session mit dem Natural-Profilparameter DBUPD=OFF (Datenbankänderung nicht erlaubt) sicher gestartet werden.

Logon-Massenverarbeitung im Batch-Modus

• Natural-Programm-Aufruf

• Felder in den Eingabezeilen

• Anmeldungen bei Einzel-Knoten ohne Arbeitsdatei-Benutzung

Natural-Programm-Aufruf

ND-LB--P

Die Utility ND-LB--P muss in einer Natural-Batch-Umgebung ablaufen.

Die Anmeldung (Logon) wird sowohl in SYSOUT als auch in das Entire Operations-Protokoll (SAT-Log) geschrieben. Passwörter werden nicht protokolliert.

Die Eingabe wird von Natural-Arbeitsdatei 1 gelesen. Für jede durchzuführende Anmeldung muss eine Zeile in dem folgenden Format definiert sein:

node userid group password

Beispiel:

517 sag users sag-pwd

Kommentarzeilen müssen als erstes Zeichen einen Stern (*) haben. Die Ausgabe wird in den Natural-Batch-Job-SYSOUT und in das Entire Operations-Protokoll geschrieben.

Felder in den Eingabezeilen

148 USER - USER-PWD

Anmerkungen:

1. Diese Utility kann nur benutzt werden, wenn der Entire Operations-Monitor nicht läuft.
2. Es kann eines oder mehrere Leerzeichen zwischen den Parametern stehen.
3. Wenn keine Gruppe oder Domäne eingesetzt wird, geben Sie bitte stattdessen ein Minuszeichen (-) ein.
4. Bei UNIX- und Windows-Knoten wird bei der Eingabe zwischen Groß- und Kleinbuchstaben unterschieden.
5. Bei Großrechner-Knoten werden die Text-Zeichenfolgen in Großbuchstaben konvertiert, bevor die Anmeldung (Logon) durchgeführt wird.

Warnung: Benutzer dieser Utility müssen sich darüber im Klaren sein, dass die Eingabedatei sehr sicherheitssensitiv ist, weil sie Passwörter in reinem Text enthält.

Anmeldungen bei Einzel-Knoten ohne Arbeitsdatei-Benutzung

Um Anmeldungen (Logon) bei Einzel-Knoten ohne Arbeitsdatei-Benutzung zu ermöglichen, können die Parameter auch über die Natural-Kommandozeile übergeben werden.

Die Kommandozeilenparameter sind:

1. Knoten-Nummer

2. Benutzerkennung

3. group (UNIX) bzw. domain (Windows)

   (Übergabe eines Minuszeichens (-), falls die Default Group bzw. keine Domain benutzt werden soll)

4. Passwort

Bei diesen Parametern ist auf Groß-/Kleinschreibung zu achten.

Bei der Rückgabe liefert ND-LB--P einen Rückmeldecode in der AIV-Variablen +ND-LB--P-RC (I4) zurück. Sie enthält bei erfolgreicher Anmeldung 0 (Null) bzw. einen anderen Code im Fehlerfall.

Massenänderung der Job-Netzwerk-/Symboltabellen-Version

• Natural-Programm-Aufruf

• Parameter

• Anmerkungen

Natural-Programm-Aufruf

OV-MB--P
P-OBJECT-TYPE P-OBJECT-OWNER P-OBJECT-NAME P-OLD-OBJECT-VERSION P-NEW-OBJECT-VERSION P-ALLOW-UPD

Abhängig von der Einstellung des Natural-Session-/Profilparameters ID (Input Delimiter/Eingabe-Begrenzungszeichen) müssen die Parameter evtl. durch ein Komma statt durch ein Leerzeichen voneinander abgetrennt werden.

Parameter

Anmerkungen

1. Der Natural-Session-Parameter IM (Input Mode/Eingabe-Modus) muss auf IM=F (Forms-Modus) gesetzt sein.

2. Um unerwartete Ergebnisse bei Netzwerk-Aktivierungen zu vermeiden, sollte der Entire Operations-Monitor sollte bei der Ausführung dieser Utility gestoppt sein.

3. Das Programm kann im Falle eines Abbruchs erneut gestartet werden, um die Umbenennungsmaßnahme zu beenden.

4. Zu jedem Objekt, das geändert wird bzw. geändert werden soll, wird in einem Bericht aufgeführt, der in die Natural-Hauptausgabedatei geschrieben wird.

MACRO-Kommando-Massenverarbeitung im Batch-Modus

Das Programm MAC-GE-P führt das MACRO-Kommando für eine gegebene Auswahl an Job-Netzwerken im Batch-Betrieb aus.

• Natural-Programm-Aufruf

• Parameter

• Ergebnisprüfung

Natural-Programm-Aufruf

Voraussetzung: Der Natural-Profil-/Session-Parameter ID (Input Delimiter/Eingabe-Begrenzungszeichen) muss auf ID=, (Komma) gesetzt sein.

LOGON SYSEOR
MAC-GE-P
MODE,OWNER,NETWORK,NETWORK-VERSION
FIN

Beispiel

LOGON SYSEOR
MAC-GE-P
A,SN,A-1,v-unnamed
FIN

Parameter

Die Parameter P-OWNER, P-NETWORK und P-NETWORK-VERSION können folgende Platzhalterzeichen ("Wildcards") für die Auswahl enthalten:

*, >, <, ?

Anmerkungen:

1. Das Programm MAC-GE-P muss im Batch-Modus gestartet werden.
2. Die Natural-Profilparameter LC=ON (Leading Characters/Vorangestellte Zeichen) und EDPSIZE=100 (Größe des Software AG Editor Auxiliary Buffer Pool) müssen gesetzt sein.
3. In Großrechnersystemen muss der Entire Operations-Monitor aktiv sein. Der Task 90 muss laufen.

Ergebnisprüfung

Das SYSOUT des Batch-Jobs enthält ausführliche Informationen über die erfolgte Katalogisierung. Die Ergebnisse können hier überprüft werden.

Beispiel

Owner      Network    Version    Job        Library  Member   Result 
SN         A-1        v-unnamed  MAC1-541   EOR-T541 MAC1     Done
SN         A-1        v-unnamed  MAC1N511   EOR-N541 MAC1     Error
>>> NAT0806 - Library not found.

Daten-Migration in die aktuelle Entire Operations-Version

Bei der Migration der Daten in die aktuelle Entire Operations-Version werden verschiedene Objekte und Felder so angepasst, dass sie in der aktuellen Entire Operations-Version verwendet werden können.

DMDRIV-P

Anmerkungen:

1. Die Migration der Daten erfolgt in mehreren voneinander unabhängigen Migrationsschritten.

2. Jeder Migrationsschritt wird nur einmal ausgeführt. Durch interne Kontrollaufzeichnungen werden Mehrfachausführungen verhindert.

3. Der Migrationsaufruf kann so oft wie nötig erfolgen.

   Es wird empfohlen, zur Ausführung der Migration einen Natural-Batch-Job zu verwenden.

   Die entsprechenden Natural-Kommandos lauten:

   LOGON SYSEOR
   DMDRIV-P
   FIN

4. Die Migration wird in der Natural-Datei SYSOUT protokolliert.

5. Die Daten-Migration kann nur bei nicht aktivem Entire Operations-Monitor erfolgen.