Symboltabellen-Versionen verwalten

#### Search Results

Search

# Symboltabellen-Versionen verwalten

Im Folgenden wird beschrieben, wie Sie verschiedene Versionen einer Master-Symboltabelle verwalten und benutzen.

- Versionierung von Symboltabellen

- Datumsbereiche für Symboltabellen-Versions-Verwendung verwalten

## Versionierung von Symboltabellen

- Versionsnamen

- Versionsnamen-Exit

- Reservierte Versionsnamen für Symboltabellen

- Erstellen von Symboltabellen-Versionen durch Klonen

- Kopieren von einzelnen Symbolen

- Löschen von Symboltabellen-Versionen

- Löschen von Symboltabellen-Versionen oder einzelnen Symbolen mittels API

- Symboltabellen-Versionen zur Zeitplan-Aktivierung benutzen

- Definition von Symboltabellen-Versionen

- Aktive Symboltabellen

- Symbolabfrage/Symbol-Eingabe

- Reihenfolge bei der Symbolsuche

- Symboltabellen auf System- und Eigentümer-Ebene

- Protokollierung (Logging)

- Cross-Referenzen (XREF)

- Berichte

- Import / Export

- Exit-Funktionalität (Symboltabelle)

- Maximale Anzahl Versionen pro Symboltabelle

### Versionsnamen

Für die Vergabe von Versionsnamen gilt Folgendes:

- Der Name darf bis zu 10 alphanumerische Zeichen enthalten. Buchstaben sind in Groß- oder Kleinschreibung zulässig.

- Leerzeichen und die folgenden Sonderzeichen sind in Versionsnamen nicht zulässig:

  ? <> * ,()_

- Um Probleme beim Portieren einer Entire Operations-Umgebung auf eine andere Plattform zu vermeiden, sollten Sie grundsätzlich keine Sonderzeichen und Umlaute benutzen.

- Benutzen Sie keine reservierten Versionsnamen (s.u.).

### Versionsnamen-Exit

Mit einem globalen Versionsnamen-Exit kann die Einhaltung einer kundenspezifischen Versionsnamen-Syntax erzwungen werden.

Weitere Informationen siehe Globaler Exit für Versionsnamen in der Systemverwaltung-Dokumentation.

### Reservierte Versionsnamen für Symboltabellen

- leerer Wert; in Selektionen und im Log auch: (unnamed)
  Wird für die unbenannte Version verwendet.

  Nach einer Migration von einer früheren Entire Operations-Version, die keine Netzwerk-Versionierung unterstützt, ist dies die einzige vorhandene Netzwerk-Version.

  In Parameterlisten (z. B. für Berichte) können Sie auch einen Bindestrich (-) angeben.

- (current)
  Wird durch die Version ersetzt, die in dem aktivierten Zeitplan gesetzt ist. `(current)` kann in Versionsreferenzen verwendet werden.

- (nv)
  Wird durch die Netzwerk-Version des verwendenden Netzwerks ersetzt. Falls es nur eine Netzwerk-Version ohne Namen gibt, dann wird diese Symboltabelle auf diese bezogen.

  Falls in der Netzwerk-Version keine namensgleiche Symboltabellen-Version vorhanden ist, wird die Anforderung mit Fehlermeldung abgebrochen.

- (svn)
  Die Symboltabellen-Version wird durch das aktive Netzwerks ersetzt. `(svn)` kann in referenzierten Versionen eines untergeordneten Netzwerks verwendet werden.

  Anwendung u.a. für:

  - Job-Definition

- (svj)
  Die Symboltabellen-Version wird durch den aktiven Job ersetzt. `(svj)` kann in referenzierten Versionen eines untergeordneten Jobs verwendet werden.

  Anwendung u.a. bei:

  - Angeforderte Voraussetzung abhängig von Symbolwert

  - Angeforderte Voraussetzung abhängig von mehrfachen Symbolen

  - Job-Ende-Aktion: Symbol setzen

### Erstellen von Symboltabellen-Versionen durch Klonen

