Wie TI die Rückgabe von Ausnahmen für TPs aktiviert
TI bietet einen Metadatenmechanismus zum Zurückgeben von Ausnahmen von Automation-Serveranwendungen wie TI-Anwendungen. TI verwendet diesen Mechanismus, um dem Mainframeentwickler eine optionale Möglichkeit zur Rückgabe von Mainframefehlerinformationen (auch als Ausnahmedaten bezeichnet) über die normale Anwendung bereitzustellen.
Ein Transaktionsprogramm (TP) gibt Fehlerinformationen als optionale Metadaten zurück, die einen Ausnahmeblock als Teil der Antwortnachricht enthalten. Der Ausnahmeblock enthält Informationen in einem Standardformat, die zum Auffüllen einer Automation-Ausnahmestruktur verwendet werden können.
TI-Fehlermeldungen weisen Zahlen im Bereich von 0 bis 9999 auf. Vom Mainframe zurückgegebene Metadatenfehlermeldungen können innerhalb desselben Bereichs liegen. Um TI-Fehlermeldungen von meta-Datennachrichten zu unterscheiden, die vom Mainframe zurückgegeben werden, fügt TI 10000 zur Anzahl der vom Mainframe zurückgegebenen Metadatenfehlermeldungen hinzu.
Ein TP kann diesen Mechanismus auch verwenden, um der TI-Laufzeitumgebung Informationen über den TP-Zustand bereitzustellen. Insbesondere kann ein TP angeben, ob der TP:
Ist bereit, die bisher ausgeführte Arbeit zu committen (und die Zuordnung der Unterhaltung zu aufheben).
Kann keine weitere Arbeit an der aktuellen Unterhaltung ausführen und erwartet, dass der Client vorbereitet und committet.
Es ist ein Fehler aufgetreten, der das Committen der Transaktion verhindert.
Obwohl es immer möglich ist, dass ein TP die Konversation abrupt aufgibt, ermöglichen TI-Ausnahmen es, detaillierte Informationen über den Fehler an die aufrufende Clientanwendung zurückzugeben.
TI verwendet die im Ausnahmeblock enthaltenen Informationen, um Statusinformationen in der TI-Laufzeitumgebung zu aktualisieren und (falls angefordert) eine Ausnahme an die Clientanwendung zurückzugeben.
Die folgende Tabelle zeigt die Felder in der EXCEPINFO-Ausnahmestruktur.
| Feld | BESCHREIBUNG |
|---|---|
| wCode | Der im Ausnahmeblock zurückgegebene Fehlercode. |
| bstrSource | Wird automatisch von TI basierend auf Informationen über das Objekt des Kunden und den Remote-TP generiert. |
| bstrDescription | Aus dem Ausnahmeblock. Diese Fehlerbeschreibung stammt aus dem Remote-TP. |
| bstrHelpFile | Erstellt, indem der Hilfepfad verwendet wird, der der Komponentenbibliothek des Objekts (in der Registrierung) zugeordnet ist, und es mit einem nicht qualifizierten Dateinamen kombiniert wird, der als benutzerdefinierte Informationen in der Komponentenbibliothek enthalten ist. Dadurch kann der Entwickler den Dateinamen der Hilfedatei bei der Erstellung identifizieren und dem Administrator die ultimative Kontrolle darüber geben, wo die Hilfedatei während der Bereitstellung installiert wird. |
| dwHelpContext | Aus der Ausnahme. |
| Scode | Identisch mit wCode. |
Es ist möglich, dass der TP Zustandsinformationen zurückgibt, ohne tatsächlich eine Ausnahme auszulösen. Um den Mainframe-TP-Code so einfach wie möglich zu halten, sind die Ausnahmedaten Teil der optionalen Metadaten und werden in allen Fällen zurückgegeben, unabhängig davon, ob ein Fehler auftritt oder nicht.