Dieses Kapitel enthält eine Übersicht über die User Exits, die bei der Natural IMS TM-Schnittstelle zur Verfügung stehen. Für jeden Exit wird ein gleichnamiges Quellcodemodul bereitgestellt. Jedes Quellcodemodul enthält eine Beschreibung der Parameterliste und der Registerkonventionen.
Der Exit wird aufgerufen, bevor ein Abrechnungssatz (Accounting
Record) in das IMS-TM Log (Protokoll) oder in das SMF geschrieben wird. Er
ermöglicht es also, den Inhalt eines Abrechnungssatzes zu ändern. Wenn
NIIXACCT ein Register 15 ungleich Null zurückgibt, wird kein
Abrechnungssatz geschrieben.
Der Exit wird bei jedem Transaktionsschritt aufgerufen, nachdem die SPA und die Nachricht abgerufen wurden und der Natural Thread verschoben (Roll-in) und dekomprimiert wurde. Innerhalb dieses Exits sind der Natural IOCB und der Treiberarbeitsbereich zugänglich.
Wenn nach der Rückkehr von NIIXSSTA im Register 15 der Wert 12
steht, wird die Natural IMS TM-Schnittstelle gezwungen, die Natural-Sitzung zu
beenden. Jeder andere Wert ungleich Null in Register 15 zwingt die
Schnittstelle zur Ausgabe des Natural IMS TM Interface-Fehlers 3517 mit dem
Reason Code, der den Wert in Register 15 enthält.
Anmerkung
Dieser Exit wird nicht aufgerufen, wenn eine neue Natural-Sitzung
gestartet wird.
Dieser Exit wird aufgerufen, wenn eine neue Natural-Benutzersitzung gestartet wurde und die SPA und der Natural IOCB initialisiert wurden. Innerhalb dieses Exits sind der Natural IOCB und der Treiberarbeitsbereich zugänglich.
Wenn nach der Rückkehr von NIIXSSTA im Register 15 der
Wert 12 steht, wird die Natural IMS TM-Schnittstelle gezwungen, die
Natural-Sitzung zu beenden. Jeder andere Wert ungleich Null in Register 15
zwingt die Schnittstelle zur Ausgabe des Natural IMS TM Interface-Fehlers 3509
mit dem Reason Code, der den Wert in Register 15 enthält.
Dieser Exit wird vor dem Einfügen der Nachricht in den IOPCB aufgerufen.
Dieser Exit wird vor dem Einfügen der SPA in den IOPCB aufgerufen, und zwar selbst bei Ende der Natural-Sitzung. Das Ende der Sitzung kann am leeren Transaktionscode erkannt werden.
Dieser Exit wird aufgerufen, wenn das Servicemodul
CMGETMSG verwendet wird. NIIXTGU0 erhält die
Kontrolle unmittelbar nach dem GU-Aufruf gegen den IOPCB, und zwar unabhängig
vom Statuscode.
Dieser Exit wird aufgerufen, wenn die JES API zum Schreiben von Reports verwendet wird. Er wird aufgerufen, nachdem der Optionsstring erstellt wurde und kann zur Änderung des Optionsstrings verwendet werden.
Dieser Exit wird aufgerufen, wenn Reports direkt auf IMS TM-Drucker geschrieben werden. Er kann verwendet werden, um die Codes für Formularvorschub (Form Feed) und Zeilenumbruch (New Line) zu setzen.
Dieser Exit wird aufgerufen, wenn die neue Natural Session einem Roll File zugewiesen wird. Er kann verwendet werden, um die Nummer des Roll File zu berechnen, das für diese Sitzung verwendet werden soll.
Dieser Exit wird aufgerufen, wenn das Servicemodul
CMGSEGO oder CMGETSEG verwendet wird.
NIIXTGN0 erhält die Kontrolle unmittelbar nach dem Abrufen des
Nachrichtensegments, und zwar unabhängig vom Statuscode.
