Propriétés du gestionnaire de files d'attente de cluster

La boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster affiche les propriétés des canaux émetteur et récepteur de cluster dans le gestionnaire de files d'attente de cluster sélectionné. Vous ne pouvez pas modifier les propriétés figurant dans la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster.

Gestionnaires de files d'attente de cluster membres d'un cluster. Le terme gestionnaire de files d'attente de cluster est également utilisé pour faire référence aux enregistrements que chaque gestionnaire d'un cluster gère sur d'autres gestionnaires et objets du cluster, en particulier, les canaux émetteur et récepteur de cluster.

La boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster affiche les propriétés des canaux émetteur et récepteur de cluster dans le gestionnaire de files d'attente de cluster sélectionné. Les tableaux ci-après répertorient les propriétés affichées dans la boîte de dialogue de propriétés. Ces propriétés diffèrent des propriétés affichées pour les mêmes canaux dans la boîte de dialogue Propriétés d'un canal (voir Propriétés d'un canal).

Vous ne pouvez pas modifier les propriétés figurant dans la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster.

Les tableaux fournissent le paramètre MQSC équivalent pour la commande DISPLAY CLUSQMGR. Pour plus d'informations sur les commandes MQSC, voir Administration de IBM® MQ à l'aide de commandes MQSC dans IBM Documentation.

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 de propriétés Gestionnaire de files d'attente de cluster.

Propriété Explication Paramètre MQSC
Nom du canal Nom de la définition de canal. Canal
Statut de canal Statut en cours du canal. STATUT
Nom de connexion Pour les canaux émetteurs de cluster, il s'agit du nom de l'ordinateur hébergeant le gestionnaire de files d'attente cible. Pour les canaux récepteurs de cluster, il s'agit du nom de l'ordinateur hébergeant le gestionnaire de files d'attente local. Le format du nom de connexion dépend du protocole de transmission sélectionné. CONNAME
Description Description du canal de cluster. DESCR
Adresse de communication locale Si le canal utilise TCP/IP et une adresse IP, un port ou un intervalle de ports pour les communications sortantes, l'adresse de communication locale pour le canal est spécifiée. Le canal est lié localement à l'adresse. Le format utilisé est le suivant:ipaddress(low-port, high-port)ipaddress est l'adresse IP spécifiée au format IPv4 en notation décimale à point, IPv6 en notation hexadécimale ou au format de nom d'hôte alphanumérique. Exemple :192.0.2.1indique l'adresse IPv4 avec n'importe quel port ;192.0.2.1(1000)indique l'adresse IPv4 et un port spécifique ;192.0.2.1(1000,2000)indique l'adresse IPv4 et une plage de ports ;(1000)indique un port uniquement. LOCLADDR
Suspension Indique si le gestionnaire de files d'attente est exclu du cluster (suite à la commande SUSPEND QMGR). Yes signifie que le gestionnaire de files d'attente est suspendu. SUSPEND
Protocole de transmission Type de transmission utilisé par le canal. TRPTYPE
Version Version de l'installation IBM MQ à laquelle le gestionnaire de files d'attente de cluster est associé. La version est au format suivant :
VVRRMMFF
VV : Version
RR : édition
MM : niveau de maintenance
FF : niveau de correctif
VERSION

Page Etendu

Le tableau ci-dessous répertorie les propriétés figurant dans la page Etendu de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster.

Propriété Explication Paramètre MQSC
Longueur maximale des messages Longueur maximale d'un message (en octets) pouvant être transmis sur le canal. MAXMSGL
Intervalle des pulsations Durée de l'intervalle des pulsations en secondes. La valeur zéro indique qu'aucune pulsation n'est transmise. Le système utilise la plus grande des valeurs spécifiées aux extrémités émettrice et réceptrice du canal. L'intervalle de pulsations est la durée en secondes entre les flots de pulsations transmis par l'agent MCA émetteur lorsqu'aucun message ne figure dans la file d'attente de transmission. La transmission des pulsations permet à l'agent MCA récepteur de mettre le canal au repos. HBINT
Valeur de bouclage du numéro de séquence Le numéro de séquence est le nombre de messages envoyés via le canal. Il augmente à chaque fois qu'un message est envoyé via le canal. Cette propriété affiche le numéro de séquence de message le plus élevé pouvant être atteint avant de repasser à 1. La même valeur de bouclage doit être définie aux deux extrémités du canal lorsque celui-ci est démarré, faute de quoi, une erreur se produit. SEQWRAP
Vitesse de messages non persistants

Indique si des messages non persistants sont envoyés dans le cadre d'une transaction. Fast signifie que les messages non persistants ne sont pas envoyés dans le cadre d'une transaction et deviennent alors disponibles pour l'extraction beaucoup plus rapidement que s'ils font partie d'une transaction ; Normal signifie que des messages non persistants sont envoyés dans le cadre d'une transaction, ce qui réduit le risque de perdre les messages si le canal s'arrête lorsque les messages sont en transit. NPMSPEED
Taille des lots Nombre maximal de messages devant être envoyé avant l'exécution d'un point de synchronisation. Les messages sont toujours transférés individuellement, mais ils sont validés ou annulés par lot. BATCHSZ
Intervalle de déconnexion (secondes) Nombre de secondes entre la fin de l'exécution par lots et la fermeture du canal. Sur les plates-formes multiples, la valeur 0 signifie que le canal ne se déconnecte pas. Sur z/OS®, une valeur de 0 signifie que le canal se déconnecte immédiatement. DISCINT
Conversion de données Indique si le message est converti avant transmission au format requis par le système récepteur. Yes signifie que le message est converti avant la transmission ; No signifie que le message est converti par l'application de réception au format requis sur le système récepteur (c'est la méthode type). CONVERT
Intervalle entre les lots (millisecondes) Nombre de millisecondes au cours desquelles le canal laisse le travail par lots ouvert même s'il n'y a aucun message sur la file d'attente de transmission. BATCHINT
Intervalle des pulsations par lots (millisecondes) Cet intervalle permet à l'extrémité émettrice du canal de vérifier que l'extrémité réceptrice est toujours active, juste avant de valider un lot de messages. Si l'extrémité réceptrice du canal n'est pas active, le lot peut être annulé, plutôt que de rester en attente de validation. Les messages restent ainsi disponibles pour tout traitement comme, par exemple, leur réacheminement vers un autre canal. Cette propriété indique le nombre de secondes pendant lesquelles l'extrémité émettrice du canal attend une réponse de l'extrémité réceptrice avant de considérer qu'elle est inactive. La valeur 0 indique qu'il n'est pas fait usage de la pulsation par lots. Pour plus d'informations, voir Réduction de la probabilité qu'un canal soit en attente de validation. BATCHHB
Droit d'insertion Cette propriété spécifie le type de traitement de sécurité devant être effectué par l'agent MCA (Message Channel Agent) lors de l'exécution d'une commande MQPUT sur la file d'attente cible ou d'un appel MQI. Default signifie que l'ID utilisateur par défaut est utilisé ; Context signifie que l'ID utilisateur de remplacement à partir des informations de contexte associées au message est utilisé. PUTAUT
Compression de message Indique les techniques de compression de message prises en charge par la définition de canal, par ordre de préférence. La première technique prise en charge par l'autre extrémité du canal est utilisée. None signifie qu'aucune compression de message n'est effectuée. RLE signifie que la compression des données de message est effectuée à l'aide du codage de longueur d'exécution. ZLIBFAST signifie que la compression des données de message est effectuée à l'aide de la technique de compression zlib et qu'un temps de compression rapide est recommandé. ZLIBHIGH signifie que la compression des données de message est effectuée à l'aide de la technique de compression zlib et qu'un niveau élevé de compression est recommandé. [MQ 9.4.0 Juin 2024 ][UNIX, Linux, Windows, IBM i]LZ4FAST signifie que la compression des données du message est effectuée à l'aide de la technique de compression LZ4 et qu'un temps de compression rapide est préférable. LZ4HIGH signifie que la compression des données du message est effectuée à l'aide de la technique de compression LZ4 et qu'un niveau élevé de compression est préféré.

