Propriétés de destination

Vous pouvez afficher et définir des propriétés de destination dans la boîte de dialogue de propriétés Destination. Les propriétés disponibles dans cette boîte de dialogue dépendent du type de destination.

Les tableaux ci-dessous répertorient toutes les propriétés que vous pouvez définir pour les destinations.

Pour chaque propriété, une brève description indique dans quel cas vous pourriez avoir à la configurer. Les tableaux fournissent également les noms longs et abrégés à utiliser avec l'outil CLI d'administration de JMS. Les propriétés disponibles dans la boîte de dialogue Propriétés dépendent du type de destination ; les destinations de file d'attente comportent des propriétés qui diffèrent de celles des destinations de rubrique. Pour plus d'informations, voir Configuration d'objets JMS à l'aide de l'outil d'administration dans l'IBM® Knowledge Center.

Page Général

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Général de la boîte de dialogue Propriétés de destination.

Tableau 1. . Propriétés de la page Général
Propriété Signification Nom long Nom abrégé
Nom Il s'agit du nom de l'objet. NAME  
Description Entrez une description de l'objet. DESCRIPTION DESC
Nom de classe Indique le nom de classe qui est implémenté par la destination.    
Fournisseur de messagerie Ceci indique le transport qui est pris en charge par l'objet de destination et qui peut être IBM MQ ou le transport en temps réel. Le transport en temps réel n'était pas disponible dans IBM MQ 8.0. Si vous utilisez IBM MQ 8.0, vous pouvez définir le transport en temps réel, mais il échoue lorsque vous tentez de créer une connexion.    
Gestionnaire de files d'attente Sélectionnez ou entrez le nom du gestionnaire de files d'attente qui héberge la file d'attente de destination. QMANAGER QMGR
File d'attente Sélectionnez le nom de la file d'attente représentée par la destination. QUEUE QU
Rubrique Entrez le nom de la rubrique que représente cette destination. TOPIC TOP

Page Traitement des messages

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Traitement des messages de la boîte de dialogue Propriétés de destination. Editez les propriétés dans la page Traitement des messages pour configurer le mode de traitement des messages envoyés à la destination.

Tableau 2. . Propriétés de la page Traitement des messages
Propriété Signification Nom long Nom abrégé
Expiration Indiquez le délai au terme duquel les messages reçus à la destination arrivent à expiration. Pour indiquer que le délai d'expiration peut être défini par l'application client JMS, cliquez sur Application. Pour indiquer l'absence de délai d'expiration, cliquez sur non limité. Sinon, entrez le délai d'expiration en millisecondes. EXPIRY EXP
Persistance Indiquez la persistance des messages envoyés à la destination. Pour indiquer que la persistance peut être définie par l'application client JMS, cliquez sur Application. Pour indiquer que la persistance prend la valeur par défaut de la file d'attente, cliquez sur Valeur par défaut de file d'attente. Pour indiquer que les messages sont persistants, cliquez sur Persistant. Sinon, cliquez sur Non persistant. Pour indiquer que les messages non persistants de la file d'attente ne sont pas supprimés lors du redémarrage du gestionnaire de files d'attente après une mise au repos ou un arrêt immédiat, cliquez sur Elevé (toutefois, les messages non persistants peuvent être supprimés suite à un arrêt préventif ou à un incident). PERSISTENCE PER
Priorité Indiquez la priorité des messages envoyés à la destination. Pour indiquer que la priorité peut être définie par l'application client JMS, cliquez sur Application. Pour indiquer que la priorité prend la valeur par défaut de la file d'attente, cliquez sur Valeur par défaut de file d'attente. Sinon, entrez la priorité, de 0 à 9. PRIORITY PRI
Contexte du message MQMD Indiquez le contexte lors de l'envoi de messages à une destination. Vous avez le choix entre trois options :

Par défaut : L'appel MQOPEN API et la structure MQPMO ne spécifient pas d'options de contexte de message explicites. Il s'agit de la valeur par défaut.

Définition de tous les contextes : L'appel MQOPEN API spécifie l'option de contexte de message MQOO_SET_ALL_CONTEXT et la structure MQPMO spécifie MQPMO_SET_ALL_CONTEXT.

Définition du contexte d'identité : L'appel MQOPEN API spécifie l'option de contexte de message MQOO_SET_IDENTITY_CONTEXT et la structure MQPMO spécifie MQPMO_SET_IDENTITY_CONTEXT.

MDMSGCTX MDCTX
Ecriture MQMD activée Indiquez si une application JMS peut définir les valeurs des zones MQMD. Vous avez le choix entre deux options :

