Symboltabellen-Versionen verwalten


Versionierung von Symboltabellen

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:

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

Liste der Versions-Verwendungen anzeigen

Beginn der AnweisungslisteUm 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 erscheint.

    Beispiel für vorhandene Definitionen:

    Versions-Verwendung, Liste

    Dabei bedeutet:

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

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

Beginn der AnweisungslisteUm die Anzeige zu aktualisieren:

  • Wählen Sie die Schaltfläche Aktualisieren.

Neuen Datumsbereich für Versions-Verwendung definieren

Beginn der AnweisungslisteUm einen neuen Datumsbereich für eine Versions-Verwendung zu definieren:

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

    Ein Fenster erscheint (Beispiel):

    graphics/version_usage_new_symbol_table.png

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

    Kalender für Auswertungsdatum

    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 gültigen 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 gültigen 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 is 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

Beginn der AnweisungslisteUm 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.

    Ein Fenster erscheint (Beispiel):

    graphics/version_usage_modify_symbol_table.png

    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

Beginn der AnweisungslisteUm 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.