Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Als Entwickler können Sie festlegen, dass die Transaktionsintegrator-Laufzeitumgebung (TI) Metadaten an und aus dem Mainframetransaktionsprogramm (TP) sendet und empfängt, und Sie können den Inhalt dieser Metadaten auswählen.
Hinweis
Metadaten werden für DPC (Distributed Program Call) nicht unterstützt.
Sie können Folgendes senden oder empfangen:
Keine Metadaten.
Nur der Methodenname als Metadaten.
Alle Metadaten, einschließlich des Methodennamens.
Die TI-Laufzeitumgebung sendet oder empfängt metadaten an oder vom TP wie angewiesen. Metadaten unterstützen den TP in:
Identifizieren des Formats der Metadaten (Versionsinformationen).
Identifizieren des Namens der Methode, die zum Aufrufen des TP verwendet wird.
Melden detaillierter Fehlerinformationen zurück an den Client.
Die Metadaten sind für den Automation-Client nicht sichtbar. Die Metadaten werden an den Host-TP als Teil der Anforderungsnachricht an den TP gesendet (oder empfangen).
Der Metadatensatz enthält die folgenden Daten:
TI-Laufzeitversion.
Eine Zeichenfolge, z. B. "Microsoft TI Version 1.0.0", die die TI-Laufzeitumgebungsversion eindeutig identifiziert, die die Anforderung generiert hat.
Methodenname (32-stellige Zeichenfolge), die vom Clientanwendungscode aufgerufen wird.
Metadatenblock-ID.
Eine GUID im Zeichenformat, die diesen Block von Ausnahmedaten eindeutig identifiziert. Die GUID unterstützt die Möglichkeit, in Zukunft zusätzliche Ausnahmeformate zu verwenden, und hilft sicherzustellen, dass alle empfangenen Daten gültig sind.
Variablen ohne zugewiesene Verwendungen bis datum (reserviert):
Boolesches Flag, das angibt, ob der TP bereit zum Commit ist.
Boolesches Flag, das angibt, ob der TP bereit ist, zusätzliche Aufgaben auszuführen.
Zwei kurze ganze Zahlen, die Teile der Versionsnummer der TI-Laufzeitumgebung enthalten, eine kurze Ganzzahl, die die Hauptversionsnummer enthält, und die andere, um die Nebenversionsnummer zu enthalten.
Ausnahmeblock (wird nur in Antworten verwendet).
Eine GUID im Binärformat, die diesen Block von Ausnahmedaten eindeutig identifiziert. Die GUID ermöglicht die Unterstützung weiterer Ausnahmeformate in der Zukunft und trägt dazu bei, sicherzustellen, dass die empfangenen Daten gültig sind:
Boolesches Flag, das angibt, ob der TP bereit zum Commit ist.
Boolesches Flag, das angibt, ob der TP bereit ist, zusätzliche Aufgaben auszuführen.
Boolesches Flag, das angibt, ob eine Ausnahme an die Clientanwendung zurückgegeben werden soll. Falls festgelegt, bewirkt dieses Flag auch, dass die Transaktion beendet wird.
16-Bit-Ganzzahl, die den Fehler identifiziert (siehe Hinweis weiter unten in diesem Thema). Sie können diesen Wert zusammen mit der 256-stelligen Meldung, die den Fehler beschreibt, vom Server zuweisen, sodass der zugewiesene Wert zurückgegeben wird, wenn ein TI-Laufzeitfehler auftritt.
32-Bit-Ganzzahl, die die Kontext-ID in der TP-Hilfedatei (falls vorhanden) identifiziert.
256-stellige Meldung, die den Fehler beschreibt. Sie können diesen Wert zusammen mit der 16-Bit-Ganzzahl zuweisen, die den Fehler vom Server identifiziert, sodass der zugewiesene Wert zurückgegeben wird, wenn ein TI-Laufzeitfehler auftritt.
Metadaten befinden sich immer am Anfang der Nachricht.
Hinweis
TI-Fehlermeldungen weisen Zahlen im Bereich von 0 bis 9999 auf. Metadatenfehlernummern, die vom Mainframe zurückgegeben werden, können innerhalb desselben Bereichs liegen. Um TI-Fehlermeldungen von metadatenbasierten Nachrichten zu unterscheiden, die vom Mainframe zurückgegeben werden, fügt TI der Anzahl aller vom Mainframe zurückgegebenen Metadatenfehlermeldungen 10000 hinzu.