Propriétés de message
Les propriétés de message sont affichées dans la boîte de dialogue Propriétés des messages. Vous ne pouvez pas les éditer.
Les tableaux ci-dessous répertorient les propriétés des messages IBM® MQ que vous pouvez placer dans des files d'attente et extraire :
- Général
- Rapport
- Contexte
- Identificateurs
- Segmentation
- Propriétés nommées
- Propriétés MQRFH2
- Données
- En-tête de non-distribution
Pour chaque propriété, une brève description indique sa signification. Le tableau contient également la forme MQMD du nom sous laquelle il apparaît dans l'API. MQMD est décrit dans Présentation de MQMD dans l'IBM Knowledge Center.
Page Général
Le tableau ci-dessous répertorie les propriétés figurant dans la page Général de la boîte de dialogue Propriétés des messages.
Propriété | Signification | Forme MQMD |
---|---|---|
Position | Lecture seule. Position en cours du message dans la file d'attente. | (Non applicable) |
Type de message | Lecture seule. Indique le type du message :
Datagramme signifie que le message ne
requiert pas de réponse ;
Demande indique que le message
requiert une réponse ; Réponse
signifie que le message est une réponse à un message
de demande précédent ; Rapport indique
que le message fournit des informations sur des
événements, attendus ou non, généralement liés à un
autre message. Par exemple, il peut s'agir d'un message
contenant des données incorrectes. |
MsgType |
Priorité | Lecture seule. Indique la priorité du message. La priorité la plus faible est 0. | Priority |
Persistance | Lecture seule. Indique si le message est persistant ou non. Si le message est persistant, cela signifie qu'il n'est pas affecté par les pannes et les reprises système du gestionnaire de files d'attente. Si le message n'est pas persistant, cela signifie qu'il survit à un redémarrage uniquement s'il est présent dans une file d'attente contenant la propriété NPMCLASS(HIGH). Cependant, même avec la propriété NPMCLASS (HIGH), un message ne survit pas à une classe QMGR. Les messages non persistants dans les files d'attente possédant la propriété NPMCLASS(NORMAL) sont ignorés au redémarrage du gestionnaire de files d'attente, même si le message se trouve dans la mémoire secondaire lors de la procédure de redémarrage. | Persistence |
Date et heure d'insertion | Lecture seule. Il s'agit de la date à laquelle le message a été inséré. | PutDate; PutTime |
Expiration | Lecture seule. Il s'agit du délai, en dixièmes de seconde, au-delà duquel le message peut être supprimé s'il n'a pas été extrait de la file d'attente cible. L'intervalle d'expiration est défini par l'application qui insère le message. | Expiry |
File de réponses | Lecture seule. Cet attribut représente le nom de la file d'attente de messages à laquelle l'application qui a envoyé la demande d'extraction du message doit envoyer les messages de réponse et de rapport. | ReplyToQ |
Gestionnaire de file de réponses | Lecture seule. Il s'agit du nom du gestionnaire de files d'attente sur lequel est définie la file d'attente de réponses. | ReplyToQmgr |
Nombre d'annulations | Lecture seule. Il s'agit du nombre de fois où le message a été renvoyé par un appel MQGET dans le cadre d'une unité d'oeuvre, puis annulé. | BackoutCount |
Page Rapport
Le tableau ci-dessous répertorie les propriétés figurant dans la page Rapport de la boîte de dialogue Propriétés des messages. Un rapport est un message fournissant des informations sur un autre message pour signaler à l'application des événements, attendus ou non, concernant le message d'origine. La page Rapport contient les propriétés relatives aux messages de rapport. Pour plus d'informations, voir Options de rapport et indicateurs de message dans l'IBM Knowledge Center.
Propriété | Signification | Forme MQMD |
---|---|---|
Report | Lecture seule. Dans cette zone, l'application émettrice indique si des messages de rapport sont requis, si les données applicatives doivent être incluses dans les messages de rapport et également le mode de définition des identificateurs de message et de corrélation dans le message de rapport ou de réponse. | Report |
Commentaires en retour | Lecture seule. Uniquement utilisé avec des messages de rapport pour indiquer la nature du rapport. | Feedback |
Longueur d'origine | Lecture seule. Uniquement utilisé avec des messages de rapport pour indiquer la longueur du message d'origine auquel est associé le rapport. | OriginalLength |
Page Contexte
Le tableau ci-dessous répertorie les propriétés figurant dans la page Contexte de la boîte de dialogue Propriétés des messages. La page Contexte affiche les informations sur le message et provenant de l'application émettrice.
Propriété | Signification | Forme MQMD |
---|---|---|
ID utilisateur | Lecture seule. Il s'agit de l'identificateur utilisateur de l'application ayant créé le message. | UserIdentifier |
Type d'application | Lecture seule. Il s'agit du type d'application ayant inséré le message, par exemple, CICS ou AIX. | PutApplType |
Nom de l'application d'insertion | Lecture seule. Cet attribut indique le nom de l'application ayant inséré le message dans la file d'attente. Ce nom peut apparaître tronqué. | PutApplName |
Données sur l'identité de l'application | Lecture seule. Il s'agit des informations définies par la suite applicative qui permettent d'identifier le message ou son auteur. | ApplIdentityData |
Données sur l'origine de l'application | Lecture seule. Il s'agit des informations définies par la suite applicative qui fournissent des renseignements complémentaires sur l'origine du message. | ApplOriginData |
Jeton de comptabilité | Lecture seule. Il s'agit des informations permettant à l'application de procéder de façon appropriée à l'imputation comptable d'une tâche effectuée suite au message. | AccountingToken |
Page ID
Le tableau ci-dessous répertorie les propriétés figurant dans la page Identificateurs de la boîte de dialogue Propriétés des messages. La page ID affiche les informations d'identification associées au message.
Propriété | Signification | Forme MQMD |
---|---|---|
Identificateur de message | Lecture seule. Il s'agit de l'identificateur de message utilisé pour distinguer un message d'un autre. | MsgId |
Octets de l'identificateur de message | Lecture seule. Il s'agit de l'identificateur de message sous forme d'octets. | MsgId |
Identificateur de corrélation | Lecture seule. Il s'agit de l'identificateur de corrélation qui peut être utilisé par l'application pour relier un message à un autre, ou pour relier un message à une autre tâche que l'application exécute. | CorrelId |
Octets de l'identificateur de corrélation | Lecture seule. Il s'agit de l'identificateur de corrélation sous forme d'octets. | CorrelId |
Identificateur de groupe | Lecture seule. Il s'agit de l'identificateur de groupe permettant d'identifier le groupe de messages ou le message logique auquel appartient le message physique. | GroupId |
Octets de l'identificateur de groupe | Lecture seule. Il s'agit de l'identificateur de groupe sous forme d'octets. | GroupId |
Page Segmentation
Le tableau ci-dessous répertorie les propriétés figurant dans la page Segmentation de la boîte de dialogue Propriétés des messages. La page Segmentation contient les propriétés relatives à la segmentation des messages volumineux.
Propriété | Signification | Forme MQMD |
---|---|---|
Numéro de séquence logique | Lecture seule. Il s'agit du numéro de séquence du message logique dans le groupe. Les numéros de séquence commencent à 1 et augmentent de 1 à chaque insertion d'un message logique dans le groupe, le nombre maximal étant 999 999 999. Un message physique ne se trouvant pas dans un groupe possède le numéro de séquence 1. | MsgSeqNumber |
Offset | Lecture seule. Il s'agit du décalage entre le début du message logique et celui du message physique. | Offset |
Indicateurs | Lecture seule. Ces indicateurs définissent les propriétés des messages ou contrôlent leur traitement. | MsgFlags |
Page Propriétés nommées
Le tableau ci-dessous répertorie les propriétés figurant dans la page Propriétés nommées de la boîte de dialogue Propriétés des messages. La page Propriétés nommées n'est présente que si vous avez sélectionné l'option comme propriétés nommées dans la page Propriétés de message de la boîte de dialogue Préférences et que le message sélectionné comporte des propriétés. Les propriétés du message, sauf celles stockées dans l'extension ou le descripteur de message, doivent être représentées dans le panneau Propriétés nommées sous forme de paires nom valeur. Les propriétés sont supprimées des données du message.
L'option MQGMO correspond à MQGMO_PROPERTIES_IN_HANDLE. Pour plus d'informations sur les options d'extraction de message, voir Options MQ d'extraction de messages.Pour plus d'informations sur la boîte de dialogue Préférences, voir Configuration de MQ Explorer.
Propriété | Signification |
---|---|
Nom | Lecture seule. Nom de la propriété de message. |
Valeur | Lecture seule. Il s'agit de la valeur réelle de la propriété nommée. |
Page Propriétés MQRFH2
- Sélectionnez comme structure MQRFH2 dans le corps du message dans la
page Messages de la boîte de dialogue Préférences.
Les propriétés du message, sauf celles stockées dans l'extension ou le descripteur de message, doivent être représentées dans le panneau Propriétés MQRFH2. Les propriétés sont conservées dans les données du message. L'option MQGMO correspond à MQGMO_PROPERTIES_FORCE_MQRFH2. Pour plus d'informations sur les options d'extraction de message, voir Options MQ d'extraction de messages.
- Sélectionnez comme structure MQRFH2 dans le corps du message, compatible avec WebSphere MQ V6 dans la page Messages de la boîte de dialogue Préférences. La page Propriétés MQRFH2 n'est visible que si le message contient une propriété ayant pour préfixe mcd, jms, usr ou mqext
Si le message contient une propriété dotée du préfixe mcd, jms, usr ou mqext, toutes les propriétés du message, sauf celles stockées dans l'extension ou le descripteur de message, doivent être représentées dans le panneau Propriétés MQRFH2. Les propriétés sont conservées dans les données du message. Sinon, toutes les propriétés du message, sauf celles stockées dans l'extension ou le descripteur de message, sont supprimées et n'apparaissent pas à l'écran. L'option MQGMO correspond à MQGMO_PROPERTIES_IN_COMPATIBILITY. Pour plus d'informations sur les options d'extraction de message, voir Options MQ d'extraction de messages.
Comme la structure MQRFH2 est constituée de xml imbriqué, la page Propriétés MQRFH2 affiche les propriétés MQRFH2 sous la forme d'une arborescence. Toutes les propriétés ayant le même synonyme sont regroupées sous l'arborescence de synonymes, qui peut être développée pour afficher toutes les propriétés ou réduite pour masquer toutes les propriétés.
Propriété | Signification |
---|---|
Nom | Lecture seule. Nom de la propriété de message. |
Valeur | Lecture seule. Il s'agit de la valeur réelle de la propriété nommée. |
Page Données
Le tableau ci-dessous répertorie les propriétés figurant dans la page Données de la boîte de dialogue Propriétés des messages. La page Données contient les données du message même et des informations sur leur format.
Propriété | Signification | Forme MQMD |
---|---|---|
Longueur des données | Lecture seule. Il s'agit de la longueur du message d'origine. | OriginalLength |
Format | Lecture seule. Il s'agit du nom que l'émetteur du message a utilisé pour indiquer au récepteur la nature des données du message. | Format |
Identificateur de jeu de caractères codés | Lecture seule. Il s'agit du CCSID des caractères figurant dans les données de message d'application. | CodedCharSetId |
Codage | Lecture seule. Cet attribut spécifie le codage numérique des données numériques du message. Cette valeur ne s'applique pas aux données numériques de la structure MQMD elle-même. | Encoding |
Données de message | Lecture seule. Il s'agit des données de message sous forme de texte ASCII lisible. | (Non applicable) |
Octets des données de message | Lecture seule. Il s'agit des données de message au format hexadécimal. | (Non applicable) |
Page En-tête de non-distribution
Le tableau ci-dessous répertorie les propriétés figurant dans la page En-tête de non-distribution de la boîte de dialogue Propriétés des messages. La page En-tête de non-distribution est présente uniquement lorsque le message comporte un en-tête de non-distribution.
Propriété | Signification | Forme MQMD |
---|---|---|
Raison | Cet attribut identifie la raison pour laquelle le message a été placé dans la file d'attente de rebut (message non transmis) plutôt que dans la file d'attente de destination. | Reason |
File d'attente de destination | Nom de la file d'attente de messages qui était la destination d'origine du message. | DestQName |
Gestionnaire de files d'attente de destination | Nom du gestionnaire de files d'attente qui était la destination d'origine du message. | DestQMgrName |
Codage d'origine | Cet attribut spécifie le codage numérique des données qui suivent la structure MQDLH ; il s'agit généralement des données du message d'origine. Il ne s'applique pas aux données numériques de la structure MQDLH elle-même. | Encoding |
CCSID d'origine | Cet attribut spécifie l'identificateur de jeu de caractères des données qui suivent la structure MQDLH ; il s'agit généralement des données du message d'origine. Il ne s'applique pas aux caractères de la structure MQDLH elle-même. | CodedCharSetId |
Format d'origine | Cet attribut spécifie le nom de format des données qui suivent la structure MQDLH ; il s'agit généralement des données du message d'origine. | Format |
Type d'application d'insertion | Type de l'application ayant placé le message en file d'attente. Cet attribut fait partie des informations relatives au contexte d'origine du message. Pour plus d'informations sur le contexte de message, voir Contexte de message dans l'IBM Knowledge Center. | PutApplType |
Nom de l'application d'insertion | Cet attribut indique le nom de l'application ayant
inséré le message dans la file d'attente de rebut. Le format du nom dépend de la
propriété Type d'application d'insertion . Ce nom peut apparaître tronqué. |
PutApplName |
Date d'insertion | Date à laquelle le message a été inséré dans la file d'attente de rebut. | PutDate |
Heure d'insertion | Heure à laquelle le message a été inséré dans la file d'attente de rebut. | PutTime |