Non : Toutes les propriétés JMS_IBM_MQMD* sont ignorées et leurs valeurs ne sont pas copiées dans la structure MQMD sous-jacente. Il s'agit de la valeur par défaut.

Oui : Toutes les propriétés JMS_IBM_MQMD* sont traitées. Leurs valeurs sont copiées dans la structure sous-jacente.
MDWRITE MDW
Lecture MQMD activée Indiquez si une application JMS peut extraire les valeurs des zones MQMD. Vous avez le choix entre deux options :

Non : Lors de l'envoi de messages, les propriétés JMS_IBM_MQMD* d'un message d'envoi ne sont pas mises à jour pour refléter les valeurs des zones mises à jour dans MQMD. Lors de la réception de messages, aucune des propriétés JMS_IBM_MQMD* n'est disponible sur un message reçu, même si l'émetteur les a définies partiellement ou intégralement. Il s'agit de la valeur par défaut.

Oui : Lors de l'envoi de messages, les propriétés JMS_IBM_MQMD* d'un message envoyé ne sont pas mises à jour pour refléter les valeurs des zones mises à jour dans MQMD, y compris les propriétés que l'expéditeur n'a pas définies explicitement. Lors de la réception de messages, toutes les propriétés JMS_IBM_MQMD* sont disponibles sur un message reçu, y compris celles que l'émetteur n'a pas définies de manière explicite.
MDREAD MDR
Corps du message Indiquez si une application JMS doit traiter l'en-tête MQRFH2 d'un message IBM MQ comme partie intégrante du corps du message JMS. Vous avez le choix entre trois options :

Non spécifié : Lors de l'envoi de messages, IBM MQ classes for JMS génère et inclut ou non un en-tête MQRFH2, suivant la valeur de WMQ_TARGET_CLIENT. Lors de la réception de messages, elles agissent comme si la valeur était JMS. Il s'agit de la valeur par défaut.

JMS : Lors de l'envoi de messages, IBM MQ classes for JMS génère automatiquement un en-tête MQRFH2 et l'inclut dans le message IBM MQ. Lors de la réception de messages, IBM MQ classes for JMS définit les propriétés des messages JMS en fonction des valeurs de l'en-tête MQRFH2 (s'il en existe un). Il ne présente pas l'en-tête MQRFH2 comme partie intégrante du corps du message JMS.

MQ : Lors de l'envoi de messages, IBM MQ classes for JMS ne génère pas d'en-tête MQRFH2. Lors de la réception de messages, IBM MQ classes for JMS présente l'en-tête MQRFH2 comme partie intégrante du corps du message JMS.

MSGBODY MBODY
Conversion de réception Configure l'utilisation de l'option MQGMO_CONVERT. Lors de la demande de messages, sélectionne si la conversion doit être effectuée dans le gestionnaire de files d'attente en spécifiant MQGMO_CONVERT sur MQGET ou dans l'application client. RECEIVECONVERSION RCNV
CCSID de réception CCSID demandé pour convertir le message. Utilisé lorsque IBM MQ classes for JMS demande au gestionnaire de files d'attente d'effectuer une conversion (par exemple en spécifiant WMQ_RECEIVE_CONVERSION_QMGR comme argument de setReceiveConversion). La valeur de cette propriété est le CCSID dans lequel le gestionnaire de files d'attente doit convertir le message. La valeur par défaut est CCSID 1208. RECEIVECCSID RCCS

Page Courtier

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Courtier de la boîte de dialogue Propriétés de destination. Editez les propriétés de la page Courtier pour fournir des détails sur le courtier de publication/abonnement.

Tableau 3. . Propriétés de la page Courtier
Propriété Signification Nom long Nom abrégé
File d'attente d'abonnement durable à un courtier Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Si le gestionnaire de files d'attente auquel se connecte le client JMS est celui utilisé par le courtier d'abonnement et de publications, vous pouvez sélectionner une file d'attente à partir du gestionnaire de files d'attente du courtier. Le gestionnaire sélectionné doit être en cours d'exécution.

Sinon, vous devez entrer le nom de la file d'attente à partir de laquelle les messages d'abonnement durable sont extraits. La file d'attente par défaut est SYSTEM.JMS.D.SUBSCRIBER.QUEUE.
BROKERDURSUBQ BDSUB
File d'attente de messages d'abonnement durable d'un client de connexion à un courtier Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Si le gestionnaire de files d'attente auquel se connecte le client JMS est celui utilisé par le courtier d'abonnement et de publications, vous pouvez sélectionner une file d'attente à partir du gestionnaire de files d'attente du courtier. Le gestionnaire sélectionné doit être en cours d'exécution.

