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.
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.
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.
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é |
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 |
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.
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.
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.
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 |