Properti Konteks MQSeries
Adaptor MQSeries menyediakan sekumpulan properti konteks, khusus untuk MQSeries, untuk digunakan dalam aplikasi Anda. Anda dapat menggunakan properti ini dalam ekspresi filter dan di orkestrasi Anda.
Untuk menetapkan properti konteks MQSeries ke pesan yang ditujukan ke port kirim yang terikat ke adaptor MQSeries, gunakan operator penetapan pesan dan tentukan salah satu properti konteks yang tersedia di namespace layanan MQSeries.
Berikut ini adalah contoh pengaturan properti MQMD_UserIdentifier MQSeries:
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
Anda harus mendapatkan nilai enumerasi dari file header bahasa pemrograman C yang disertakan dengan IBM MQSeries SDK. Anda dapat menemukan file-file ini di folder Program Files\IBM\WebSphere MQ\Tools\c\include. File-file ini menentukan nilai yang akan digunakan saat mengatur atau membaca nilai properti konteks MQSeries.
Nilai string heksadesimal adalah string karakter yang mewakili nilai biner. Mereka tidak memiliki awalan seperti 0x. Mereka berisi digit dari 0 hingga 9 dan huruf dari "a" hingga "f" atau "A" hingga "F". Adaptor mengabaikan spasi kosong di dalamnya.
Untuk informasi selengkapnya tentang properti ini, lihat dokumentasi IBM WebSphere MQ.
Tabel berikut ini memperlihatkan kumpulan lengkap properti Deskriptor Pesan (struktur MQMD) yang tersedia serta jenis dan nilai terkaitnya.
| Nama | Jenis | Panjang | Nilai |
|---|---|---|---|
| MQMD_AccountingToken | string | 64 | String heksadesimal |
| MQMD_ApplIdentityData | string | 32 | String heksadesimal |
| MQMD_ApplOriginData | string | 4 | String Default: spasi |
| MQMD_BackoutCount | int tidak bertanda | 4 | Telepon Baca saja Default: 0 |
| MQMD_CodedCharSetId | int tidak bertanda | 4 | Telepon Default: 0 |
| MQMD_CorrelId | string | 48 | String heksadesimal |
| MQMD_Encoding | int tidak bertanda | 4 | Telepon Gunakan nilai file header. Default: 0 |
| MQMD_Expiry | int tidak bertanda | 4 | Telepon |
| MQMD_Feedback | int tidak bertanda | 4 | Telepon Gunakan nilai file header. Default: 0 |
| MQMD_Format | string | 8 | String Jika diatur ke MQXMIT, pastikan bahwa properti MQXQH memiliki nilai. |
| MQMD_GroupID | string | 48 | String heksadesimal |
| MQMD_MsgFlags | int tidak bertanda | 4 | Telepon Gunakan nilai file header. Default: 0 |
| MQMD_MsgId | string | 48 | String heksadesimal |
| MQMD_MsgSeqNumber | int tidak bertanda | 4 | |
| MQMD_MsgType | int tidak bertanda | 4 | Telepon Gunakan nilai file header. |
| MQMD_Offset | int tidak bertanda | 4 | |
| MQMD_OriginalLength | int tidak bertanda | 4 | |
| MQMD_Persistence | int tidak bertanda | 4 | Telepon Gunakan nilai file header. |
| MQMD_Priority | int tidak bertanda | 4 | Telepon |
| MQMD_PutApplName | string | 28 | String Default: spasi |
| MQMD_PutApplType | int tidak bertanda | 4 | Telepon Gunakan nilai file header. Default: 0 |
| MQMD_PutDate | string | 8 | Tanggal |
| MQMD_PutTime | string | 8 | Waktu |
| MQMD_ReplyToQ | string | 48 | String Default: spasi |
| MQMD_ReplyToQMgr | string | 48 | String Default: spasi |
| MQMD_Report | int tidak bertanda | 4 | Telepon Gunakan nilai file header. |
| MQMD_UserIdentifier | string | 12 | String Berisi pengidentifikasi pengguna saat Anda menggunakan properti SSOAffiliateApplication . |
Saat menerima pesan langsung dari antrean transmisi MQSeries, adaptor MQSeries memformat properti header antrean transmisi (struktur data MQXQH) dan menempatkannya di properti konteks yang sesuai. Saat mengirim pesan langsung ke antrean transmisi MQSeries, properti header diformat dan ditetapkan nilai dari properti konteks yang sesuai hanya jika properti MQMD_Format memiliki nilai MQXMIT. Tabel berikut ini menjelaskan properti.
| Nama | Jenis | Panjang | Nilai |
|---|---|---|---|
| MQXQH_RemoteQMgrName | string | 48 | string |
| MQXQH_RemoteQName | string | 48 | string |
Bersama dengan properti yang tercantum sebelumnya dalam topik ini, adaptor mengisi nilai Deskriptor Pesan berikut mengikuti aturan yang sama. Adapter mengawali nama properti ini dengan MQXQH_ alih-alih MQMD_, tetapi jika tidak, mereka memetakan langsung ke properti yang ditentukan dalam tabel Deskriptor Pesan:
MQXQH_MsgDesc_AccountingToken
MQXQH_MsgDesc_ApplIdentityData
MQXQH_MsgDesc_ApplOriginData
MQXQH_MsgDesc_BackoutCount
MQXQH_MsgDesc_CodedCharSetId
MQXQH_MsgDesc_CorrelId
MQXQH_MsgDesc_Encoding
MQXQH_MsgDesc_Expiry
MQXQH_MsgDesc_Feedback
MQXQH_MsgDesc_Format
MQXQH_MsgDesc_MsgId
MQXQH_MsgDesc_MsgType
MQXQH_MsgDesc_Persistence
MQXQH_MsgDesc_Priority
MQXQH_MsgDesc_PutApplName
MQXQH_MsgDesc_PutApplType
MQXQH_MsgDesc_PutDate
MQXQH_MsgDesc_PutTime
MQXQH_MsgDesc_ReplyToQ
MQXQH_MsgDesc_ReplyToQMgr
MQXQH_MsgDesc_Report
MQXQH_MsgDesc_UserIdentifier
Ada properti terkait MQSeries tambahan yang disertakan dalam skema properti dan tersedia untuk digunakan dalam ekspresi pemfilteran. Tabel berikut mencantumkan properti ini.
| Nama | Jenis | Panjang | Nilai |
|---|---|---|---|
| MQCIH_AbendCode | string | 4 | |
| MQCIH_ADSDescriptor | int tidak bertanda | 4 | |
| MQCIH_AttentionId | string | 4 | |
| MQCIH_Authenticator | string | 8 | Atur ke kata sandi SSO saat Anda menggunakan properti SSOAffiliateApplication . Catatan: Nilai ini akan diatur ke kosong oleh adaptor MQSeries jika panjang kata sandi SSO melebihi 8 karakter. |
| MQCIH_CancelCode | string | 4 | |
| MQCIH_CompCode | int tidak bertanda | 4 | |
| MQCIH_ConversationalTask | int tidak bertanda | 4 | |
| MQCIH_CursorPosition | int tidak bertanda | 4 | |
| MQCIH_ErrorOffset | int tidak bertanda | 4 | |
| MQCIH_Facility | string | 16 | String heksadesimal |
| MQCIH_FacilityKeepTime | int tidak bertanda | 4 | |
| MQCIH_FacilityLike | string | 4 | |
| MQCIH_Flags | int tidak bertanda | 4 | |
| MQCIH_Format | string | ||
| MQCIH_Function | string | 4 | |
| MQCIH_GetWaitInterval | int tidak bertanda | 4 | |
| MQCIH_LinkType | int tidak bertanda | 4 | |
| MQCIH_NextTransactionId | string | 4 | |
| MQCIH_OutputDataLength | int tidak bertanda | 4 | |
| MQCIH_Reason | int tidak bertanda | 4 | |
| MQCIH_ReplyToFormat | string | ||
| MQCIH_ReturnCode | int tidak bertanda | 4 | |
| MQCIH_StartCode | string | 4 | |
| MQCIH_TaskEndStatus | int tidak bertanda | 4 | |
| MQCIH_TransactionId | string | 4 | |
| MQCIH_UOWControl | int tidak bertanda | 4 | |
| MQIIH_Authenticator | string | 8 | Atur ke kata sandi SSO saat Anda menggunakan properti SSOAffiliateApplication . Catatan: Nilai ini akan diatur ke kosong oleh adaptor MQSeries jika panjang kata sandi SSO melebihi 8 karakter. |
| MQIIH_CommitMode | string | ||
| MQIIH_Flags | int tidak bertanda | 4 | |
| MQIIH_Format | string | ||
| MQIIH_LTermOverride | string | 8 | |
| MQIIH_MFSMapName | string | 8 | |
| MQIIH_ReplyToFormat | string | ||
| MQIIH_SecurityScope | string | ||
| MQIIH_TranInstanceId | string | 32 | String heksadesimal |
| MQIIH_TranState | string |
Lihat juga
Properti Adapter MQSeries
Properti yang Terkait dengan BizTalk Server
Konversi Tipe Data Properti