Sinon, vous devez entrer le nom de la file d'attente à partir de laquelle les messages d'abonnement durable sont extraits pour un client de connexion (ConnectionConsumer). La file d'attente par défaut est SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.
BROKERCCDURSUBQ CCDSUB
Flot de publication Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez ou entrez le nom de la file d'attente dans laquelle les messages publiés sont envoyés (file d'attente de flot). La file d'attente par défaut est SYSTEM.BROKER.DEFAULT.STREAM. Pour entrer ce nom à l'aide du bouton de sélection, vous devez avoir attribué une valeur à la propriété Gestionnaire de files d'attente de publication du courtier et le gestionnaire de files d'attente sélectionné doit être en cours de fonctionnement.

BROKERPUBQ BPUB
Gestionnaire de files d'attente de publication du courtier Sélectionnez ou entrez le nom du gestionnaire de files d'attente propriétaire de la file d'attente dans laquelle les messages publiés sur la rubrique sont envoyés. BROKERPUBQMGR BPQM
Version Courtier Vous pouvez utiliser cette propriété dans un client JMS IBM WebSphere MQ 7.0 ou version ultérieure, mais elle n'a aucun impact sur les gestionnaires de files d'attente IBM WebSphere MQ 7.0 ou version ultérieure.

Sélectionnez la version du courtier utilisé. Cliquez sur V1 pour utiliser un courtier de publication/abonnement IBM MQ ou IBM Integration Bus en mode compatibilité. Il s'agit de la valeur par défaut si la propriété Transport a pour valeur Liaisons ou Client. Cliquez sur V2 pour utiliser un courtier de IBM Integration Bus en mode natif ; il s'agit de la valeur par défaut si la propriété Transport a pour valeur Direct ou DirectHTTP.

BROKERVER BVER

Page Expéditeurs

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Expéditeurs de la boîte de dialogue Propriétés de destination. Editez les propriétés de la page Expéditeurs pour modifier d'autres propriétés de l'objet destination.

Tableau 4. . Propriétés de la page Expéditeurs
Propriété Signification Nom long Nom abrégé
Autoriser les insertions asynchrones Indiquez si les expéditeurs de message sont autorisés à utiliser les insertions asynchrones pour envoyer des messages à cette destination. Pour déterminer s'ils le sont conformément à la définition de rubrique ou de file d'attente, cliquez sur Comme destination (valeur par défaut). Pour autoriser les insertions asynchrones, cliquez sur Activé ; pour les interdire, cliquez sur Désactivé. PUTASYNCALLOWED PAA

Page Consommateurs

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Consommateurs de la boîte de dialogue Propriétés de destination. Editez les propriétés de la page Consommateurs pour modifier d'autres propriétés de l'objet destination.

Tableau 5. . Propriétés de la page Consommateurs
Propriété Signification Nom long Nom abrégé
Autoriser la lecture anticipée Indiquez si les consommateurs de message et les navigateurs de files d'attente sont autorisés à effectuer une lecture anticipée pour récupérer les messages non persistants de cette destination dans la mémoire tampon du client avant de les recevoir. Pour déterminer si la lecture anticipée est autorisée conformément à la définition de rubrique ou de file d'attente, cliquez sur Comme destination (valeur par défaut). Pour autoriser la lecture anticipée, cliquez sur Activé(e) ; pour l'interdire, cliquez sur Désactivé(e). READAHEADALLOWED RAA
Règles de fermeture de la lecture anticipée Pour les messages distribués à un programme d'écoute asynchrone, indiquez ce que doivent devenir les messages qui se trouvent sur la file d'attente du proxy du client lorsque le consommateur de message est fermé. Pour indiquer que tous les messages de la file d'attente du proxy client soient remis au programme d'écoute des messages (MessageListener) de l'application avant d'être renvoyés, cliquez sur Distribution de toutes les règles (valeur par défaut). Pour que l'appel du programme d'écoute de messages actuel s'arrête simplement avant le renvoi (en ignorant éventuellement d'autres messages sur la file d'attente du proxy client), cliquez sur Distribution des règles actuelles. READAHEADCLOSEPOLICY RACP
Format des caractères génériques Indiquez la version de syntaxe des caractères génériques à utiliser.

Cliquez sur Caractères génériques uniquement pour utiliser exclusivement des caractères génériques (pour la cohérence avec les applications qui utilisaient précédemment la version 1 du courtier, voir la propriété Version Courtier).

Cliquez sur Rubriques génériques uniquement pour utiliser les caractères génériques uniquement au niveau des rubriques, ce qui est le cas pour la version 2 du courtier.
WILDCARDFORMAT WCFMT

Page Etendu

Le tableau ci-dessous répertorie les propriétés que vous pouvez définir dans la page Etendu de la boîte de dialogue Propriétés de destination. Editez les propriétés de la page Etendu pour modifier d'autres propriétés de l'objet destination.

