Master-Symbol-Definition anlegen

#### Search Results

Search

# Master-Symbol-Definition anlegen

Anmerkung
Wenn es sich bei dem neuen Master-Symbol um das erste Symbol einer neuen Master-Symboltabelle handelt, wird die zugehörige Tabelle implizit bei dieser Aktion erstellt.

Um eine neue Master-Symbol-Definition anzulegen:

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

   Rufen Sie das Kontextmenü auf und wählen Sie Neu.

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

   Rufen Sie das Kontextmenü auf und wählen Sie Öffnen.

   Die Liste der Symbole der markierten Symboltabelle wird im Dialog Verwaltung Symboltabellen angezeigt.

   Wählen Sie die Schaltfläche Neu.

   Der Dialog Neues Objekt erzeugen Symbole wird angezeigt (Beispiel):

2. Geben Sie im Feld Symbolname den Namen des als Variable zu benutzenden Symbols ein.

Weitere Vorgehensweise siehe folgende Abschnitte:

- Register Definition

- Register Mehrfache Symbolwerte

- Register Werteprüfung

- Alle Angaben bestätigen und Dialog beenden

## Register Definition

Um ein neues Symbol zu definieren:

1. Geben Sie die Werte in den Feldern im Register Definition ein.

   Feld | Bedeutung
   --- | ---
   Format | Format der Variablen. Gültige Werte:
   A | Alphanumerisch (einschließlich Sonderzeichen).
   D | Datum.
   H | Alphanumerisch, verborgen Der Symbolwert wird nicht im Feld Wert angezeigt. In Listen und Protokollen ("Logs") wird der Symbolwert als `*** verborgen ***` angezeigt.
   L | Alphanumerisch, Umwandlung in Kleinbuchstaben.
   N | Numerisch. Das numerische Feld-Format entnehmen Sie dem Feld Wert.
   U | Alphanumerisch, Umwandlung in Großbuchstaben.
   Wert | Der Wert des zu ersetzenden Symbols. Um eine feste Länge oder eine leere Zeichenkette einzugeben, müssen Sie den Wert in Hochkommas setzen. Wenn Sie innerhalb der Zeichenkette ein Hochkomma setzen wollen, geben Sie dort zwei Hochkommas ein, zum Beispiel:
       'Fixed Length       '
   Anmerkungen: Wenn der Wert länger als 40 Zeichen ist, können Sie in der zweiten Zeile weiterschreiben. Die Länge darf maximal 120 Zeichen betragen. Vorsicht bei Einfügungen und Löschungen: die zwei Zeilen werden zu einem Symbolwert zusammengefügt. Ein numerischer Wert kann maximal das Format N10.4 haben, d.h. 10 Stellen vor dem Dezimaltrennzeichen (Dezimalkomma bzw. Dezimalpunkt) und 4 Stellen danach. Das Dezimaltrennzeichen darf an beliebiger Stelle stehen. Ein Datum muss im Format YYYYMMDD angegeben werden. Der Wert eines verborgenen Symbols (Format H) kann eingetragen werden, wird aber nicht angezeigt.
   Abfragen | Gibt an, ob der Benutzer während der manuellen Aktivierung des Job-Netzwerkes nach diesem Symbol gefragt werden soll. Gültige Werte:
   A | Symbol bei jeder Aktivierung abfragen.
   E | Symbol nur abfragen, wenn es leer ist, d.h. kein Wert in der Tabelle angegeben ist. Dies ist die Standardeinstellung.
   N | Symbol nie abfragen.
   Abfragetext
   Optionaler, beschreibender Kurztext, der beim Abfragen von Symbolen abgerufen werden kann, um den Benutzer beim Angeben des richtigen Wertes zu unterstützen.

2. Wählen Sie die Schaltfläche Anwenden, um die Eingabe auf der Registerkarte Definition zu bestätigen.

#### Beispiel einer Master-Symbol-Definition

Der folgende Bildschirm zeigt ein Beispiel für die Benutzung des Symbols `FILE-1` in der Master-Symboltabelle `A-1` des Eigentümers `EXAMPLE`:

Jedes Mal, wenn das Symbol `FILE-1` in der JCL des Jobs auftritt, für den die Symboltabelle `A-1` mit der Version `v1` angegeben ist, wird der Wert `NOP.DEMO.SRCE` ersetzt.

Die JCL-Zeile

    //XYZ  DD DSN=@FILE-1,DISP=SHR

wie in der ursprünglichen JCL definiert, wird bei der Job-Aktivierung zu:

    //XYZ  DD DSN=NOP.DEMO.SRCE,DISP=SHR

Anmerkung
Symbole, denen das Job-Start-Fluchtsymbol in der JCL vorangeht, werden durch ihre aktuellen Werte erst beim Job-Start ersetzt.

Der Benutzer kann die sich ergebende JCL für einen einzelnen Lauf mit der Verwaltungsfunktion Aktive Jobs ändern.

Siehe Aktive JCL editieren im Abschnitt Aktive Job-Netzwerke.

Wird ein Job-Netzwerk, das diese Symboltabelle verwendet, manuell aktiviert, dann wird der Benutzer nach diesem Symbol gefragt. Der Text im Feld Abfragetext wird bei der Symbolabfrage angezeigt, damit der Benutzer den richtigen Wert besser bestimmen kann. Der Benutzer kann den angegebenen Wert unverändert lassen oder für den Netzwerklauf ändern.

## Register Mehrfache Symbolwerte

