Entire Operations Utilities benutzen

#### Search Results

Search

# 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

LFILE | Beschreibung
--- | ---
`216` | Entire Operations-System-Datei 1.
`131` | System Automation Tools Log File (Protokolldatei ).
`215` | Entire Operations-System-Datei 3 (Log-Auswahl-Datei).

### 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.

T | L | DB | Name | Format | S | D | Bemerkungen
--- | --- | --- | --- | --- | --- | --- | ---
* | EOR-Log-Auswahl
| 1 | AA | LGS-RECORD-TYPE | A6 | N | D |
* |
G | 1 | AB | LGS-BS2-DATA |  |  |  |
| 2 | AD | LGS-BS2-USERID | A8 | N | D |
| 2 | AE | LGS-BS2-ACCOUNT | A8 | N | D |
* |
G | 1 | AG | LGS-TIME-DATA |  |  |  |
| 2 | AH | LGS-CPU-TIME | P7.2 | N | D | /* in Sekunden
| 2 | AI | LGS-JOB-START | T12 | N | D | /* Datum + Zeit
| 2 | A7 | LGS-JOB-START-TIME-ZONE | A10 | N |  |
| 2 | AK | LGS-JOB-STOP | T12 | N | D | /* Datum + Zeit
| 2 | A8 | LGS-JOB-STOP-TIME-ZONE | A10 | N |  |
| 2 | AM | LGS-JOB-ELAPSED | P13.0 | N | D | /* in 1/10 Sekunden
* |
G | 1 | AN | LGS-DATA-3 |  |  |  |
| 2 | AO | LGS-LOG-TIME | T12 | N | D | /* Datum + Zeit
| 2 | BM | LGS-LOG-MICROSECONDS | P5.0 | N |  |
| 2 | BP | LGS-LOG-TIME-ZONE | A10 | N |  |
| 2 | AP | LGS-OWNER | A10 | N | D |
| 2 | AQ | LGS-NETWORK | A10 | N | D |
| 2 | AR | LGS-RUN | P13.0 | N | D |
| 2 | AS | LGS-JOB | A10 | N | D |
| 2 | AT | LGS-STATE | A3 | N | D | Möglicher Inhalt:
CHK | Zu prüfender Job.
ACT | Job ist aktiviert (aktiv).
JNO | Job nicht ok beendet.
JOK | Job ok beendet.
| 2 | AU | LGS-JOB-TYPE | A3 | N | D |
* |
| 1 | AY | LGS-EXECUTION-NODE-N5 | N5.0 | N | D |
| 1 | AW | LGS-JOB-ID | A10 | N | D |
| 1 | AX | LGS-OS-JOB-NAME | A8 | N | D |
| 1 | AZ | LGS-NETWORK-VERSION | A10 | N |  |
| 1 | A1 | LGS-EXEC-OPSYS-CLASS | A1 | N |  | Möglicher Inhalt:
B | BS2000
M | z/OS
V | z/VSE
X | UNIX
W | Windows
| 1 | A2 | LGS-SUBMIT-USERID | A50 | N |  |
| 1 | A3 | LGS-SUBMIT-GROUP | A50 | N |  |
| 1 | A4 | LGS-REPEAT-COUNT | P13.0 | N |  |
| 1 | A5 | LGS-SPECIAL-TYPE | A8 | N |  |
| 1 | A6 | LGS-DUMMY-FLAGS | A8 | N |  | Enthält den oder die Gründe, warum ein aktiver Job ein (temporärer) Dummy-Job ist. Eines oder mehrere (in willkürlicher Reihenfolge) der folgenden Kennzeichen sind möglich:
C | Bedingung
D | Definition (Job-Type `DUM`)
E | Leere JCL
J | JCL Prüfung
K | Zu deaktivierender Job
M | Mehrfachsuffix
R | Wiederherstellung
S | Zeitplan
T | Wiederholung
* |
* | Superdeskriptoren
* |
| 1 | AV | LGS-KEY-1 | A30 | N | S |
* |  |  | LGS-OWNER | 1-10 |  |  |
* |  |  | LGS-NETWORK | 1-10 |  |  |
* |  |  | LGS-JOB | 1-10 |  |  |

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

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

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

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-DATE-FROM` (optional) | A08 | Start-Datum für den Auszug im Format YYYMMDD.
`P-DATE-TO` (optional) | A08 | Ende-Datum für den Auszug im Format YYYMMDD.

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

- Parameter

### Natural-Programm-Aufruf

    LGAX1D-P  P-RETENTION-DAYS

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-RETENTION-DAYS` | I2 | Eintragungen älter als dieser Parameter werden gelöscht.

## Accounting-Daten aus dem Entire Operations-Log drucken

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

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

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-TIME-FROM` | A14 | Format: YYYYMMDDHHIISS
`P-TIME-TO` | A14 | Format: YYYYMMDDHHIISS

## Monitor- oder Task-Wartezeit ändern

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

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

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-MONITOR-WAIT-TIME` | I4 | Wartezeit in Sekunden.
`P-TASK-ID` | I2 | Nummer einer Monitor-Task (optional). Wenn die Nummer einer aktiven Monitor-Task angegeben wird, wird nur die Wartezeit dieser Task geändert. Wenn keine Task-Nummer angegeben wird, werden die Wartezeiten aller aktiven Monitor- Tasks geändert.

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

- Parameter

### Natural-Programm-Aufruf

    MO-SHD-P

### Parameter

Keine.

## Monitor starten

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

    MO-ST--P P-MONITOR-NODE

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-MONITOR-NODE` | I2 | Wert: 1 bis 99999 (Großrechner)

## BS2000-Jobs

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

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

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

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-OWNER` | A10 | Entire Operations-Eigentümer zu verändernder Jobs.
`P-USERID-OLD` | A8 | Auszutauschende BS2000-Benutzerkennung.
`P-PW-OLD` | A8 | Auszutauschendes BS2000 Jobstart-Passwort.
`P-USERID-NEW` | A8 | Neue BS2000-Benutzerkennung.
`P-PW-NEW` | A8 | Neues BS2000 Jobstart-Passwort.
`P-ACCOUNT-NEW` | A8 | Neue BS2000 Account-Nummer.

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

- Parameter

- Beispiele

### Natural-Programm-Aufruf

    TA-DEL-P P-FUNCTION P-OWNER P-NETWORK

### Parameter

Name | Format | Beschreibung
--- | --- | ---
P-FUNCTION | A1 | `D` | `TO-ACTIVATE`-Kommandosätze löschen.
`L` | `TO-ACTIVATE`-Kommandosätze auflisten.
P-OWNER | A10 | `*` | Alle Eigentümer.
`other` | Eigentümerauswahl. Platzhalter möglich.
P-NETWORK | A10 | `*` | Alle Netzwerke des oder der ausgewählten Eigentümer(s).
`other` | Netzwerkauswahl. Platzhalter möglich.

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 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.

### Beispiele

    TA-DEL-P D * *

entfernt alle `TO-ACTIVATE`-Objekte.

    TA-DEL-P D AA* *

entfernt `TO-ACTIVATE`-Objekte für Eigentümer, die mit 'AA' beginnen.

    TA-DEL-P D AAAA BBBB*

entfernt `TO-ACTIVATE`-Objekte für Eigentümer 'AAAA', Netzwerke, die mit 'BBBB' beginnen.

## Vorhandensein von Symboltabellen-Definitionen prüfen

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

    CHNWST-P P-FUNCTION

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-FUNCTION` | A1 |
Wert: | Bedeutung: |
`A` | Alle Netzwerke ohne eine Symboltabelle auflisten.
`S` | Unternetzwerke ohne eine Symboltabelle auflisten.

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

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

- Natural-Programm-Aufruf

- Parameter

- Anmerkungen

### 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

Name | Format | Beschreibung
--- | --- | ---
`P-OWNER-OLD` | A10 | Alter Eigentümer.
`P-OWNER-NEW` | A10 | Neuer Eigentümer. Wenn Sie hier `==DELETE==` angeben, wird der Eigentümer und alle mit diesem Eigentümer verbundenen Referenzen, z.B. Zuordnungen zu Benutzern, zu anderen Eigentümern und von dem Eigentümer verwaltete Objekte gelöscht.
`P-ALLOW-UPDATE` | A1 | Änderungsmodus.
Wert: | Bedeutung: |
`N` | Nur eine Prüfung durchführen.
`Y` | Ändern zulassen.

### 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.

- Beim zweiten 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

- Parameter

### 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` nach `DORA` geändert.

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-FUNCTION` | A1 | `D` | Löscht alle Benutzer-Zugriffsrechte, die für alle Netzwerke gewährt sind, die mit `P-OWNER`, `P-NETWORK` und `P-VERSION` angegeben sind.
`U` | Ändert alle Benutzer-Zugriffsrechte, die für alle Netzwerke gewährt sind, die mit `P-OWNER`, `P-NETWORK` und `P-VERSION` angegeben sind: Zugriffsrechte werden für die mit `P-TYPE` und `P-NAME` angegebenen Benutzer geändert nach `P-OPTION` geändert. Zugriffsrechte werden hinzugefügt, falls die mit `P-TYPE` und `P-NAME` angegebenen Benutzer noch nicht existieren.
`P-OWNER` | A10 | Name des Netzwerk-Eigentümers oder ein mit Platzhalterzeichen Stern (`*`) oder Fragezeichen (`?`) angegebener Namensbereich. Sie können nur einen Parameter benutzen, um einen Namensbereich anzugeben.
`P-NETWORK` | A10 | Name des Netzwerks oder ein mit Platzhalterzeichen Stern (`*`) oder Fragezeichen (`?`) angegebener Namensbereich. Sie können nur einen Parameter benutzen, um einen Namensbereich anzugeben.
`P-VERSION` | A10 | Name der Netzwerkversion oder ein mit Platzhalterzeichen Stern (`*`) oder Fragezeichen (`?`) angegebener Namensbereich. Sie können nur einen Parameter benutzen, um einen Namensbereich anzugeben.
`P-TYPE` | A1 | Nur bei `P-FUNCTION=U` erforderlich. Benutzertyp-Angabe:
`O` | Eigentümer
`U` | Benutzer
`P-NAME` | A8 | Nur bei `P-FUNCTION=U` erforderlich. Name des Eigentümers oder Benutzers, dessen Zugriffsrechte geändert werden sollen.
`P-OPTION` | A5 | Nur bei `P-FUNCTION=U` erforderlich. Optionen für Zugriffseinschränkungen (Mehrfachangabe möglich):
`R` | Lesezugriff.
`W` | Lese- und Schreibzugriff.
`D` | Lesen, schreiben und löschen.
`O` | Eigentümerrechte mit Berechtigung, anderen Benutzern Zugriff zu gewähren.
`A` | Netzwerk-Aktivierungsrechte.

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

Die Utility `US-UPD-P` dient zur Durchführung von Auflist- oder Ändern-Operationen von bzw. an Benutzerkennungen, die in Netzwerk- und Job-Definitionen definiert sind.

Zu diesen Benutzerkennungen zählen Standard-Benutzerkennungen, Netzwerk-/Jobstart-Benutzerkennungen oder SYSOUT-Benutzerkennungen sowie Gruppen- oder Domänen-Namen (nur bei UNIX und Windows).

- Natural-Programm-Aufruf

- Parameter

### Natural-Programm-Aufruf

Für Auflist-Operationen:

    US-UPD-P P-FUNCTION

Für Ändern-Operationen:

    US-UPD-P P-FUNCTION P-OLD-VALUE P-NEW-VALUE [P-NODE-A5] [P-OWNER] [P-NETWORK] [P-NETWORK-VERSION] [P-JOB-TYPE]

Wichtig
Für Ändern-Operationen kann diese Utility nur benutzt werden, wenn der Entire Operations-Monitor nicht läuft.

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`P-FUNCTION` | A3 | Verfügbare Funktionscodes zum Auflisten oder Ändern von Benutzerkennungen:
`NLE` | Netzwerke mit leerer Standard-JCL-Benutzerkennung oder leerer Jobstart-Benutzerkennung auflisten.
`NSU` | Netzwerk-Start-Standard-Benutzerkennung für Netzwerk ändern.
`NSG` | Netzwerk-Start-Standard-Gruppe ändern.
`NJU` | Netzwerk-JCL-Standard-Benutzerkennung ändern.
`NJG` | Netzwerk-JCL-Standard-Gruppe ändern.
`JLE` | Auflisten von Jobs mit leerer JCL-Standard-Benutzerkennung oder leerer Start-Benutzerkennung, bei denen auf Netzwerkebene keine Standard-Benutzerkennung vorhanden ist.
`JMU` | Job-Änderungs-Benutzerkennung ändern.
`JSU` | Jobstart-Benutzerkennung ändern.
`JSG` | Jobstart-Gruppe ändern.
`JJU` | Job-JCL-Benutzerkennung ändern.
`JJG` | Job-JCL-Gruppe ändern.
`JSB` | SYSOUT-Benutzerkennung ändern (nur bei BS2000).
`P-OLD-VALUE` | A20 | Suchwert für die zu ändernden Benutzerkennungen oder Namen. Mögliche Werte:
`(ANY)` | Alle definierten Benutzerkennungen auswählen.
`(EMPTY)` oder leer | Alle Benutzerkennungen auswählen, für die keine Namen definiert sind (leere Feldwerte).
`text-string` | Alle Benutzerkennungen auswählen, die mit der angegebenen Textzeichenfolge übereinstimmen
Bei den Werten wird zwischen Klein- und Großschreibung unterschieden. Ausnahme: Wird die Utility `P-NODE-A5` bei einem Großrechnerknoten ausgeführt, dann wird der angegebene Wert in Großbuchstaben umgesetzt.
`P-NEW-VALUE` | A20 | Ersetzungswert für die mit `P-NODE-A5` ausgewählte Benutzerkennung. Alle mit `P-NODE-A5` ausgewählten Benutzerkennungen werden durch den mit `P-NODE-A5` angegebenen Wert ersetzt. Bei den Werten wird zwischen Klein- und Großschreibung unterschieden. Ausnahme: Wird die Utility `P-NODE-A5` bei einem Großrechnerknoten ausgeführt, dann wird der angegebene Wert in Großbuchstaben umgesetzt.
`P-NODE-A5` | A5 | Ein in Entire Operations definierter Knotenname (optional). SYSOUT-Definitionen können nur von Jobs verwendet werden, bei denen dieser Job als Start-Knoten definiert ist.
Mögliche Werte:
leer oder `0` | Alle Netzwerke und Jobs auswählen, bei denen ein gültiger JCL- oder Ausführungsknotenname definiert ist.
`node-name` | Alle Netzwerke und Jobs auswählen, deren JCL- oder Ausführungsknoten mit dem angegebenen Knotennamen übereinstimmen. Der Knotename ist entweder die Knotennummer oder der Kurzname, die bzw. der für den Knoten definiert ist.
`P-OWNER` | A10 | Eigentümer, Netzwerk und/oder Netzwerkversion (alle optional), die ausgewählt werden sollen. Diese Felder können für die Definition des Platzhalterzeichen-Bereichs ("Wildcard-Notation") benutzt werden. Ein Platzhalterzeichen ist nur in dem zuletzt angegebenen Feld zulässig.
`P-NETWORK` | A10
`P-NETWORK-VERSION` | A10
`P-JOB-TYPE` | A3 | Auszuwählender Jobtyp (optional). Mögliche Werte:
leer oder `*` | Alle Jobtypen auswählen.
`job-type` | Alle Jobtypen mit dem angegebenen, aus drei Zeichen bestehenden Code auswählen, z.B. DUM für Dummy-Jobs. Informationen zu gültigen Jobtypen siehe Entire Operations-Jobtypen im Kapitel Job-Verwaltung.

## 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

- Beispiel:

- Felder in den Eingabezeilen

### 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:

Name | Format | Beschreibung
--- | --- | ---
nop-userid | A8 (Großschreibung) | Kennung des Entire Operations-Benutzers, der Zugriff auf den Knoten erhält.
node-number | N5 | Nummer des Entire Operations-Knotens, auf den der Zugriff erfolgen soll.
os-userid | A50 (Gemischte Groß-/Kleinschreibung) | Kennung des Betriebssystems, die dem Knoten zugewiesen ist.
os-group | A20 (Kleinschreibung) | Name einer Windows- oder UNIX-Gruppe (falls definiert), zu der die Betriebssystemkennung gehört.
ld-value | A1 | Automatisches Anmelden bei dem Knoten gestatten (`Y`) oder nicht gestatten (`N` oder leer).
aj-value | A1 | Automatisches Anmelden bei dem Knoten nur für das Anzeigen und Editieren von JCL gestatten (`Y`) oder nicht gestatten (`N` oder leer).
as-value | A1 | Automatisches Anmelden bei dem Knoten nur für das Anzeigen der SYSOUT-Datei gestatten (`Y`) oder nicht gestatten (`N` oder leer).

## Massenänderung von Knoten-Nummern

- Natural-Programmaufruf

- Parameter

- Anmerkungen

### Natural-Programmaufruf

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

### Parameter

Name | Format | Beschreibung
--- | --- | ---
`LOCATION` | A3 | Alle Ausprägungen des Knotens werden in Master-Definitionen des Netzwerks, Jobs oder Ereignisses geändert. Weitere Werte siehe Liste der JCL-Speicherarten.
`NODE-OLD` | N5 | Knoten-Nummer.
`NODE-NEW` | N5 | Knoten-Nummer.
`OWNER` | A10 | Eigentümer-Filter (optional).
`NETWORK` | A10 | Netzwerk-Filter (optional).
`NETWORK-VERSION` | A10 | Netzwerk-Version-Filter (optional).

### 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 OS/390 in z/OS ändern, aber nicht z/VSE in z/OS.

2. Wenn für die Parameter `OWNER`, `NETWORK` und `NETWORK-VERSION` kein Wert angegeben wird, enthalten diese standardmäßig einen Stern (*).

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

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

4. 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

Name | Format | Beschreibung
--- | --- | ---
`node` | N5 | Der Entire System Server-Knoten, bei dem die Anmeldung (Logon) durchgeführt werden soll.
`userid` | A20 | Benutzerkennung für die Anmeldung.
`group` | A20 | Gruppe für die Anmeldung. Bei Windows-Knoten muss `group` die Domäne enthalten. Wenn keine Gruppe oder Domäne eingesetzt wird, geben Sie stattdessen ein Minuszeichen (-) ein. Beispiel:
    148 USER - USER-PWD
`password` | A20 | Das Passwort für die Anmeldung. Wenn das Passwort mindestens ein Leerzeichen enthält, muss der Parameter `password` in doppelten Hochkommas (''<pass word>'') stehen. Passwörter mit nachfolgenden Leerzeichen werden nicht unterstützt.

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

Name | Format | Beschreibung
--- | --- | ---
`P-OBJECT-TYPE` | A2 | Objekttyp.
`NV` | Job-Netzwerk-Version
`SV` | Symboltabellen-Version
`P-OBJECT-OWNER` | A10 | Eigentümer des Objekts.
`P-OBJECT-NAME` | A10 | Name des Objekts.
`P-OLD-OBJECT-VERSION` | A10 | Umzubenennende Version des Objekts.
`P-NEW-OBJECT-VERSION` | A10 | Neue Version des Objekts.
`P-ALLOW-UPDATE` | A10 |
`N` | Nur überprüfen.
`Y` | Änderungen zulassen.

### 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

Name | Format | Beschreibung
--- | --- | ---
`MODE` | A1 |
`A` | Alle Jobs mit Speicherort MAC katalogisieren.
`M` | Jobs mit JCL-Speicherort MAC katalogisieren, falls noch nicht katalogisiert.
`OWNER` | A10 | Eigentümer-Filter.
`NETWORK` | A10 | Netzwerk-Filter.
`NETWORK-VERSION` | A10 | Netzwerk-Versions-Filter.

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.

### On this page

- 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