省略可能なメタデータ

開発者は、トランザクション インテグレーター (TI) ランタイム環境でメインフレーム トランザクション プログラム (TP) との間でメタデータの送受信を行い、そのメタデータの内容を選択できます。

Note

分散プログラム呼び出し (DPC) ではメタデータはサポートされていません。

次の情報を送受信できます。

• メタデータがありません。

• メタデータとしてのメソッド名のみ。

• メソッド名を含むすべてのメタデータ。

  TI ランタイム環境は、指示に従って TP 間でメタデータを送受信します。 メタデータは、次の TP を支援します。

• メタデータの形式 (バージョン情報) を識別する。

• TP の呼び出しに使用されるメソッドの名前を識別します。

• 詳細なエラー情報をクライアントに報告する。

  メタデータは Automation クライアントに表示されません。 メタデータは、TP に送信された要求メッセージ (または TP から受信した応答メッセージ) の一部としてホスト TP に配信 (または受信) されます。

  メタデータ セットには、次のデータが含まれています。

• TI ランタイム バージョン。

  要求を生成した TI ランタイム環境のバージョンを一意に識別する文字列 ("Microsoft TI バージョン 1.0.0" など)。

• クライアント アプリケーション コードによって呼び出されるメソッド名 (32 文字の文字列)。

• メタデータ ブロック ID。

  この例外データ ブロックを一意に識別する GUID (文字形式)。 GUID は、今後、追加の例外形式を持つ機能をサポートしており、受信したデータが有効であることを確認するのに役立ちます。

• 現在までに使用が割り当てられていない変数 (予約済み):

  • TP がコミットする準備ができているかどうかを示すブール型フラグ。

  • TP が追加の作業を実行する準備ができているかどうかを示すブール型 (Boolean) フラグ。

  • TI ランタイム環境のバージョン番号の一部を保持する 2 つの短整数。1 つはメジャー バージョン番号を保持する Short Integer、もう 1 つはマイナー バージョン番号を保持する短整数です。

• 例外ブロック (応答でのみ使用されます)。

  この例外データ のブロックを一意に識別する GUID (バイナリ形式)。 GUID では、今後追加の例外形式をサポートでき、受信したデータが有効であることを確認するのに役立ちます。

  • TP がコミットする準備ができているかどうかを示すブール型フラグ。

  • TP が追加の作業を実行する準備ができているかどうかを示すブール型 (Boolean) フラグ。

  • 例外をクライアント アプリケーションに返す必要があるかどうかを示すブール型 (Boolean) フラグ。 このフラグを設定すると、トランザクションも終了します。

  • エラーを識別する 16 ビット整数 (このトピックで後述する注を参照)。 この値を、エラーを説明する 256 文字のメッセージと共にサーバーから割り当てて、TI ランタイム エラーが発生したときに割り当てられた値が返されるようにすることができます。

  • TP ヘルプ ファイル内のコンテキスト ID を識別する 32 ビット整数 (存在する場合)。

  • エラーを説明する 256 文字のメッセージ。 この値を、サーバーからのエラーを識別する 16 ビットの整数と共に割り当てて、TI ランタイム エラーが発生したときに割り当てられた値が返されるようにすることができます。

  メタデータは常にメッセージの先頭にあります。

Note

TI エラー メッセージの範囲は 0 ~ 9999 です。 メインフレームから返されるメタデータ エラー メッセージ番号は、同じ範囲内に収まる可能性があります。 TI エラー メッセージとメインフレームから返されるメタデータ メッセージを区別するために、TI はメインフレームから返されるメタデータ エラー メッセージの数に 10000 を追加します。