ANY signifie que toute technique de compression prise en charge par le gestionnaire de files d'attente peut être utilisée.

Pour plus d'informations, voir File d'attente distribuée et grappes dans IBM Documentation.

COMPMSG
Compression d'en-tête Indique les techniques de compression d'en-tête prises en charge par la définition de canal, par ordre de préférence. La première technique prise en charge par l'autre extrémité du canal est utilisée. None signifie qu'aucune compression d'en-tête n'est effectuée ; System signifie que la compression d'en-tête est effectuée. Pour plus d'informations, voir File d'attente distribuée et grappes dans IBM Documentation. COMPHDR
Contrôle des propriétés Ce paramètre indique ce qui arrive aux propriétés des messages sur le point d'être envoyés vers un gestionnaire de files d'attente V6 ou antérieur. La valeur Compatibilité doit être remplacée par Forcer pour conserver le comportement de la version 6 pour la propagation RFH2 vers l'appelant. Les valeurs possibles sont les suivantes:

Toutes signifie que toutes les propriétés du message seront incluses dans le message lors de son envoi au gestionnaire de files d'attente éloignées. Les propriétés, à l'exception de celles du descripteur de message (ou extension), sont placées dans un ou plusieurs en-têtes MQRFH2 dans les données du message.

Compatibilité. Il s'agit de la valeur par défaut ; elle permet aux applications qui attendent les propriétés liées à JMS dans un en-tête MQRFH2 dans les données du message de continuer à travailler sans modification.

