Optionale Metadaten

Als Entwickler können Sie festlegen, dass die Laufzeitumgebung Transaction Integrator (TI) Metadaten an und aus dem Mainframetransaktionsprogramm (TP) sendet und empfangen soll, und Sie können den Inhalt dieser Metadaten auswählen.

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 gemäß den Anweisungen an oder von dem TP. Metadaten unterstützen das TP in:

• Identifizieren des Formats der Metadaten (Versionsinformationen).

• Identifizieren des Namens der Methode, die zum Aufrufen des TP verwendet wird.

• Detaillierte Fehlerinformationen zurück an den Client melden.

  Die Metadaten sind für den Automatisierungsclient nicht sichtbar. Die Metadaten werden an den Host-TP als Teil der Anforderungsnachricht übermittelt (oder von ihm empfangen).

  Der Metadatensatz enthält die folgenden Daten:

• TI-Laufzeitversion.

  Eine Zeichenfolge mit Zeichen, 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 Ausnahmeblock eindeutig identifiziert. Die GUID unterstützt die Möglichkeit, zukünftig zusätzliche Ausnahmeformate zu haben und sicherzustellen, dass alle empfangenen Daten gültig sind.

• Variablen mit bisher nicht zugewiesener Verwendung (reserviert):

  • Boolesche Kennzeichnung, die angibt, ob der TP für den Commit bereit ist.

  • Boolesche Kennzeichnung, die angibt, ob der TP bereit ist, zusätzliche Arbeit auszuführen.

  • Zwei kurze Integer sollen Bestandteile der TI-Laufzeitumgebungs-Versionsnummer speichern: ein Short Integer für die Hauptversionsnummer und ein weiterer für die Nebenversionsnummer.

• Ausnahmeblock (nur in Antworten verwendet).

  Eine GUID im Binärformat, die diesen Ausnahmeblock eindeutig identifiziert. Die GUID ermöglicht die Unterstützung zusätzlicher Ausnahmeformate in Zukunft und stellt sicher, dass die empfangenen Daten gültig sind:

  • Boolean-Flag, der angibt, ob das TP bereit ist, zu committen.

  • Boolean-Flag, das angibt, ob der TP bereit ist, zusätzliche Arbeit zu leisten.

  • Boolesche Kennzeichnung, die angibt, ob eine Ausnahme an die Clientanwendung zurückgegeben werden soll. Wenn dieses Kennzeichen festgelegt ist, wird die Transaktion ebenfalls beendet.

  • 16-Bit-Ganzzahl, die den Fehler identifiziert (siehe Hinweis weiter unten in diesem Thema). Sie können diesen Wert zusammen mit der 256-Zeichen langen Meldung, die den Fehler beschreibt, auf dem 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.