Die Kopier-Funktion für Symboltabellen kann auch für das Klonen von Job-Netzwerken und damit zur Erzeugung von neuen Versionen verwendet. Dies ist ein gängiger Weg zur Erstellung neuer Symboltabellen-Versionen.

Siehe auch Master-Symboltabellen-Definition kopieren, Symboltabellen-Version klonen und einfügen.

### Kopieren von einzelnen Symbolen

Einzelne Symbole können aus einer beliebigen Version der Ursprungs-Symboltabelle kopiert werden.

### Löschen von Symboltabellen-Versionen

Für das Löschen von Symboltabellen-Versionen gilt Folgendes:

- Wenn mehrere Versionen einer Symboltabelle existieren, muss man eine der Versionen zum Löschen auswählen.

- Eine Symboltabellen-Version kann nicht gelöscht werden, wenn sie für mindestens einen aktuellen oder zukünftigen Datumsbereich als Standard-Version für Zeitplan-Aktivierungen definiert ist. Ein definierter Datumsbereich in der Vergangenheit ist für die Löschung einer Version unerheblich.

### Löschen von Symboltabellen-Versionen oder einzelnen Symbolen mittels API

Mit dem Anwendungsprogrammierungsschnittstelle `NOPUSY7N` können einzelne Symboltabellen-Versionen sowie einzelne Symbole darin gelöscht werden.

### Symboltabellen-Versionen zur Zeitplan-Aktivierung benutzen

Zur Pflege der Versionsverwendung in der Symboltabellen-Verwaltung können Sie die im Abschnitt Symboltabellen-Versionen verwalten beschriebenen Funktionen benutzen.

### Definition von Symboltabellen-Versionen

Die Definition von Symboltabellen-Versionen ist möglich in der

- Netzwerk-Versions-Definition

- Job-Definition

### Aktive Symboltabellen

Für aktive Symboltabellen gilt Folgendes:

- Die Aktivierung von Symboltabellen ist Bestandteil von Netzwerk- und Job-Aktivierungen.

- Eine Symboltabelle kann nur mit einer eindeutigen Version aktiviert werden. Die Bestimmung der zu verwendenden Symboltabellen-Version ist Bestandteil des Aktivierungsvorgangs.

- Aktive Symboltabellen haben nicht mehr die Versionsbezeichnungen `(current)` oder `(nv)`. Diese werden während der Aktivierung von Symboltabellen eindeutig aufgelöst.

- Aktive Symboltabellen können nur noch die Versionsbezeichnung `(none)` (= leer) oder einen festen Versionsnamen haben.

- Wenn eine benötigte Symboltabellen-Version fehlt, oder die Symboltabellen-Version nicht eindeutig bestimmt werden kann, ist ein Aktivierungsvorgang mit Fehlermeldung abzubrechen.

- Keinesfalls darf in einer nicht eindeutigen Situation eine Symboltabellen-Version "geraten" werden.

### Symbolabfrage/Symbol-Eingabe

Die zu verwendende Symboltabellen-Version wird eindeutig bestimmt, bevor die Symbol-Eingabe (bei manueller Aktvierung oder vor der Ausführung des Symbolabfrage-Exit im Monitor) erfolgt. Siehe auch Symbol-Eingabe bei einer Netzwerk- oder Job-Aktivierung.

### Reihenfolge bei der Symbolsuche

Die Reihenfolge, in der nach Symbolen in den in Ihrer Umgebung definierten Symboltabellen gesucht wird, ist abhängig von den hierarchischen Ebenen, auf denen auf die Symboltabellen in Ihrer Umgebung zugegriffen werden kann. Siehe Symboltabellen-Typen und Symbol-Suchreihenfolge.

### Symboltabellen auf System- und Eigentümer-Ebene

Globale Symboltabellen, d.h. Symboltabellen auf Systemebene und Eigentümer-Ebene, werden nicht versioniert. Es handelt sich dabei um folgende Symboltabellen:

    SYSDBA / A
    <owner> / A

### Protokollierung (Logging)

Das Protokoll aller Symbol-Aktionen enthält die Version der Tabelle, aus der das Symbol stammt.

