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 :

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

Le tableau ci-dessous répertorie les propriétés figurant dans la page Propriétés des messages de la boîte de dialogue Propriétés des messages. Il existe deux manières de rendre la page Propriétés MQRFH2 visible :
  • 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.

Pour plus d'informations sur la boîte de dialogue Préférences, voir Configuration de MQ Explorer.

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