Tableau 6. . Propriétés de la page Etendu
Propriété Signification Nom long Nom abrégé
ID de jeu de caractères codés (CCSID) Entrez l'identificateur de jeu de caractères codés (CCSID) à utiliser pour les destinations. CCSID CCS
Codage Sélectionnez le schéma de codage utilisé pour la destination. Pour plus d'informations, voir Configuration d'objets JMS à l'aide de l'outil d'administration dans l'IBM Knowledge Center. ENCODING ENC
Echec en cas de mise au repos Indiquez si les appels à certaines méthodes doivent échouer si le gestionnaire de files d'attente est au repos. Pour indiquer l'échec des appels à certaines méthodes en cas de mise au repos du gestionnaire de files d'attente, cliquez sur Oui. Cela signifie que si une application détecte la mise au repos du gestionnaire de files d'attente, elle peut terminer la tâche immédiate qu'elle effectue puis fermer la connexion, permettant ainsi l'arrêt du gestionnaire de files d'attente. .Pour indiquer que la mise au repos du gestionnaire de files d'attente ne provoque l'échec d'aucun appel de méthode, cliquez sur Non. Cela signifie qu'une application ne peut pas détecter la mise au repos du gestionnaire de files d'attente et qu'elle continue par conséquent à effectuer des opérations sur celui-ci, et donc empêche son arrêt. FAILIFQUIESCE FIQ
Multidiffusion Indiquez si les messages sont distribués aux clients de message (MessageConsumer) en mode multidiffusion. Le transport en mode multidiffusion s'applique uniquement aux destinations de rubrique et ne peut être utilisé que lorsque la fabrique de connexions utilise le transport Direct IP. Le transport IP direct n'était pas disponible dans IBM MQ 8.0. Si vous utilisez IBM MQ 8.0, vous pouvez définir le transport IP direct, mais il échoue lorsque vous tentez de créer une connexion.

La valeur par défaut est Comme la fabrique de connexions, ce qui signifie que la valeur de la propriété Multidiffusion de la fabrique de connexions est utilisée.

Cliquez sur Activé pour distribuer les messages aux clients de message en mode multidiffusion. La rubrique doit être configurée pour le mode multidiffusion fiable dans le courtier. Cette configuration utilise également une qualité de service fiable.

MULTICAST MCAST
Multidiffusion (continue)

Cliquez sur Fiable pour distribuer des messages aux clients de message en mode multidiffusion avec une qualité de service fiable. La rubrique doit être configurée pour le mode multidiffusion fiable dans le courtier. Si elle ne l'est pas, vous ne pouvez pas créer de client de message pour cette rubrique.

Cliquez sur Non fiable pour distribuer des messages en mode multidiffusion mais sans qualité de service fiable. La rubrique doit être configurée pour le mode multidiffusion dans le courtier. La qualité de service fiable n'est pas utilisée, même si la rubrique est configurée pour le mode multidiffusion fiable.
MULTICAST MCAST
Client cible

Pour indiquer que la cible du message est une application JMS, cliquez sur JMS.

Cliquez sur MQ pour indiquer que la cible du message est une application IBM MQ non-JMS.

TARGCLIENT TC
Style de destination ReplyTo

Spécifiez le format de la zone JMSReplyTo.

Cliquez sur Par défaut pour utiliser la valeur par défaut. Cette dernière correspond aux informations de RFH2 à moins que la propriété système JVM ne soit définie.

Cliquez sur MQMD pour utiliser la valeur fournie dans le MQMD. Vous remplissez ainsi la zone de gestionnaire de files d'attente avec la valeur provenant du MQMD.

Pour utiliser la valeur fournie dans l'en-tête RFH2, cliquez sur RFH2. Si l'application émettrice définit une valeur JMSReplyTo, cette dernière est utilisée.

REPLYTOSTYLE RTOST
Conversion de réception Configure l'utilisation de l'option MQGMO_CONVERT. Lors de la demande de messages, sélectionne si la conversion doit être effectuée dans le gestionnaire de files d'attente en spécifiant MQGMO_CONVERT sur MQGET ou dans l'application client. RECEIVECONVERSION RCNV
CCSID de réception CCSID demandé pour la conversion du message. Utilisé lorsque IBM MQ classes for JMS demande au gestionnaire de files d'attente d'effectuer une conversion (par exemple en spécifiant WMQ_RECEIVE_CONVERSION_QMGR comme argument de setReceiveConversion). La valeur de cette propriété est le CCSID dans lequel le gestionnaire de files d'attente doit convertir le message. La valeur par défaut est CCSID 1208. RECEIVECCSID RCCS