Proprietà di contesto di MQSeries
Nell'adapter MQSeries è disponibile un set di proprietà di contesto, specifiche di MQSeries, da utilizzare nelle applicazioni. È possibile utilizzare queste proprietà nelle espressioni di filtro e nelle orchestrazioni.
Per assegnare le proprietà di contesto di MQSeries a un messaggio destinato a una porta di trasmissione associata all'adapter MQSeries, utilizzare l'operatore di assegnazione messaggi e specificare una delle proprietà di contesto disponibili nello spazio dei nomi MQSeries.
Di seguito è riportato un esempio di impostazione della proprietà MQSeries MQMD_UserIdentifier :
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
È possibile ottenere valori enumerati dai file di intestazione del linguaggio di programmazione C inclusi nell'SDK di IBM MQSeries. Questi file sono disponibili nella cartella Programmi\IBM\WebSphere MQ\Tools\c\include. Questi file definiscono i valori da utilizzare per l'impostazione o la lettura dei valori delle proprietà di contesto di MQSeries.
I valori di stringa esadecimali sono stringhe di caratteri che rappresentano valori binari. Non dispongono di un prefisso, ad esempio 0x. Contengono cifre da 0 a 9 e lettere da "a" a "f" o da "A" a "F". L'adapter ignora gli spazi vuoti in essi contenuti.
Per ulteriori informazioni su queste proprietà, vedere la documentazione di IBM WebSphere MQ.
Nella tabella seguente vengono illustrati il set completo di proprietà di descrizione dei messaggi (struttura MQMD) e i corrispondenti tipi e valori.
| Nome | Tipo | Length | Valore |
|---|---|---|---|
| MQMD_AccountingToken | string | 64 | Stringa esadecimale |
| MQMD_ApplIdentityData | string | 32 | Stringa esadecimale |
| MQMD_ApplOriginData | string | 4 | string Impostazione predefinita: spazio |
| MQMD_BackoutCount | int senza segno | 4 | Numero Sola lettura Impostazione predefinita: 0 |
| MQMD_CodedCharSetId | int senza segno | 4 | Numero Impostazione predefinita: 0 |
| MQMD_CorrelId | string | 48 | Stringa esadecimale |
| MQMD_Encoding | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. Impostazione predefinita: 0 |
| MQMD_Expiry | int senza segno | 4 | Numero |
| MQMD_Feedback | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. Impostazione predefinita: 0 |
| MQMD_Format | string | 8 | string Se impostata su MQXMIT, verificare che le proprietà MQXQH dispongano di valori. |
| MQMD_GroupID | string | 48 | Stringa esadecimale |
| MQMD_MsgFlags | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. Impostazione predefinita: 0 |
| MQMD_MsgId | string | 48 | Stringa esadecimale |
| MQMD_MsgSeqNumber | int senza segno | 4 | |
| MQMD_MsgType | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. |
| MQMD_Offset | int senza segno | 4 | |
| MQMD_OriginalLength | int senza segno | 4 | |
| MQMD_Persistence | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. |
| MQMD_Priority | int senza segno | 4 | Numero |
| MQMD_PutApplName | string | 28 | string Impostazione predefinita: spazio |
| MQMD_PutApplType | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. Impostazione predefinita: 0 |
| MQMD_PutDate | string | 8 | Data |
| MQMD_PutTime | string | 8 | Ora |
| MQMD_ReplyToQ | string | 48 | string Impostazione predefinita: spazio |
| MQMD_ReplyToQMgr | string | 48 | string Impostazione predefinita: spazio |
| MQMD_Report | int senza segno | 4 | Numero Utilizzare il valore del file di intestazione. |
| MQMD_UserIdentifier | string | 12 | string Contiene l'identificatore utente quando si usa la proprietà SSOAffiliateApplication . |
Durante la ricezione di messaggi direttamente dalle code di trasmissione di MQSeries, l'adapter MQSeries formatta le proprietà di intestazione delle code di trasmissione (la struttura di dati MQXQH) e le inserisce nelle proprietà di contesto corrispondenti. Quando si inviano messaggi direttamente alle code di trasmissione MQSeries, le proprietà dell'intestazione vengono formattate e assegnate valori dalle proprietà di contesto corrispondenti solo se la proprietà MQMD_Format ha un valore MQXMIT. Nella tabella seguente vengono descritte le proprietà.
| Nome | Tipo | Length | Valore |
|---|---|---|---|
| MQXQH_RemoteQMgrName | string | 48 | string |
| MQXQH_RemoteQName | string | 48 | string |
Insieme alle proprietà elencate in precedenza in questo argomento, l'adapter inserisce i valori di descrizione dei messaggi seguenti applicando le stesse regole. L'adapter antepone a queste proprietà nomi con MQXQH_ invece che con MQMD_. In caso contrario, viene eseguito il mapping direttamente alle proprietà definite nella tabella di descrizione dei messaggi:
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
Nello schema proprietà sono incluse altre proprietà relative a MQSeries, disponibili per l'utilizzo nelle espressioni di filtro. Nella tabella seguente vengono elencate queste proprietà.
| Nome | Tipo | Length | Valore |
|---|---|---|---|
| MQCIH_AbendCode | string | 4 | |
| MQCIH_ADSDescriptor | int senza segno | 4 | |
| MQCIH_AttentionId | string | 4 | |
| MQCIH_Authenticator | string | 8 | Impostare sulla password SSO quando si usa la proprietà SSOAffiliateApplication . Nota: Questo valore verrà impostato su vuoto dall'adattatore MQSeries se la lunghezza della password SSO supera 8 caratteri. |
| MQCIH_CancelCode | string | 4 | |
| MQCIH_CompCode | int senza segno | 4 | |
| MQCIH_ConversationalTask | int senza segno | 4 | |
| MQCIH_CursorPosition | int senza segno | 4 | |
| MQCIH_ErrorOffset | int senza segno | 4 | |
| MQCIH_Facility | string | 16 | Stringa esadecimale |
| MQCIH_FacilityKeepTime | int senza segno | 4 | |
| MQCIH_FacilityLike | string | 4 | |
| MQCIH_Flags | int senza segno | 4 | |
| MQCIH_Format | string | ||
| MQCIH_Function | string | 4 | |
| MQCIH_GetWaitInterval | int senza segno | 4 | |
| MQCIH_LinkType | int senza segno | 4 | |
| MQCIH_NextTransactionId | string | 4 | |
| MQCIH_OutputDataLength | int senza segno | 4 | |
| MQCIH_Reason | int senza segno | 4 | |
| MQCIH_ReplyToFormat | string | ||
| MQCIH_ReturnCode | int senza segno | 4 | |
| MQCIH_StartCode | string | 4 | |
| MQCIH_TaskEndStatus | int senza segno | 4 | |
| MQCIH_TransactionId | string | 4 | |
| MQCIH_UOWControl | int senza segno | 4 | |
| MQIIH_Authenticator | string | 8 | Impostare sulla password SSO quando si usa la proprietà SSOAffiliateApplication . Nota: Questo valore verrà impostato su vuoto dall'adattatore MQSeries se la lunghezza della password SSO supera 8 caratteri. |
| MQIIH_CommitMode | string | ||
| MQIIH_Flags | int senza segno | 4 | |
| MQIIH_Format | string | ||
| MQIIH_LTermOverride | string | 8 | |
| MQIIH_MFSMapName | string | 8 | |
| MQIIH_ReplyToFormat | string | ||
| MQIIH_SecurityScope | string | ||
| MQIIH_TranInstanceId | string | 32 | Stringa esadecimale |
| MQIIH_TranState | string |
Vedere anche
Proprietà dell'adapter MQSeries
Proprietà relative a BizTalk Server
Conversione del tipo di dati delle proprietà