Master-Symbol-Definition anlegen

Anmerkung
Wenn es sich bei dem neuen Master-Symbol um das erste Symbol einer neu anzulegenden Master-Symboltabelle handelt, wird die zugehörige Tabelle implizit im Dialog Neues Objekt erzeugen Symboltabellen erstellt. Siehe Master-Symboltabelle anlegen

Beginn der AnweisungslisteUm eine neue Master-Symbol-Definition anzulegen:

  1. Wählen Sie im Objekt-Arbeitsbereich Eigentümer > Eigentümername > Symboltabellen > Symboltabellenname > Symbole.

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

    Oder:
    Wählen 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):

    Neues Symbol anlegen

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

Weitere Vorgehensweise siehe folgende Abschnitte:


Register Definition

Beginn der AnweisungslisteUm ein neues Symbol zu definieren:

  1. Wählen Sie das Register Definition.

  2. Geben Sie die Werte in den Feldern 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:

    1. 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.
    2. 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.
    3. Ein Datum muss im Format YYYYMMDD angegeben werden.
    4. 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.

Beispiel einer Master-Symbol-Definition

Der folgende Bildschirm zeigt ein Beispiel für die Benutzung des Symbols FILE-1 in der Master-Symboltabelle DEMO-001 <v2> des Eigentümers EXAMPLE:

Verwaltung Symbole (Symbol-Definition ändern)

Jedes Mal, wenn das Symbol FILE-1 in der JCL des Jobs auftritt, für den die Symboltabelle DEMO-001 <v2> mit der Version v2 angegeben ist, wird der Wert EOR.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=EOR.DEMO.SRCE,DISP=SHR

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

Der Benutzer kann die sich ergebende JCL für einen einzelnen Lauf mit der Funktion Verwaltung 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.

Beginn der AnweisungslisteUm mehrfache Werte für ein Symbol zu definieren:

  1. Wählen Sie das Register Mehrfache Symbolwerte.

    Neues Symbol anlegen - Multiple Symbolwerte

    Wählen Sie die Schaltfläche +, um eine Zeile zur Werteingabe hinzuzufügen.

    Sie können auf diese Weise 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.

Beginn der AnweisungslisteUm einen Symbolwert zu löschen:

  • Wählen Sie die betreffende Tabellenzeile und wählen Sie die Schaltfläche graphics/now_delete_symbol.png [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.

Beginn der AnweisungslisteUm Angaben zur Prüfung der Symbolwerte zu machen:

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

    Neues Symbol anlegen - Werteprüfung

    Sie haben folgende Optionen:

    Feld Bedeutung
    Keine 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 Schaltfläche Stow (entspricht dem Natural-Systemkommando STOW) katalogisieren, damit er benutzt werden kann

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

Siehe auch User Exit für Plausibilitätsprüfung von Symbolen angeben.