Auf der Registerkarte Mehrfache Symbolwerte können Sie einem Symbol mehrere Werte zuordnen. Diese Werte können sowohl beim späteren Ersetzen desselben Symbols als auch zur mehrfachen Parallelaktivierung eines Jobs benutzt werden. Die Anzahl der parallelen Jobs ist mit der Anzahl der hier definierten Werte identisch. Die maximale Anzahl mehrfacher Symbolwerte ist 150.

Anmerkungen:

1. Sie können die Symbolfunktion `MV` verwenden, um einzelne Ausprägungen mehrfacher Symbole für die Ersetzung zu erhalten. Weitere Informationen siehe Symbol-Funktionen !MV, ?MV, !MM, ?MM - Zugriff auf einzelne Ausprägungen eines mehrfachen Symbols.
2. Weitere Informationen zur Zuordnung der mehrfachen Symbolwerte siehe Symbolersetzung durch mehrfache Symbolwerte.

Um mehrfache Werte für ein Symbol zu definieren:

1. Wählen Sie das Register Mehrfache Symbolwerte.

   Sie können hier bis zu 150 Werte eingeben. Die maximale (interne) Wertelänge ist 120. Diese Werte werden beim späteren Ersetzen des Symbols benutzt.

   Anmerkung
   Wenn eine Adabas-Version kleiner als 8 benutzt wird, ist die absolute Größe dieser mehrfachen Symbole durch die Block-Größe von ADABAS DATA beschränkt.

2. Geben Sie in das Eingabefeld im oberen Bereich der der Tabelle den ersten Wert ein und wählen Sie die Schaltfläche Einfügen.

   Der eingegebene Wert wird in die erste Zeile übernommen.

3. Wiederholen Sie den vorigen Schritt für die weiteren Werte.

4. Wählen Sie die Schaltfläche Anwenden, um die Eingabe auf der Registerkarte zu bestätigen.

Um eine Wert zwischen zwei anderen Werten einzufügen:

1. Markieren Sie den Wert, vor dem der neue Wert eingefügt werden soll, und wählen Sie Einfügen.

   Die betreffende Zeile ist nun eingabefähig (Beispiel):

2. Geben den neuen Wert ein und wählen Sie Anwenden, um die Eingabe zu speichern.

Um einen Symbolwert zu löschen:

- Markieren Sie die betreffende Tabellenzeile und wählen Sie die Schaltfläche Löschen.

## Register Werteprüfung

Auf der Registerkarte Werteprüfung können Sie die numerische Werteprüfung für ein Symbol von Format N durchführen bzw. einen User-Exit zur Plausibilitätsprüfung von Symbolen definieren.

Um Angaben zur Prüfung der Symbolwerte zu machen:

1. Wählen Sie die Registerkarte Werteprüfung.

   Sie haben folgende Optionen:

   Feld | Bedeutung
   --- | ---
   Kein | Es erfolgt keine Werteprüfung.
   Bereichsprüfung | Bereich der Werte ein, die geprüft werden sollen. Anmerkung Die Wertebereichsprüfung steht nur bei Werten des Formats N zur Verfügung.
   Wert von | Bereich der Werte, die einer Prüfung unterzogen werden sollen.
   Wert bis
   User-Exit | Plausibilitätsprüfung eingegebener Symbolwerte während der Symbol-Änderung oder Symbol-Eingabe.
   Bibliothek | Name der Bibliothek, in der sich der User Exit befindet.
   User-Exit | Name des User-Exit.
   Sie den angegebenen User-Exit ändern oder erstellen. Dazu wählen Sie die Schaltfläche Edit. Das Fenster Editieren erscheint. Wichtig Wichtig ist, dass Sie den geänderten oder neu erstellten User-Exit mit dem Kontextmenü-Kommando Stow (entspricht dem Natural-Systemkommando `STOW`) katalogisieren, damit er benutzt werden kann

2. Wählen Sie die Schaltfläche Anwenden, um die Eingabe auf der Registerkarte zu bestätigen.

#### Allgemeine Informationen zum User Exit für Plausibilitätsprüfung von Symbolen

Eine Plausibilitätsprüfung der eingegebenen Symbolwerte kann beim Ändern oder Abfragen von Symbolen durchgeführt werden. Der User Exit muss in Form eines Natural-Objekts vom Typ Subprogram geschrieben sein. Außerdem müssen Sie die mitgelieferte Parameterliste `NOPXPL-A` benutzen. Diese Parameterliste enthält den Eigentümernamen, die Symboltabelle, den Symbolnamen usw. und kann daher für verschiedene Symbole benutzt werden.

Die Parameter `P-RC` (Rückgabe-Code) und `P-RT` (Rückgabe-Text) werden vom aufrufenden Benutzer nach Ausführung des User Exit geprüft. Wenn `P-RC` gleich Null ist, wird dieses Symbol als "ok" angenommen. Andernfalls wird es nicht angenommen. Falls der Text in `P-RT` nicht leer ist, wird er dem Benutzer zusammen mit dem Nachrichtencode `EOR1855` angezeigt. Wenn `P-RT` ungleich `0` ist und `P-RT` leer ist, wird eine Standard-Fehlermeldung angezeigt.

Wie in anderen User-Exits können Adabas, Entire System Server und Natural-Systemvariablen zur Flexibilisierung der Symbolprüfung beitragen.

## Alle Angaben bestätigen und Dialog beenden

Um alle Angaben auf den Registerkarten zu bestätigen und den Dialog zu beenden:

- Wählen Sie die Schaltfläche OK.

  Das neue Symbol wird angelegt und erscheint im Objekt-Arbeitsbereich unter dem Knoten Symbole, nachdem das Kontext-Menü-Kommando Aktualisieren benutzt haben.

### On this page

- Register Definition
- Register Mehrfache Symbolwerte
- Register Werteprüfung
- Alle Angaben bestätigen und Dialog beenden