Paramètres des propriétés avancées de rubrique et de file d'attente pour le fournisseur de messagerie IBM MQ

Ce panneau vous permet d'afficher ou de modifier les propriétés avancées d'une destination de rubrique ou de file d'attente sélectionnée à utiliser avec le fournisseur de messagerie IBM MQ. Ces propriétés avancées contrôlent le comportement des connexions établies vers des destinations du fournisseur de messagerie IBM MQ.

Pour afficher les paramètres des propriétés avancées de rubrique ou de file d'attente IBM MQ, effectuez les étapes suivantes à l'aide de la console d'administration :

Dans le panneau de navigation, cliquez sur Ressources > JMS
Cliquez sur Files d'attente ou Rubriques pour afficher les destinations de rubrique ou pour une file d'attente.
Si approprié, dans le panneau de contenu, modifiez le paramètre de la Portée au niveau défini pour les destinations de rubrique ou de file d'attente. Il restreint l'affichage des destinations de file d'attente ou de rubrique.
Cliquez sur le nom de la destination de rubrique ou de file d'attente à utiliser.
Dans le panneau de contenu, sous Propriétés supplémentaires, cliquez sur Propriétés avancées pour afficher la liste des propriétés avancées de la destination de rubrique ou de file d'attente IBM MQ.

Il existe cinq groupes de propriétés sous Propriétés générales :

Distribution
Format de message
Optimisations
Descripteur de message
Eléments supplémentaires

Effectuez les modifications nécessaires pour ces groupes, puis cliquez sur Appliquer pour revenir à la file d'attente ou à la rubrique.

Remarque : Lorsque vous spécifiez des propriétés IBM MQ, les limitations suivantes s'appliquent :

Les noms peuvent comporter jusqu'à 48 caractères, à l'exception des canaux, qui ne peuvent pas en comporter plus de 20.
Les valeurs de propriétés que vous spécifiez doivent correspondre aux valeurs que vous avez indiquées lors de la configuration des ressources JMS pour IBM MQ. Pour plus d'informations sur la configuration des ressources JMS pour IBM MQ, voir la section Using Java du centre de documentation IBM MQ.

La file d'attente ou rubrique à utiliser avec le fournisseur de messagerie JMS de IBM MQ possède les propriétés avancées suivantes :

Persistance

Niveau de persistance utilisé pour stocker les messages envoyés à cette destination.

Informations

Valeur

Type de données

Liste déroulante

Valeur par défaut

Comme définie par l'application

Plage de valeurs

Comme définie par l'application: La persistance pour les messages de cette destination est définie par l'application qui les place dans la file.
Selon la définition de file d'attente IBM MQ: La persistance des messages de cette destination est définie par les propriétés de définition de la file d'attente IBM MQ.
IBM MQ Persistant: Les messages de la destination sont persistants.
IBM MQ Non persistant: Les messages de la destination ne sont pas persistants.

IBM MQHigh: Vous permet d'envoyer des messages persistants comme non persistants lors de l'utilisation d'une file d'attente sous-jacente IBM MQ avec la valeur 'HIGH' affectée à NPMCLASS.

Priorité

Priorité affectée aux messages envoyés à cette destination.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	Comme définie par l'application
Plage de valeurs	Comme définie par l'application La priorité des messages de cette destination est définie par l'application qui les place sur la destination. Selon la définition de file d'attente IBM MQ La persistance des messages de cette destination est définie par les propriétés de définition de destination IBM MQ. Spécifié La priorité des messages de cette destination est définie par la propriété Priorité spécifiée. Si vous sélectionnez cette option, vous devez indiquer une priorité sur la propriété Priorité spécifiée.

Priorité spécifiée

Lorsque la propriété Priorité correspond à Spécifiée, sélectionnez la priorité affectée aux messages envoyés à cette destination de type file d'attente.

