Metadata Opsional

Sebagai pengembang, Anda dapat memilih untuk meminta lingkungan run-time Transaction Integrator (TI) mengirim dan menerima metadata ke dan dari program transaksi mainframe (TP), dan Anda dapat memilih konten metadata tersebut.

Nota

Metadata tidak didukung untuk panggilan program terdistribusi (DPC).

Anda dapat mengirim atau menerima:

• Tidak ada metadata.

• Hanya nama metode sebagai metadata.

• Semua metadata termasuk nama metode.

  Lingkungan run-time TI mengirim atau menerima metadata ke atau dari TP sesuai instruksi. Metadata membantu TP dalam:

• Mengidentifikasi format dari metadata (informasi tentang versi).

• Mengidentifikasi nama metode yang digunakan untuk memanggil TP.

• Melaporkan informasi kesalahan terperinci kembali ke klien.

  Metadata tidak terlihat oleh klien Automation. Metadata dikirimkan ke (atau diterima dari) TP host sebagai bagian dari pesan permintaan yang dikirim ke (atau pesan respons yang diterima dari) TP.

  Kumpulan metadata menyertakan data berikut:

• Versi run-time TI.

  String karakter, seperti "Microsoft TI versi 1.0.0," yang secara unik mengidentifikasi versi lingkungan run-time TI yang menghasilkan permintaan.

• Nama metode (string 32 karakter) yang dipanggil oleh kode aplikasi klien.

• ID metadata blok.

  GUID dalam format karakter yang secara unik mengidentifikasi blok data pengecualian ini. GUID mendukung kemampuan untuk memiliki format pengecualian tambahan di masa mendatang dan membantu memastikan bahwa data apa pun yang diterima valid.

• Variabel yang belum digunakan hingga saat ini (cadangan):

  • Bendera Boolean menunjukkan apakah TP siap untuk berkomitmen.

  • Bendera Boolean menunjukkan apakah TP siap untuk melakukan pekerjaan tambahan.

  • Dua Integer Pendek digunakan untuk menyimpan segmen nomor versi lingkungan run-time TI: satu Integer Pendek untuk menyimpan nomor versi utama dan satu lainnya untuk menyimpan nomor versi minor.

• Blok Pengecualian (hanya digunakan dalam balasan).

  GUID, dalam format biner, yang secara unik mengidentifikasi blok data pengecualian ini. GUID memungkinkan dukungan format pengecualian tambahan di masa mendatang dan membantu memastikan data yang diterima valid:

  • Bendera Boolean yang menunjukkan apakah TP siap untuk berkomitmen.

  • Bendera Boolean yang menunjukkan apakah TP siap untuk melakukan pekerjaan tambahan.

  • Bendera Boolean yang menunjukkan apakah pengecualian harus dikembalikan ke aplikasi klien. Jika diatur, bendera ini juga menyebabkan transaksi berhenti.

  • Bilangan bulat 16-bit yang mengidentifikasi kesalahan (lihat catatan nanti dalam topik ini). Anda dapat menetapkan nilai ini, bersama dengan pesan 256 karakter yang menjelaskan kesalahan, dari server sehingga nilai yang ditetapkan dikembalikan saat kesalahan run-time TI terjadi.

  • Bilangan bulat 32-bit yang mengidentifikasi ID konteks dalam file Bantuan TP (jika ada).

  • Pesan 256 karakter yang menjelaskan kesalahan. Anda dapat menetapkan nilai ini, bersama dengan bilangan bulat 16-bit yang mengidentifikasi kesalahan dari server, sehingga nilai yang ditetapkan dikembalikan ketika kesalahan run-time TI terjadi.

  Metadata selalu terletak di awal pesan.

Nota

Pesan kesalahan TI memiliki angka dalam rentang 0 hingga 9999. Nomor pesan kesalahan metadata yang dikembalikan dari mainframe dapat berada dalam rentang yang sama. Untuk membedakan pesan kesalahan TI dari pesan metadata yang dikembalikan dari mainframe, TI menambahkan 10000 ke jumlah pesan kesalahan metadata apa pun yang dikembalikan dari mainframe.