Si le message contient une propriété avec un préfixe mcd., jms., usr., ou mqext. toutes les propriétés de message facultatives (où la valeur de support est MQPD_SUPPORT_OPTIONAL), à l'exception de celles du descripteur de message (ou l'extension) sont placées dans un ou plusieurs en-têtes MQRFH2 dans les données de message avant l'envoi de ce dernier au gestionnaire de files d'attente éloignées. Sinon, toutes les propriétés du message, à l'exception de celles du descripteur de message (ou extension), sont supprimées du message avant son envoi au gestionnaire de files d'attente éloignées.

PROPCTL
 

Si le message contient une propriété pour laquelle la zone Support du descripteur de propriété n'a pas la valeur MQPD_SUPPORT_OPTIONAL, alors le message est rejeté et traité conformément à ses options de rapport. Si le message contient une ou plusieurs propriétés pour lesquelles la zone Support du descripteur de propriété a la valeur MQPD_SUPPORT_OPTIONAL, mais que les autres zones du descripteur de propriété ont des valeurs autres que celles par défaut, ces propriétés sont supprimées du message avant son envoi au gestionnaire de files d'attente éloignées.

Aucune signifie que toutes les propriétés du message, à l'exception de celles du descripteur de message (ou extension), sont supprimées du message avant son envoi au gestionnaire de files d'attente éloignées. Si le message contient une propriété pour laquelle la zone Support du descripteur de propriété n'a pas la valeur MQPD_SUPPORT_OPTIONAL, alors le message est rejeté et traité conformément à ses options de rapport.

 
Limite de données par lots Fournissez la limite en kilooctets, de 0 à 999999, de données à envoyer via un canal avant de prendre un point de synchronisation. Une valeur de 0 signifie qu'une limite de données n'est appliquée aux lots sur ce canal. BATCHLIM
Utiliser la file d'attente de rebut Spécifie si la file d'attente de rebut est utilisée lorsque les messages ne peuvent pas être distribués par les canaux. Il existe deux valeurs possibles :
  • Non signifie que les messages qui ne peuvent pas être distribués par un canal sont traités comme un échec et que le canal se termine conformément au paramètre Vitesse de messages non persistantsou supprime les messages.
  • Oui signifie que si la propriété File d'attente de rebut du gestionnaire de files d'attente fournit le nom d'une file d'attente de rebut, elle est utilisée. Autrement, cette valeur est identique à celle de Non.
USEDLQ

Page MCA

Le tableau ci-dessous répertorie les propriétés figurant dans la page MCA de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster. Ces propriétés indiquent comment l'agent MCA (Message Channel Agent) fonctionne pour le canal sélectionné.

Propriété Explication Paramètre MQSC
ID utilisateur MCA ID utilisateur à utiliser par l'agent MCA lors de la tentative de démarrage d'une session LU6.2 sécurisée avec un MCA distant. USERID
Type MCA Indique comment fonctionne l'agent MCA. Thread signifie que l'agent MCA s'exécute en tant qu'unité d'exécution ; Process signifie que l'agent MCA s'exécute en tant que processus. MCATYPE
Nom MCA Nom de l'agent MCA. MCANAME

Page Exits

Le tableau ci-dessous répertorie les propriétés figurant dans la page Exits de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster. Les propriétés configurent les exits utilisateur exécutés par le canal sélectionné.

Propriété Explication Paramètre MQSC
Nom d'exit de sécurité Nom du programme d'exit de sécurité. SCYEXIT
Nom d'exit de message Noms des programmes d'exit de messages. MSGEXIT
Nom d'exit d'émission Noms des programmes d'exit d'émission. SENDEXIT
Nom d'exit de réception Noms des programmes d'exit de réception. RCVEXIT
Données utilisateur d'exit de sécurité Données transmises à l'exit de sécurité du canal lorsqu'il est appelé. SCYDATA
Données utilisateur d'exit de message Données transmises à l'exit de message du canal lorsqu'il est appelé. MSGDATA
Données utilisateur d'exit d'émission Données transmises à l'exit d'émission du canal lorsqu'il est appelé. SENDDATA
Données utilisateur d'exit de réception Données transmises à l'exit de réception du canal lorsqu'il est appelé. RCVDATA