Informations	Valeur
Type de données	Liste déroulante
Unités	Niveau de priorité du message
Valeur par défaut	Comme définie par l'application
Plage de valeurs	0 (la plus faible) à 9 (la plus élevée)

Expiration

Option qui spécifie le délai d'expiration de cette destination.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	Comme définie par l'application
Plage de valeurs	Comme définie par l'application Le délai d'expiration des messages de cette destination est défini par l'application qui les place sur la destination. Spécifié Le délai d'expiration des messages dans cette destination est défini par la propriété Expiration spécifiée. Si vous sélectionnez cette option, vous devez définir un délai d'expiration en renseignant la zone Expiration spécifiée. Illimité Les messages sur cette destination n'ont pas de délai d'expiration, par conséquent les messages ne sont jamais supprimés.

Expiration spécifiée

Si la propriété d'Expiration a pour valeur Spécifiée, saisissez le délai en millisecondes (supérieur à 0) à l'échéance duquel les messages expirent et sont supprimés de cette destination.

Informations	Valeur
Type de données	Entier
Unités	Millisecondes
Valeur par défaut	0
Plage de valeurs	Supérieure ou égale à 0 0 indique que les messages n'arrivent pas à expiration Les autres valeurs sont des entiers représentant des millisecondes

ID de jeu de caractères codés

Jeu de caractères à utiliser lors de l'encodage des chaînes du message.

Informations	Valeur
Type de données	Entier
Valeur par défaut	1208
Plage de valeurs	1 à 65535. L'ID de jeu de caractères codés doit correspondre à l'une des valeurs prises en charge par IBM MQ. Vide. Si vous ne renseignez pas cette zone, vous indiquez que la valeur par défaut doit être utilisée.

Pour plus d'informations sur les CCSID pris en charge et sur la conversion des données de message d'un jeu de caractères codés vers un autre, voir les sections System Administration Guide et Application Programming Reference du centre de documentation IBM MQ.

Utiliser le codage natif

Option qui indique si la destination doit utiliser le codage natif pour fournir les valeurs de codage appropriées de la plateforme Java.

Informations	Valeur
Type de données	Case à cocher
Valeur par défaut	Elément sélectionné
Plage de valeurs	Elément sélectionné Le codage natif est utilisé. Elément non sélectionné Le codage natif n'est pas utilisé ; par conséquent, vous devez spécifier les propriétés pour le codage d'entier, le codage de décimale et le codage des nombres en virgule flottante.

Codage des entiers

Si la case Utilisation des encodages natifs est désélectionnée, sélectionnez le type d'encodage d'entier à utiliser.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	Normal
Options	Normal Le codage d'entiers normal est utilisé. Inversé Le codage d'entiers inversé est utilisé.

Codage décimal

Si la case Utilisation des encodages natifs est désélectionnée, sélectionnez le type de codage de décimal à utiliser.

Informations	Valeur
Type de données	Liste déroulante
Unités	Non applicable
Valeur par défaut	Normal
Plage de valeurs	Normal Le codage décimal normal est utilisé. Inversé Le codage décimal inversé est utilisé.

Codage de virgule flottante

Si la case Utilisation des encodages natifs est désélectionnée, sélectionnez le type de codage de virgule flottante à utiliser.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	IEEENORMAL
Plage de valeurs	IEEENORMAL Le codage de virgule flottante normal IEEE est utilisé. IEEEREVERSED Le codage de virgule flottante inversé IEEE est utilisé. z/OS Le codage de virgule flottante z/OS est utilisé.

Ajout des en-têtes RFH version 2 aux messages envoyés à cette destination

Action à appliquer lors de la réponse à un message envoyé à cette destination.

Informations	Valeur
Type de données	Case à cocher
Valeur par défaut	Elément sélectionné
Plage de valeurs	Elément non sélectionné N'ajoutez pas des en-têtes RFH version 2 aux messages envoyés à cette destination Elément sélectionné Ajoutez des en-têtes RFH version 2 aux messages envoyés à cette destination