Die von Entire Operations im JCL-Header generierten Kommentare enthalten für die verwendeten Symbole die Symboltabellen-Version.

### Cross-Referenzen (XREF)

Symboltabellen-Versionen werden berücksichtigt.

### Berichte

Symboltabellen-Versionen werden berücksichtigt.

### Import / Export

Symboltabellen-Versionen werden berücksichtigt.

### Exit-Funktionalität (Symboltabelle)

Entire Operations bietet User-Exits und APIs, die Bezug zu Symbolen haben und die Symboltabellen-Versionierung unterstützen, z.B. die API `NOPUSY7N`.

### Maximale Anzahl Versionen pro Symboltabelle

Die maximale Anzahl von Symboltabellen-Versionen kann in der Systemverwaltung systemweit eingeschränkt werden.

Weitere Informationen siehe Feld Max. Anzahl Versionen pro Netzwerk oder Symboltabelle auf der Registerkarte Netzwerk-Optionen im Abschnitt Standardwerte für Netzwerk-Optionen in der Systemverwaltung-Dokumentation.

## Datumsbereiche für Symboltabellen-Versions-Verwendung verwalten

Diese Funktion dient zum Verwalten (Ändern bzw. Löschen) der Datumsbereiche, in denen Symboltabellen-Versionen als aktuelle Versionen für alle geplanten Job-Aktivierungen verwendet werden.

Anmerkung
In dieser Funktion können Sie keine neuen Symboltabellen-Versionen hinzufügen. Die Definition einer Symboltabellen-Version erfolgt beim Anlegen oder Kopieren einer Master-Symboltabelle.

Dieser Abschnitt behandelt folgende Themen:

- Liste der Versions-Verwendungen anzeigen

- Neuen Datumsbereich für Versions-Verwendung definieren

- Felder und Spaltenüberschriften: Verwendung einer Symboltabellen-Version als aktuelle Version

- Datumsbereich für Versions-Verwendung ändern

- Datumsbereich für Versions-Verwendung löschen

Weitere Informationen siehe Objekt-Versionierung im Dokument Konzept und Leistungsumfang.

### Liste der Versions-Verwendungen anzeigen

Um die Liste der Versions-Verwendungen einer Symboltabelle anzuzeigen:

1. Markieren Sie im Objekt-Arbeitsbereich die Knoten Eigentümer > Eigentümername > Symboltabellen > Symboltabellenname.

2. Rufen Sie das Kontextmenü auf und wählen Sie Versions-Verwendung.

   Das Dialogfenster Versions-Verwendung wird angezeigt.

   Beispiel für vorhandene Definitionen:

   Dabei bedeutet:

   `>>>>>>>>` in der Spalte Von: ohne Start-Datum

   `>>>>>>>>` in der Spalte Bis: ohne Ende-Datum (unbegrenzt)

Um die Anzeige zu aktualisieren:

- Wählen Sie die Schaltfläche Aktualisieren.

### Neuen Datumsbereich für Versions-Verwendung definieren

Um einen neuen Datumsbereich für eine Versions-Verwendung zu definieren:

1. Wählen Sie im Dialogfenster Versions-Verwendung die Schaltfläche Neu.

   Das Dialogfenster Neu hinzufügen Versions-Verwendung wird angezeigt (Beispiel):

   Weitere Informationen siehe Felder: Verwendung einer Symboltabellen-Version als aktuelle Version.

2. Legen Sie das Anfangs- und Endedatum des Datumsbereichs für die Zeitplan-Aktivierung fest, indem Sie das Datum den Feldern Von / Bis überschreiben.

   Oder:
   Wählen Sie die Pfeiltaste am rechten Rand des Eingabefeldes.

   Ein Kalenderauszug wird angezeigt (Beispiel):

   Das Tagesdatum ("Today") erscheint umrandet.

   Mit der Pfeiltaste oben rechts bzw. links können Sie einen anderen Monat im aktuell angezeigten oder in einem anderen Jahr auswählen.