Page LU6.2

Le tableau ci-dessous répertorie les propriétés figurant dans la page LU6.2 de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster.

Propriété Explication Paramètre MQSC
Nom de mode Nom du mode LU 6.2. MODENAME
Nom de TP Nom ou nom générique du programme MCA exécuté à l'extrémité la plus éloignée de la liaison. TPNAME
ID utilisateur ID utilisateur utilisé par l'agent MCA lorsque ce dernier tente d'ouvrir une session LU 6.2 sécurisée avec un agent MCA distant. USERID
Mot de passe Mot de passe utilisé par l'agent MCA lorsque ce dernier tente d'ouvrir une session LU 6.2 sécurisée avec un agent MCA distant. PASSWORD

Page Relance

Le tableau ci-dessous répertorie les propriétés figurant dans la page Relance de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster. Les propriétés configurent le comportement du canal s'il ne peut pas se connecter au gestionnaire de files d'attente éloignées.

Propriété Explication Paramètre MQSC
Nombre de relances courtes Nombre maximal de tentatives de connexion du canal au gestionnaire de files d'attente éloignées. SHORTRTY
Intervalle entre relances courtes Intervalle approximatif, en secondes, pendant lequel le canal doit attendre avant de retenter de se connecter au gestionnaire de files d'attente éloignées dans le cadre du nombre de relances abrégées. La valeur 0 signifie que le canal effectue immédiatement une nouvelle tentative. SHORTTMR
Nombre de relances longues Nombre maximal de tentatives de connexion du canal au gestionnaire de files d'attente éloignées. La valeur de cette propriété est utilisée uniquement lorsque le nombre spécifié dans la propriété Short retry count a été épuisé et que le canal n'est toujours pas connecté au gestionnaire de files d'attente éloignées. LONGRTY
Intervalle entre relances longues Intervalle approximatif, en secondes, pendant lequel le canal doit attendre avant de retenter de se connecter au gestionnaire de files d'attente éloignées dans le cadre du nombre de relances longues. La valeur 0 signifie que le canal effectue immédiatement une nouvelle tentative. LONGTMR
Intervalle de signal de présence La valeur de la propriété Keep alive interval indique la valeur temporelle du canal. Auto signifie que la valeur du signal de présence est basée sur la valeur de la Heartbeat intervalnégociée. Si une valeur est spécifiée et que le Heartbeat interval négocié est supérieur à zéro, le Keep alive interval est le Heartbeat interval négocié plus 60 secondes ; si le Heartbeat interval négocié est égal à zéro, Keep alive interval est égal à zéro également. La valeur 0 signifie que le signal de présence sur ce canal est désactivé. KAINT

Page Relance de message

Le tableau ci-dessous répertorie les propriétés figurant dans la page Relance de message de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster. Les propriétés configurent le comportement du canal lorsqu'il tente pour la première fois de placer un message sur une file d'attente éloignée.

Propriété Explication Paramètre MQSC
Nombre de relances de message Nombre de fois où le canal retente de se connecter au gestionnaire de files d'attente éloignées avant de signaler qu'il ne peut pas transmettre le message à la file distante. Cette propriété contrôle l'action de l'agent MCA uniquement si la propriété Message retry exit name est vide. Si la propriété du nom de l'exit de relance de message n'est pas à blanc, la valeur de la propriété Message retry count est transmise à l'exit pour l'utilisation de l'exit, mais le nombre de tentatives de connexion du canal est contrôlé par l'exit, et non par la propriété Message retry count. MRRTY
Intervalle entre relances de message Durée minimale, en millisecondes, pendant laquelle le canal doit attendre avant qu'il puisse retenter de placer un message sur la file distante. MRTMR
Nom d'exit de relance de message Nom du programme d'exit de relance de message du canal. MREXIT
Données utilisateur d'exit de relance de message Données transmises à l'exit de relance de message du canal lorsqu'il est appelé. MRDATA

Page Cluster

Le tableau ci-dessous répertorie les propriétés figurant dans la page Cluster de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster.

