Die wichtigsten Parameter, die zur Konfiguration der Natural-IMS-TM-Schnittstelle erforderlich sind, werden in den folgenden Profilparametermakros des Natural-Parametermoduls angegeben:
NTIMSP für allgemeine
Parametereinstellungen,
NTIMSPE für die Angabe von
umgebungsspezifischen Parametersätzen,
NTIMSPT für
Transaktionscode-Definitionen.
Wichtig
Sie müssen mindestens das Makro NTIMSPT angeben und individuelle
Parameter für Ihre Natural IMS TM-Transaktionen definieren (es gibt keine
Standardwerte).
Zusätzlich zu den Natural-Parameter-Makros können Sie die im folgenden Abschnitt beschriebenen optionalen Makros verwenden. Diese werden von der Natural IMS TM-Schnittstelle zur Verfügung gestellt.
Das Makro NIMMSGT generiert jeden Eintrag im Nachrichtentextmodul
NIIMSGT, das Teil des Natural IMS TM-Schnittstellen-Moduls ist. Jeder
generierte Eintrag liefert einen Meldungstext für jede mögliche Natural IMS
TM-Fehlernummer.
Das Makro NIMMSGT wird auf eine der beiden folgenden Arten angegeben:
Nerror-number [*] NIMMSGT message-text
In diesem Fall zeigt Natural unter IMS TM den Meldungstext so, wie er definiert wurde, an. Der Meldungstext kann bis zu 72 Zeichen lang sein.
Xerror-number [*] NIMMSGT message-text
In diesem Fall hängt Natural unter IMS TM einen fehlerspezifischen Reason Code an den aktuellen Meldungstext an. Der Meldungstext kann bis zu 64 Zeichen lang sein.
Wenn der Fehlernummer ein Stern (*) folgt, wird beim Auftreten eines Fehlers ein
Snap-Dump erstellt. Sie können den Meldungstext an Ihre eigenen Erfordernisse anpassen.
Sie können auch die Dump-Option bei einer bestimmten Fehlernummer hinzufügen oder löschen.
Die Fehlernummer und die der Fehlernummer vorangestellten Zeichen N oder
R dürfen Sie nicht verändern.
Das Makro NIMPIXT generiert die Editierroutine für physische Eingaben (Physical Input Edit Routine).
Die Parameter, die mit dem Makro NIMPIXT angegeben werden können, sind im
Folgenden in alphabetischer Reihenfolge aufgeführt:
PIXTE | SIPSE | SPATID | WTO | USER
| Parameter | Möglicher Wert | Beschreibung | Standardwert | Kommentar |
|---|---|---|---|---|
PIXTE
|
1 - 999 |
Legt den Startwert für Fehlernummern fest, wenn von der Editierroutine für physische Eingaben Fehler erkannt werden. | 400 |
Dieser Wert wird zum Rückgabecode addiert, der von der Editierroutine für
physische Eingaben gesetzt wird. Das Ergebnis ist die Nummer der
IMS-TM-Fehlermeldung in der User Message-Tabelle DFSCMTU0.
|
SIPSE
|
1 - 999 |
Gibt den Startwert für Fehlernummern an, wenn Fehler durch den Authorized Services Manager erkannt werden. | 500 |
Dieser Wert wird zu dem vom Authorized Services Manager gesetzten
Rückgabecode addiert. Das Ergebnis ist die Nummer der IMS TM-Fehlermeldung in der
User Message-Tabelle DFSCMTU0.
|
SPATID |
xxxx
|
Gibt die Natural-Subsystemkennung für den Authorized Services Manager an, die zum Speichern der SPA für den nicht-konversationellen Treiber verwendet wird. Es ist eine beliebige Zeichenkette mit bis zu 4 Zeichen möglich. | Keiner | Der Wert dieses Parameters muss mit dem für den Schlüsselwort-Subparameter
SPATID im Makro NTIMSPE
(Natural-Parametermodul) angegebenen Wert übereinstimmen.
|
WTO
|
YES |
Gibt an, ob eine WTO-Meldung ausgegeben wird, wenn der Authorized Services Manager fehlschlägt. | NO |
Keiner. |
NO |
||||
USER
|
xxxxxxxx
|
Gibt an, ob eine benutzerspezifische physische
Eingabe-Editierroutine aufgerufen werden soll, wenn das NIMPIXT-Makro
die SPA nicht findet.
Wenn eine benutzerspezifische Eingabe-Editierroutine aufgerufen werden soll, muss der Name der Routine angegeben werden. |
NO |
Keiner. |
NO |
Das Makro NIMBOOT generiert das von der nachrichtenorientierten Umgebung
verwendete Bootstrap-Modul bzw. die von der Server-Umgebung verwendete
Server-Call-Schnittstelle.
Das Makro NIMBOOT enthält die folgenden Parameter:
TYPE | DRIVERN | ENVTNAM | TRNCODE | DYNPARM | SERVERN
| Parameter | Möglicher Wert | Standardwert | Kommentar |
|---|---|---|---|
TYPE
|
SERVER |
Leer |
TYPE gibt den Typ des zu generierenden Schnittstellenmoduls
an.
Bei Angabe von |
| Leer | Wenn nichts angegeben wird, wird das von der nachrichtenorientierten Umgebung verwendete Bootstrap-Modul generiert. | ||
DRIVERN
|
Beliebiger, gültiger z/OS-Modulname. | Keiner | Dieser Parameter gibt den Namen des Frontend-Moduls an.
Bei Angabe von
|
ENVTNAM
|
Beliebiger, gültiger z/OS-Modulname. | Keiner | Dieser Parameter wird nur von dem Bootstrap-Modul für die
nachrichtenorientierte Umgebung verwendet (TYPE ist leer).
Dieser Parameter gibt den Namen der Umgebungstabelle an. Dieser Parameter ist optional. Wenn er nicht angegeben wird, wird die Umgebungstabelle durch den Eintrag in der Transaktionscode-Tabelle bestimmt, der dem verwendeten Transaktionscode entspricht. |
TRNCODE
|
Dieser Parameter wird nur von dem Bootstrap-Modul für die
nachrichtenorientierte Umgebung verwendet (TYPE ist leer).
Dieser Parameter gibt den Namen des Transaktionscodes an, der intern von der Natural IMS TM-Schnittstelle verwendet wird. Dieser Parameter ist optional und wird nur berücksichtigt, wenn im Makro
Wird er nicht angegeben oder ist im Der Transaktionscode wird verwendet, um den Eintrag in der Transaktionscode-Tabelle zu bestimmen. |
||
DYNPARM
|
Beliebige Zeichenkette mit bis zu 80 Zeichen. | Keiner | Dieser Parameter wird nur von dem Bootstrap-Modul für die
nachrichtenorientierte Umgebung verwendet (TYPE ist leer).
Mit diesem Parameter wird eine gültige Zeichenkette von bis zu 80 Zeichen für dynamische Natural-Parameter definiert. |
SERVERN
|
Beliebiger, gültiger z/OS-Modulname. | NIIBOOTS |
Dieser Parameter wird nur von der Server-Call-Schnittstelle (TYPE) verwendet.
Dieser Parameter gibt den Namen der Serverumgebung an. Er ist nur relevant, wenn Sie mehrere Natural-Server in derselben Region
verwenden wollen. In diesem Fall müssen Sie mehrere Server-Call-Schnittstellen
generieren und für jede einzelne einen eindeutigen Namen mit
Siehe Spezielle Funktionen, Server-Umgebung. |
