Mit dieser Funktion können Sie für einen Eigentümer eine neue Master-Symboltabelle erstellen. Darüber hinaus können Sie beliebig viele Master-Symbol-Definitionen zu der neuen Master-Symboltabelle hinzufügen.
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.
Dieser Abschnitt behandelt folgende Themen:
Um ein Master-Symbol-Definition bzw. eine Master-Symboltabelle
anzulegen:
Drücken Sie PF2 (Add) im Fenster Master-Symboltabellen.
Oder:
Geben Sie in der Kommandozeile eines beliebigen Bildschirms
folgendes Direktkommando ein:
ADD TABLE
Drücken Sie Enter.
Das Fenster Master Symbol-Definition erscheint (Beispiel):
+---------------------------------------------------------------+ ! ! ! Master Symbol-Definition ! ! ! ! Symboltabelle ===> E20-ST____ Eigentuemer EXAMPLE ! ! Version ===> __________ ! ! Symbol-Name ===> ____________________ Netzwerk ! ! Format ===> _ Lauf ! ! Wert ===> ________________________________________ ! ! ________________________________________ ! ! Vorsicht bei Einfuegungen und Loeschungen. ! ! Die 2 Zeilen werden zu einem Symbolwert zusammengefuegt. ! ! Abfragen ===> _ Aenderungsmodus ===> _ ! ! Abfragetext ===> ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! Enter-PF1---PF2---PF3-----PF5----PF8----PF9---PF10---PF11-- ! ! Help Add End Save RgChk Mult Copy Exit ! +---------------------------------------------------------------+ |
In diesem Fenster können Sie im Feld Symbol-Name den Namen einer neuen Master-Symbols eingeben und ein erstes Symbol für sie definieren.
Oder:
Sie können im Feld Symboltabelle den Namen
einer vorhandenen Master-Symboltabelle eingeben und ein neues Symbol für sie
definieren.
Weitere Informationen siehe Felder: Master-Symbol-Definition.
Wenn Sie in der neu angelegten Tabelle weitere Symbole hinzufügen wollen, drücken Sie PF2 (Add) im Fenster Master-Symbol Definition.
Dadurch wird die erste Definition gesichert und die Felder des Fensters geleert.
Jetzt können Sie mit PF2 (Add) ein weiteres Master-Symbol anlegen. Auf diese Weise können Sie eine beliebige Zahl von Symbolen in der aktuellen Master-Symboltabelle hinzufügen.
Drücken Sie PF5 (Save), um die neu angelegte bzw. erweiterte Master-Symboltabelle zu sichern.
Drücken Sie PF3 (End), um die Funktion zu beenden und zum Fenster Master Symboltabelle zurückzukehren.
Wenn Sie eine neue Symboltabelle angelegt haben, erscheint diese jetzt in der Liste.
| Feld | Bedeutung | |
|---|---|---|
| Symboltabelle | Name der neuen Symboltabelle. Sie
enthält die Variablen für die dynamische JCL-Generierung und kann manuell
verwaltet oder mit Programmen geändert werden.
Geben Sie einen Stern (*) ein, um eine Symboltabelle auszuwählen. |
|
| Version | Version der Symboltabelle.
Weitere Informationen siehe Objekt-Versionierung im Dokument Konzept und Leistungsumfang. |
|
| Symbol-Name | Name des als Variable zu benutzenden Symbols. | |
| Eigentümer | Eigentümer der Symboltabelle. | |
| Netzwerk | Aktuelles Job-Netzwerk (nur bei aktiver Symboltabelle). | |
| Format | Format der Variablen. Gültige Werte: | |
| A | Alphanumerisch (einschließlich Sonderzeichen). | |
| D | Datum. | |
| H |
Alphanumerisch, verborgen.
|
|
| L | Alphanumerisch, Umwandlung in Kleinbuchstaben. | |
| N | Numerisch. Das numerische Feld-Format entnehmen Sie dem Feld Wert. | |
| U | Alphanumerisch, Umwandlung in Großbuchstaben. | |
| Lauf | Aktueller Job-Lauf (nur bei aktiver Symboltabelle). | |
| 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:
|
|
| Abfragen | Gibt an, ob der Benutzer während der manuellen Aktivierung des Job-Netzwerkes nach diesem Symbol gefragt werden soll. Siehe Symboleingabe. Gültige Werte: | |
| A | Nach Symbol bei jeder Aktivierung fragen. | |
| E | Nur dann abfragen, wenn kein Wert in der Tabelle angegeben ist. | |
| N | Niemals nach Symbol fragen. | |
| Änderungsmodus | ||
| M | Geändertes aktives Symbol auch in die Master-Symboltabelle
zurückschreiben.
Anmerkung: |
|
| sonst | Keine spezielle Aktion. | |
| Abfragetext | Optionaler, beschreibender Kurztext, der beim Abfragen von Symbolen abgerufen werden kann, um den Benutzer beim Angeben des richtigen Wertes zu unterstützen. | |
Die PF-Tasten im unteren Bereich des Master Symbol-Definition sind mit folgenden objektspezifischen Funktionen belegt:
| Taste | Name | Funktion | Weitere Informationen siehe: |
|---|---|---|---|
| PF2 | Add | Ein weiteres Master-Symbol anlegen. Sie können dieses Funktion benutzen, um zu der aktuellen Master-Symboltabelle eine beliebige Zahl weiterer Symbol-Definitionen hinzuzufügen. | Neues Symbol in einer Master-Symboltabelle Symboltabelle anlegen |
| PF8 | RgChk | Numerische Werteprüfung.
Die Wertebereichsprüfung wird nur für Werte des Formats N durchgeführt. In diesem Falle erscheint hier ein spezielles Fenster. Anmerkung: |
Numerische Werteprüfung bei Symbol-Format N durchführen |
| PF9 | Mult | Mehrfache Werte für ein Symbol zuordnen. Diese können beim nachträglichen Ersetzen desselben Symbols benutzt werden. Es erscheint hierzu ein eigenes Fenster. | Mehrfache Symbolwerte zuordnen |
| PF10 | Copy | Eine komplette Symboltabelle - evtl. aus der
alternativen Entire Operations-Datei - kopieren.
Anmerkung: |
Symboltabellen-Master-Definition kopieren, Symboltabellen-Version klonen |
| PF11 | Exit | Einen User Exit zwecks Plausibilitätsprüfung
dieses Symbols definieren und editieren (nur bei Master-Symboltabellen).
Anmerkung: |
User Exit für Plausibilitätsprüfung von Symbolen definieren |
Informationen zu PF-Tasten, die mit Standard-Funktionen belegt sind, siehe Benutzung von PF-Tasten im Abschnitt Entire Operations-Bildschirme.
Der folgende Bildschirm zeigt ein Beispiel für die Benutzung des Symbols
FILE-1 in der Master-Symboltabelle A-1 des
Eigentümers EXAMPLE:
+---------------------------------------------------------------+ ! ! ! Master-Symbol aendern ! ! ! ! Symboltabelle ===> A-1_______ Eigentuemer EXAMPLE ! ! Version ===> v1________ ! ! Symbol-Name ===> FILE-1______________ Netzwerk ! ! Format ===> _ Lauf ! ! Wert ===> NOP.DEMO.SRCE___________________________ ! ! ________________________________________ ! ! Vorsicht bei Einfuegungen und Loeschungen. ! ! Die 2 Zeilen werden zu einem Symbolwert zusammengefuegt. ! ! Abfragen ===> E Aenderungsmodus ===> _ ! ! Abfragetext ===> ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! Enter-PF1---PF2---PF3-----PF5----PF8----PF9---PF10---PF11-- ! ! Help Add End Save RgChk Mult Copy Exit ! +---------------------------------------------------------------+ |
Jedesmal, 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.
Wenn das diese Symboltabelle benutzende Job-Netzwerk manuell aktiviert wird, 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.
Dieser Abschnitt behandelt folgende Themen:
Sie können 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.
Anmerkung:
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.
Um mehrfache Symbolwerte zu definieren:
Drücken Sie PF9 (Mult) im Fenster Master Symbol-Definition.
Das Fenster Mehrfache Symbolwerte erscheint (Beispiel):
Mehrfache Symbolwerte
Eigentuemer SN Netzwerk Symboltabelle TEST77A Lauf
Version Version v12.44
Symbol MULT-01
------------------------------ Werte 1 bis 13 -----------------------------
aaaaaaaaaaa___________________________________________________________________
bbbbbb________________________________________________________________________
cccc__________________________________________________________________________
dddddddd______________________________________________________________________
eeeeeeeeeee___________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
______________________________________________________________________________
Enter---PF1----PF2----PF3--------PF5--------PF7----PF8----PF9-----------------
Help Insert End Save Up Down Delete |
Weitere Informationen siehe:
Drücken Sie PF5 (Save), um die Eingaben zu speichern.
Drücken Sie PF3 (End), um die Funktion zu beenden.
| Feld | Bedeutung |
|---|---|
| Werte ... bis ... | Sie können hier bis zu 100 Werte eingeben. Die maximale
(interne) Wertelänge ist 80.
Diese Werte werden beim späteren Ersetzen des Symbols benutzt. Sie können die Tasten PF7 (Up) und PF8 (Down) benutzen,um nach oben bzw. unten zu blättern. Anmerkung: |
Informationen zur Zuordnung der mehrfachen Symbolwerte siehe Symbolersetzung durch mehrfache Symbolwerte.
Die PF-Tasten im unteren Bereich des Mehrfache Symbolwerte sind mit folgenden objektspezifischen Funktionen belegt:
| Taste | Name | Funktion | Weitere Informationen siehe: |
|---|---|---|---|
| PF2 | Insert | Fügt eine Leerzeile an der aktuellen Cursor-Position ein. | - |
| PF9 | Delete | Löscht einen einzelnen Wert an der aktuellen Cursor-Position (ohne Rückfrage). Die verbleibenden Werte werden zusammengeschoben. | - |
Informationen zu PF-Tasten, die mit Standard-Funktionen belegt sind, siehe Benutzung von PF-Tasten im Abschnitt Entire Operations-Bildschirme.
Um die numerische Werteprüfung für ein Symbol von Format N
durchzuführen:
Drücken Sie PF8 (RgChk) auf dem Bildschirm Master-Symbol-Definition oder Master-Symbol ändern.
Der folgende Bildschirm erscheint (Beispiel):
+-----------------------------------------------+ ! ! ! Symbol: Numerische Wertepruefung ! ! ! ! Eigentuemer ===> SN ! ! Symboltabelle ===> A-1 ! ! Version ===> v12.44 ! ! Symbol ===> NUM-1 ! ! ! ! Wert von ===> 1_________ ! ! Wert bis ===> 999_______ ! ! ! ! ---PF1--PF3---------PF5---------PF9---- ! ! Help End Save Delete ! +-----------------------------------------------+ |
Drücken Sie PF5 (Save), um die Eingaben zu speichern.
Im folgenden Beispiel wurde ein Wert außerhalb des angegebenen Wertebereiches eingegeben. In diesem Fall erscheint eine Fehlermeldung, und Entire Operations nimmt den falschen Wert nicht an. Dies gilt auch für Symbol-APIs.
+---------------------------------------------------------------+ ! EOR0160 - Bereich ist 1 bis 999 ! ! Master Symbol-Definition ! ! ! ! Symboltabelle ===> A-1_______ Eigentuemer SN ! ! Version ===> v12.44____ ! ! Symbol-Name ===> NUM-1_______________ Netzwerk ! ! Format ===> N Lauf ! ! Wert ===> 1888.567890_____________________________ ! ! ________________________________________ ! ! Vorsicht bei Einfuegungen und Loeschungen. ! ! Die 2 Zeilen werden zu einem Symbolwert zusammengefuegt. ! ! Abfragen ===> N Aenderungsmodus ===> _ ! ! Abfragetext ===> ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! ________________________________________ ! ! Enter-PF1---PF2---PF3-----PF5----PF8----PF9---PF10---PF11-- ! ! Help Add End Save RgChk Mult Copy Exit ! +---------------------------------------------------------------+ |
Drücken Sie PF3 (End), um die Funktion zu beenden.
Dieser Abschnitt behandelt folgende Themen:
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.
Um einen User Exit für die Plausibilitätsprüfung von Symbolen zu
definieren:
Drücken Sie PF11 (Exit) im Fenster Master-Symbol-Definition.
Das Fenster Symbolprüfungs-Exit definieren erscheint (Beispiel):
+-------------------------------------------------------------------+ ! ! ! Symbolpruefungs-Exit definieren ! ! ! ! Eigentuemer ===> SN ! ! Symboltabelle ===> A-1 ! ! Version ===> v12.44 ! ! Symbol ===> FILE-1 ! ! ! ! Bibliothek ===> ________ ! ! Exit ===> ________ ! ! ! ! ---PF1-----PF3---PF4---PF5---------PF9--------------------- ! ! Help End Edit Save Delete ! +-------------------------------------------------------------------+ |
Weitere Informationen siehe:
Drücken Sie PF5 (Save), um die Eingaben zu speichern.
Drücken Sie PF3 (End), um die Funktion zu beenden.
| Feld | Bedeutung |
|---|---|
| Bibliothek | Name der Bibliothek, in der sich der User Exit befindet. |
| Exit | Name des User Exit. |
Die PF-Tasten im unteren Bereich des Bildschirms Symbolprüfungs-Exit definieren sind mit folgenden objektspezifischen Funktionen belegt:
| Taste | Name | Funktion | Weitere Informationen siehe: |
|---|---|---|---|
| PF4 | Edit | Einen User Exit editieren oder erzeugen.
Wichtig: |
- |
| PF9 | Delete | Die Definition des User Exit - aber nicht den User Exit selbst - löschen. | - |
Informationen zu PF-Tasten, die mit Standard-Funktionen belegt sind, siehe Benutzung von PF-Tasten im Abschnitt Entire Operations-Bildschirme.