Corps du message

Indique si une application traite l'en-tête 2 de la version RFH d'un message IBM MQ comme faisant partie du corps du message JMS.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	UNSPECIFIED
Plage de valeurs	UNSPECIFIED Lors de l'envoi de messages, le fournisseur de messagerie IBM MQ génère ou non et inclut un en-tête RFH version 2, en fonction de la valeur de la propriété Ajouter des en-têtes RFH version 2 aux messages envoyés à cette destination. Lors de la réception de messages, le fournisseur de messagerie IBM MQ agit comme si la valeur de la propriété était JMS. JMS Lors de l'envoi de messages, le fournisseur de messagerie IBM MQ génère automatiquement un en-tête RFH version 2 qu'il inclut dans le message IBM MQ. Lors de la réception de messages, le fournisseur de messagerie IBM MQ définit les propriétés de message JMS en fonction des valeurs éventuellement présentes dans l'en-tête RFH version 2 ; il ne présente pas l'en-tête RFH version 2 comme faisant partie du corps du message JMS. MQ Lors de l'envoi de messages, le fournisseur de messagerie IBM MQ ne génère pas d'en-tête RFH. Lors de la réception de messages, le fournisseur de messagerie IBM MQ présente l'en-tête RFH version 2 comme faisant partie du corps du message JMS.

Style de destination ReplyTo

Indique le format de la zone JMSReplyTo.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	DEFAULT
Plage de valeurs	DEFAULT La valeur par défaut correspond aux informations contenues dans l'en-tête RFH version 2. MQMD Utilisez la valeur fournie dans la MQMD. La réponse est indiquée dans la zone du gestionnaire de files d'attente avec la valeur provenant de la MQMD ; cela correspond au comportement par défaut de IBM MQ versions 6.0.2.4 et 6.0.2.5. RFH2 Utilisez la valeur fournie dans l'en-tête RFH version 2. Si l'application émettrice définit une valeur JMSReplyTo, cette valeur est utilisée.

Messages envoyés en mode asynchrone à ce gestionnaire de files d'attente

Option permettant au gestionnaire de files d'attente d'accuser réception des messages qui lui sont envoyés. L'envoi de messages en mode asynchrone au gestionnaire de files d'attente est plus rapide, mais les messages peuvent être perdus si l'infrastructure de messagerie rencontre une erreur.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	La valeur par défaut est différente selon que vous utilisez une destination de rubrique ou de file d'attente. Selon la définition de file d'attente Valeur par défaut lorsque vous utilisez une destination de file d'attente. Selon la définition de rubrique Valeur par défaut lorsque vous utilisez une destination de rubrique.
Plage de valeurs	Selon la définition de file d'attente Un accusé de réception est émis pour les messages en fonction des propriétés de définition de file d'attente IBM MQ. Selon la définition de rubrique Un accusé de réception est émis pour les messages en fonction des propriétés de définition de rubrique IBM MQ. Non Le gestionnaire de files d'attente accuse réception des messages qui lui sont envoyés. Oui Les messages sont envoyés de manière asynchrone au gestionnaire de files d'attente ; celui-ci n'accuse pas réception des messages.

Messages non persistants avec lecture anticipée et cache pour des clients

Option qui détermine si, théoriquement, les messages à destination des consommateurs non persistants sont envoyés aux clients. Si vous sélectionnez cette option, les messages sont distribués plus rapidement, mais peuvent être perdus en cas de défaillance de l'infrastructure de messagerie.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	La valeur par défaut est différente selon que vous utilisez une destination de rubrique ou de file d'attente. Selon la définition de file d'attente C'est la valeur par défaut lorsque vous utilisez une destination de file d'attente. Selon la définition de rubrique C'est la valeur par défaut lorsque vous utilisez une destination de rubrique.
Plage de valeurs	Selon la définition de file d'attente Les messages sont envoyés au client en fonction des propriétés de définition de file d'attente IBM MQ. Selon la définition de rubrique Les messages sont envoyés au client en fonction des propriétés de définition de rubrique IBM MQ. Oui Les messages sont théoriquement envoyés au client. Non Les messages ne sont théoriquement pas envoyés au client.