3. Markieren Sie den gewünschten Tag.

   Das entsprechende Datum wird in das Eingabefeld Auswertungsdatum übernommen. (Das gewählte Auswertungsdatum wird im Kalender umrandet und farbig hinterlegt dargestellt.)

4. Bestätigen Sie die Eingaben mit OK.

### Felder und Spaltenüberschriften: Verwendung einer Symboltabellen-Version als aktuelle Version

Feld bzw. Spalte | Bedeutung
--- | ---
Symboltabellen-Version (Spalte bzw. Eingabefeld) | Entire Operations kann mehrere Versionen einer Symboltabelle verwalten. Geben Sie die betreffende Version an, die als aktuelle Version verwendet werden soll. Weitere Informationen siehe Objekt-Versionierung im Dokument Konzept und Leistungsumfang.
Von (Spalte bzw. Eingabefeld) | Das Anfangsdatum des Datumsbereichs für die Versionsverwendung. `>>>>>>>>` bedeutet, dass kein Anfangsdatum definiert worden ist. Mögliche Eingabewerte: Ein Anfangsdatum (im aktuellen, aus 8 Zeichen bestehenden Datumsformat) oder kein Wert (leeres Feld). Standardmäßig ist kein Anfangsdatum definiert. Siehe auch Datums- und Zeitformate. Anmerkung Die Datumsbereiche dürfen sich nicht überlappen.
Bis (Spalte bzw. Eingabefeld) | Das Endedatum des Datumsbereichs für die Versionsverwendung. `>>>>>>>>` bedeutet, dass kein Endedatum definiert worden ist. Die Verwendung der Symboltabellen-Version ist unbegrenzt (unendlich). Mögliche Eingabewerte: Ein Endedatum (im aktuellen, aus 8 Zeichen bestehenden Datumsformat) oder kein Wert (leeres Feld) für unbegrenzte Versionsverwendung. Siehe auch Datums- und Zeitformate. Anmerkung Die Datumsbereiche dürfen sich nicht überlappen.
Version (Spalte) | Symboltabellen-Version, für die eine Nutzungsdauer definiert ist.
Beschreibung (Spalte) | Beschreibung zur Versionsverwendung.
Symboltabellen-Version | Eingabefeld für die Symboltabellen-Version, die während dem angegebenen Zeitraum (Von/Bis) als aktuelle Version verwendet werden soll. Standardmäßig ist das Feld vorbelegt mit `(unnamed)`.
Beschreibung der Versions-Verwendung | Eingabefeld für eine Beschreibung (maximal 70 Zeichen) zur Versionsverwendung.

### Datumsbereich für Versions-Verwendung ändern

Um die Definition eines Datumsbereichs für eine Symboltabellen-Versions-Verwendung zu ändern:

1. Markieren Sie im Dialogfenster Versions-Verwendung den zu ändernden Datumsbereich.

2. Wählen Sie die Schaltfläche Ändern.

   Das Dialogfenster Ändern Versions-Verwendung wird angezeigt (Beispiel):

   Sie können die Datumsangaben und den Beschreibungstext ändern.

   Weitere Informationen siehe Felder: Verwendung einer Symboltabellen-Version als aktuelle Version.

3. Bestätigen Sie die Änderung mit OK.

   Der geänderte Datumsbereich wird im Dialogfenster Versions-Verwendung angezeigt.

### Datumsbereich für Versions-Verwendung löschen

Um die Definition eines Datumsbereichs für eine Symboltabellen-Versions-Verwendung zu löschen:

1. Markieren Sie im Dialogfenster Versions-Verwendung den zu löschenden Datumsbereich.

2. Wählen Sie die Schaltfläche Löschen.

   Ein Dialogfenster mit der Aufforderung zur Bestätigung erscheint.

3. Wählen Sie Ja, um den Datumsbereich für Versions-Verwendung zu löschen.

   Der Datumsbereich wird im Dialogfenster Versions-Verwendung nicht mehr angezeigt.

   Oder:
   Wählen Sie Nein, um den Vorgang abzubrechen.

### On this page

- Versionierung von Symboltabellen
- Datumsbereiche für Symboltabellen-Versions-Verwendung verwalten