Propriété Explication Paramètre MQSC
Nom du cluster Nom du cluster dans lequel la définition de canal sélectionné est partagée.  
Gestionnaire de files d'attente de cluster Nom du gestionnaire de files d'attente qui héberge la définition de canal sélectionnée.  
Type de définition Indique comment le canal a été défini. Cluster-sender signifie que le canal a été défini comme un canal émetteur de cluster à partir d'une définition explicite ; Auto cluster-sender signifie que le canal a été défini comme un canal émetteur de cluster uniquement par définition automatique ; Auto explicit cluster-sender signifie que le canal a été défini comme un canal émetteur de cluster par définition automatique et une définition explicite ; Cluster-receiver signifie que le canal a été défini comme canal récepteur de cluster à partir d'une définition explicite. DEFTYPE
Type de gestionnaire de files d'attente Indique la fonction du gestionnaire de files d'attente dans le cluster. Repository signifie que le gestionnaire de files d'attente est un référentiel complet pour le cluster ; Normal signifie que le gestionnaire de files d'attente est un référentiel partiel pour le cluster. QMTYPE
QMID Nom unique du gestionnaire de files d'attente de cluster généré en interne. QMID
Priorité de réseau La valeur de cette propriété indique la priorité des canaux pour la connexion réseau ; 0 est la plus basse. NETPRTY
Rang du canal CLWL Rang du canal dans le cluster ; 0 est le rang le plus faible. Pour plus d'informations, voir File d'attente distribuée et grappes dans IBM Documentation. CLWLRANK
Priorité du canal CLWL Priorité du canal dans le cluster ; 0 est la priorité la plus faible. Pour plus d'informations, voir File d'attente distribuée et grappes dans IBM Documentation. CLWLPRTY
Pondération du canal CLWL Pondération appliquée au canal de sorte que la proportion de messages envoyée via celui-ci est contrôlée ; 1 est la pondération la plus faible. Pour plus d'informations, voir File d'attente distribuée et grappes dans IBM Documentation. CLWLWGHT
File d'attente de transmission Le canal émetteur de cluster transfère des messages à partir de cette file d'attente de transmission.
Le nom est celui de l'une des files d'attente de transmission suivantes :
SYSTEM.CLUSTER.TRANSMIT.QUEUE
File d'attente de transmission de cluster par défaut. La file d'attente est partagée entre les canaux émetteurs de cluster. La file d'attente est utilisée si la propriété du gestionnaire de files d'attente, Default cluster transmission queue est définie sur SCTQ, et qu'aucune file d'attente de transmission n'a son paramètre Cluster channel name défini pour être résolu sur ce canal émetteur de cluster. La file d'attente est également utilisée si la version du gestionnaire de files d'attente est inférieure à IBM WebSphere® MQ 7.5.
SYSTEM.CLUSTER.TRANSMIT.ChannelName
La file d'attente de transmission est créée par le gestionnaire de files d'attente, en réponse à la définition de la propriété du gestionnaire de files d'attente, Default cluster transmission queue à Queue for each channel. Par défaut, la file d'attente n'est pas partagée entre les canaux émetteurs de cluster.
User-defined transmission queue
Le paramètre de file d'attente de transmission, Cluster channel name, est défini manuellement pour être résolu sur ce canal émetteur de cluster. Plusieurs canaux émetteurs de cluster peuvent transférer des messages à partir de cette file d'attente de transmission.
XMITQ

Page SSL

Le tableau ci-dessous répertorie les propriétés figurant dans la page SSL de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster. Les propriétés configurent le canal en vue de l'utilisation de la sécurité TLS.

Propriété Explication Paramètre MQSC
SSL CipherSpec Nom du CipherSpec pour une connexion TLS. Les deux extrémités de la définition de canal TLS IBM MQ doivent avoir la même valeur dans la propriété SSL CipherSpec . SSLCIPH
Accepter uniquement les certificats dont les noms distinctifs correspondent à ces valeurs Valeur du nom distinctif sur le certificat du gestionnaire de files d'attente homologue ou du client à l'autre extrémité du canal IBM MQ . Lorsque le canal démarre, la valeur de cette propriété est comparée au nom distinctif du certificat. SSLPEER
Authentification des parties initialisant les connexions Ce paramètre indique comment le canal authentifie les clients TLS. Required signifie que le canal doit recevoir et authentifier un certificat TLS à partir d'un client TLS ; Optional signifie que le canal n'est pas requis pour recevoir et authentifier un certificat TLS à partir d'un client TLS. Si la valeur est Optional et que le client TLS homologue envoie un certificat, le canal authentifie le certificat comme normal. SSLCAUTH

Page Statistiques

Le tableau ci-dessous répertorie les propriétés figurant dans la page Statistiques de la boîte de dialogue de propriétés Gestionnaire de files d'attente de cluster. La page Statistiques affiche l'horodatage de la dernière modification du gestionnaire de files d'attente de cluster.

Propriété Explication Paramètre MQSC
Date de modification Date à laquelle les propriétés de la file d'attente ont été modifiées pour la dernière fois. ALTDATE
Heure de modification Heure à laquelle les propriétés de la file d'attente ont été modifiées pour la dernière fois. ALTTIME