Propriétés de contexte MQSeries
L'adaptateur MQSeries offre un ensemble de propriétés de contexte spécifiques à MQSeries que vous pouvez utiliser dans vos applications, notamment au niveau des expressions de filtre et des orchestrations.
Pour assigner des propriétés de contexte MQSeries à un message destiné à un port d'envoi lié à l'adaptateur MQSeries, utilisez l'opérateur d'assignation du message et spécifiez l'une des propriétés de contexte disponibles dans l'espace de noms MQSeries.
Voici un exemple de définition de la propriété MQSeries MQMD_UserIdentifier :
Message_2(MQSeries.MQMD_UserIdentifier) = "MeMyselfAndI";
Vous devez obtenir des valeurs énumérées à partir des fichiers d'en-tête en langage de programmation C, lesquels sont inclus dans le kit de développement IBM MQSeries. Ces fichiers sont accessibles dans le dossier Program Files\IBM\WebSphere MQ\Tools\c\include. Ils définissent les valeurs à utiliser lors de la configuration ou de la lecture des valeurs des propriétés de contexte MQSeries.
Les valeurs de chaîne hexadécimales constituent des chaînes de caractères représentant des valeurs binaires. Elles ne disposent pas de préfixe tel que 0x. Elles sont constituées de chiffres compris entre 0 et 9 ainsi que de lettres comprises entre « a » et « f » ou « A » et « F ». L'adaptateur ignore les espaces intermédiaires.
Pour plus d'informations sur ces propriétés, consultez la documentation d'IBM WebSphere MQ.
Le tableau suivant répertorie l'intégralité des propriétés du descripteur de message (structure MQMD) ainsi que les types et les valeurs qui leur correspondent.
| Nom | Type | Longueur | Valeur |
|---|---|---|---|
| MQMD_AccountingToken | string | 64 | Chaîne hexadécimale |
| MQMD_ApplIdentityData | string | 32 | Chaîne hexadécimale |
| MQMD_ApplOriginData | string | 4 | String Par défaut : espace |
| MQMD_BackoutCount | nombre entier non signé | 4 | Number Lecture seule Valeur par défaut : 0 |
| MQMD_CodedCharSetId | nombre entier non signé | 4 | Number Valeur par défaut : 0 |
| MQMD_CorrelId | string | 48 | Chaîne hexadécimale |
| MQMD_Encoding | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. Valeur par défaut : 0 |
| MQMD_Expiry | nombre entier non signé | 4 | Number |
| MQMD_Feedback | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. Valeur par défaut : 0 |
| MQMD_Format | string | 8 | String Lorsque la propriété est définie sur MQXMIT, vérifiez que les propriétés MQXQH possèdent des valeurs. |
| MQMD_GroupID | string | 48 | Chaîne hexadécimale |
| MQMD_MsgFlags | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. Valeur par défaut : 0 |
| MQMD_MsgId | string | 48 | Chaîne hexadécimale |
| MQMD_MsgSeqNumber | nombre entier non signé | 4 | |
| MQMD_MsgType | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. |
| MQMD_Offset | nombre entier non signé | 4 | |
| MQMD_OriginalLength | nombre entier non signé | 4 | |
| MQMD_Persistence | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. |
| MQMD_Priority | nombre entier non signé | 4 | Number |
| MQMD_PutApplName | string | 28 | String Valeur par défaut : espace |
| MQMD_PutApplType | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. Valeur par défaut : 0 |
| MQMD_PutDate | string | 8 | Date |
| MQMD_PutTime | string | 8 | Temps |
| MQMD_ReplyToQ | string | 48 | String Valeur par défaut : espace |
| MQMD_ReplyToQMgr | string | 48 | String Valeur par défaut : espace |
| MQMD_Report | nombre entier non signé | 4 | Number Utilisez la valeur du fichier d'en-tête. |
| MQMD_UserIdentifier | string | 12 | String Contient l’identificateur utilisateur lorsque vous utilisez la propriété SSOAffiliateApplication . |
Lors de la réception de messages directement à partir des files d'attente de transmission MQSeries, l'adaptateur MQSeries formate les propriétés d'en-tête d'une file d'attente de transmission (la structure de données MQXQH) et les place dans les propriétés de contexte qui leur correspondent. Lors de l’envoi de messages directement aux files d’attente de transmission MQSeries, les propriétés d’en-tête sont mises en forme et attribuées à partir des propriétés de contexte correspondantes uniquement si la propriété MQMD_Format a une valeur de MQXMIT. Le tableau suivant décrit les propriétés.
| Nom | Type | Longueur | Valeur |
|---|---|---|---|
| MQXQH_RemoteQMgrName | string | 48 | string |
| MQXQH_RemoteQName | string | 48 | string |
L'adaptateur renseigne les valeurs du descripteur de message conjointement avec les propriétés décrites précédemment dans cette rubrique d'après les mêmes règles. Il ajoute le préfixe MQXQH_ (au lieu de MQMD_) aux noms des propriétés, car autrement elles mappent directement vers les propriétés définies dans le tableau du descripteur de message :
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
Il existe d'autres propriétés associées à MQSeries qui sont incluses dans le schéma de propriété et qui peuvent être utilisées dans les expressions de filtre. Celles-ci sont décrites dans le tableau suivant.
| Nom | Type | Longueur | Valeur |
|---|---|---|---|
| MQCIH_AbendCode | string | 4 | |
| MQCIH_ADSDescriptor | nombre entier non signé | 4 | |
| MQCIH_AttentionId | string | 4 | |
| MQCIH_Authenticator | string | 8 | Définissez sur le mot de passe d’authentification unique lorsque vous utilisez la propriété SSOAffiliateApplication . Note: Cette valeur est définie sur vide par l’adaptateur MQSeries si la longueur du mot de passe de l’authentification unique dépasse 8 caractères. |
| MQCIH_CancelCode | string | 4 | |
| MQCIH_CompCode | nombre entier non signé | 4 | |
| MQCIH_ConversationalTask | nombre entier non signé | 4 | |
| MQCIH_CursorPosition | nombre entier non signé | 4 | |
| MQCIH_ErrorOffset | nombre entier non signé | 4 | |
| MQCIH_Facility | string | 16 | Chaîne hexadécimale |
| MQCIH_FacilityKeepTime | nombre entier non signé | 4 | |
| MQCIH_FacilityLike | string | 4 | |
| MQCIH_Flags | nombre entier non signé | 4 | |
| MQCIH_Format | string | ||
| MQCIH_Function | string | 4 | |
| MQCIH_GetWaitInterval | nombre entier non signé | 4 | |
| MQCIH_LinkType | nombre entier non signé | 4 | |
| MQCIH_NextTransactionId | string | 4 | |
| MQCIH_OutputDataLength | nombre entier non signé | 4 | |
| MQCIH_Reason | nombre entier non signé | 4 | |
| MQCIH_ReplyToFormat | string | ||
| MQCIH_ReturnCode | nombre entier non signé | 4 | |
| MQCIH_StartCode | string | 4 | |
| MQCIH_TaskEndStatus | nombre entier non signé | 4 | |
| MQCIH_TransactionId | string | 4 | |
| MQCIH_UOWControl | nombre entier non signé | 4 | |
| MQIIH_Authenticator | string | 8 | Définissez sur le mot de passe d’authentification unique lorsque vous utilisez la propriété SSOAffiliateApplication . Note: Cette valeur est définie sur vide par l’adaptateur MQSeries si la longueur du mot de passe de l’authentification unique dépasse 8 caractères. |
| MQIIH_CommitMode | string | ||
| MQIIH_Flags | nombre entier non signé | 4 | |
| MQIIH_Format | string | ||
| MQIIH_LTermOverride | string | 8 | |
| MQIIH_MFSMapName | string | 8 | |
| MQIIH_ReplyToFormat | string | ||
| MQIIH_SecurityScope | string | ||
| MQIIH_TranInstanceId | string | 32 | Chaîne hexadécimale |
| MQIIH_TranState | string |
Voir aussi
Propriétés de l’adaptateur MQSeries
Propriétés associées à BizTalk Server
Conversion de types de données des propriétés