Style de destination ReplyTo

Indique le format de la zone JMSReplyTo.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	DEFAULT
Plage de valeurs	DEFAULT La valeur par défaut correspond aux informations contenues dans l'en-tête RFH version 2. MQMD Utilisez la valeur fournie dans la MQMD. La réponse est indiquée dans la zone du gestionnaire de files d'attente avec la valeur provenant de la MQMD ; cela correspond au comportement par défaut de IBM MQ versions 6.0.2.4 et 6.0.2.5. RFH2 Utilisez la valeur fournie dans l'en-tête RFH version 2. Si l'application émettrice définit une valeur JMSReplyTo, cette valeur est utilisée.

Pour plus d'informations sur la reconnexion client automatique, voir le centre de documentation IBM MQ.

Lecture anticipée de la méthode de clôture du consommateur

Cette propriété est activée si la valeur Oui ou Selon la définition de file d'attente est sélectionnée pour l'option Messages non persistants avec lecture anticipée et cache pour des clients. Cette propriété détermine ce que deviennent les messages dans la mémoire tampon interne de lecture anticipée lorsque le destinataire du message est fermé.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	La méthode de fermeture attend que tous les messages placés dans la mémoire cache soient distribués.
Plage de valeurs	Attendre que tous les messages en mémoire cache soient distribués Tous les messages de la mémoire tampon interne de lecture anticipée sont distribués au programme d'écoute des messages de l'application avant d'être renvoyés. Attendre que le message en cours soit distribué Seul l'appel du programme d'écoute des messages se termine avant d'être renvoyé, laissant potentiellement des messages dans la mémoire tampon interne de lecture anticipée qui sont ensuite supprimés.

Lecture MQMD activée

Indique si une application peut lire les valeurs de zones MQMD à partir de messages JMS ayant été envoyés ou reçus à l'aide du fournisseur de messagerie IBM MQ.

Informations	Valeur
Type de données	Case à cocher
Valeur par défaut	Elément non sélectionné
Plage de valeurs	Elément non sélectionné Les applications ne peuvent pas lire les valeurs des zones MQMD. Elément sélectionné Les applications peuvent lire les valeurs des zones MQMD.

Ecriture MQMD activée

Indique si une application peut écrire les valeurs de zones MQMD dans des messages JMS qui seront envoyés ou reçus via le fournisseur de messagerie IBM MQ.

Informations	Valeur
Type de données	Case à cocher
Valeur par défaut	Elément non sélectionné
Plage de valeurs	Elément non sélectionné Les applications ne peuvent pas écrire les valeurs des zones MQMD. Elément sélectionné Les applications peuvent écrire les valeurs des zones MQMD.

Contexte du message MQMD

Définit les options de contexte de message spécifiées lors de l'envoi de messages vers une destination.

Informations	Valeur
Type de données	Liste déroulante
Valeur par défaut	DEFAULT
Plage de valeurs	DEFAULT L'appel d'API MQOPEN et la structure MQPMO n'indiquent aucune option de contexte de message explicite. SET_IDENTITY_CONTEXT L'appel d'API MQOPEN indique l'option de contexte de message MQOO_SET_IDENTITY_CONTEXT, et la structure MQPMO spécifie MQPMO_SET_IDENTITY_CONTEXT. SET_ALL_CONTEXT L'appel d'API MQOPEN indique l'option de contexte de message MQOO_SET_ALL_CONTEXT, et la structure MQPMO spécifie MQPMO_SET_ALL_CONTEXT.

Nom du fichier : umj_MQQueueAdvancedProps.html