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.

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 im Bildschirm Standardeinstellungen (3) im Abschnitt Standardeinstellungen (3) 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. Geben Sie im Fenster Master-Symboltabellen das Zeilenkommando U im Feld vor der betreffenden Symboltabelle ein.

    Drücken Sie Enter.

    Der Bildschirm Verwendung der Symboltabellen-Versionen wird angezeigt.

    Beispiel für vorhandene Definitionen:

     08.08.19                ***** Entire Operations *****                12:53:35 
                        Verwendung der Symboltabellen-Versionen                    
     Eigentuemer EXAMPLE    Symboltabelle E20-ST                                   
     ------------------------------------------------------------------------------
     Kdo von       bis       Version     Beschreibung                              
         --------  --------  *---------                                            
      _  >>>>>>>>  09.08.19  (unnamed)   Preliminary version                       
      _  10.08.19  >>>>>>>>  (unnamed)   Final version                             
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
     ******************************* Ende der Daten *******************************
     D Delete  M Modify                                                            
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   End                     Up    Down        Left  Right        

    Dabei bedeutet:

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

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

  2. Mit PF11 (Right) können Sie nach Rechts blättern, um längere Beschreibungstexte vollständig anzuzeigen.

    Mit und PF10 (Left) können Sie zur normalen Anzeige zurückblättern.

Neuen Datumsbereich für Versions-Verwendung definieren

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

  1. Drücken Sie PF2 (Add) im Bildschirm Verwendung der Symboltabellen-Versionen.

    Der Bildschirm Verwendung einer Symboltabellen-Version wird angezeigt (Beispiel):

     08.08.19                ***** Entire Operations *****                12:58:06 
                        Verwendung einer Symboltabellen-Version                    
     Eigentuemer EXAMPLE    Symboltabelle E40-ST                                   
     ------------------------------------------------------------------------------
                                                                                   
     Symboltabellen-Version ==> (unnamed)_                                         
                                                                                   
     ist als aktuelle Version (current) zu verwenden                               
                                                                                   
                        von ==> ________     (leer: unbegrenzt)                    
                        bis ==> ________     (leer: unbegrenzt)                    
                                                                                   
                                                                                   
     Beschreibung der Versions-Verwendung                                          
     ______________________________________________________________________        
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End         Save                                             

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

  2. Drücken Sie PF5 (Save), um die Eingaben zu speichern.

    Der neu definierte Datumsbereich wird im Bildschirm Verwendung der Symboltabellen-Versionen angezeigt.

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.

Sie können einen Stern (*) als Platzhalterzeichen verwenden, um eine existierende Symboltabellen-Version aus einem Auswahlfenster auszuwählen.

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. Geben Sie im Bildschirm Master-Symboltabellen das Zeilenkommando U im Feld vor der betreffenden Symboltabelle ein.

    Drücken Sie Enter.

    Der Bildschirm Verwendung der Symboltabellen-Versionen wird angezeigt.

  2. Geben Sie das Zeilenkommando M im Feld vor dem betreffenden Eintrag ein.

    Drücken Sie Enter.

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

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

  3. Drücken Sie PF5 (Save), um die Änderungen zu speichern.

    Der geänderte Datumsbereich wird im Bildschirm Verwendung der Symboltabellen-Versionen 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. Geben Sie im Bildschirm Master-Symboltabellen das Zeilenkommando U im Feld vor dem betreffenden Netzwerk ein.

    Drücken Sie Enter.

    Der Bildschirm Verwendung der Symboltabellen-Versionen wird angezeigt.

  2. Geben Sie das Zeilenkommando D im Feld vor dem zu löschenden Datumsbereich ein.

    Drücken Sie Enter.

    Es erscheint ein Fenster mit der Aufforderung, das Löschen der Versions-Verwendung zu bestätigen.

  3. Geben Sie VERSION USAGE ein und drücken Sie Enter.

    Der Datumsbereich wird im Bildschirm Verwendung der Netzwerk-Versionen für Zeitplan-Aktivierungen nicht mehr angezeigt.