Propriétés de canal
Vous pouvez définir des attributs pour tous les types de canal, notamment les canaux de connexion client. Certains attributs sont propres à certains types de canal.
Les tableaux suivants répertorient tous les attributs que vous pouvez définir :
- Général
- Etendu
- MCA
- Exits
- LU6.2
- Relance
- Relance de message
- Cluster
- SSL
- Equilibrage de charge
- Statistiques
- Certains attributs sont propres à certains canaux de cluster.
Certains attributs sont propres aux canaux z/OS.
Pour chaque attribut, une brève description indique dans quel cas vous pourriez avoir à le configurer. Les tableaux fournissent également le paramètre MQSC équivalent pour les commandes ALTER CHANNEL et DISPLAY CHANNEL. Pour plus d'informations sur les commandes MQSC, voir Commandes Script (MQSC) dans la documentation en ligne du produit IBM® MQ.
Page Général
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Général de la boîte de dialogue Propriétés d'un canal.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Nom de canal | Lecture seule. Nom de la définition de canal. | CHANNEL |
Type | Lecture seule. Type de la définition de canal. | CHLTYPE |
Agencement QSG | Lecture seule. Agencement du groupe de partage de file d'attente de la définition de canal. Vous ne pouvez pas modifier l'agencement d'une définition de canal après l'avoir créée. Gestionnaire de files d'attente signifie que la définition d'objet est disponible uniquement pour le gestionnaire de files d'attente qui l'héberge ; Groupe signifie que la définition d'objet est stockée sur le référentiel partagé et que chaque gestionnaire de files d'attente du groupe de partage de files d'attente dispose d'une copie de la définition ; Copie signifie que la définition d'objet est la copie d'une définition du référentiel partagé dont dispose le gestionnaire. | QSGDISP |
Description | Entrez une description de la fonction du canal. Voir Chaînes des boîtes de dialogue de propriétés. | DESCR |
Nom du gestionnaire de files d'attente | Entrez le nom du gestionnaire de files d'attente sur lequel est défini le canal. Pour les canaux de connexion client, tapez le nom du gestionnaire de files d'attente auquel une application s'exécutant dans l'environnement client MQI peut demander à se connecter. | QMNAME |
Protocole de transmission | Sélectionnez dans la liste le type de transfert utilisé par le canal. | TRPTYPE |
Nom de connexion | Pour tous les types de canaux à l'exception des récepteurs de cluster, tapez le nom de l'ordinateur hébergeant le gestionnaire de files d'attente cible. Le format du nom de connexion dépend du protocole de transmission sélectionné. Par exemple, si vous utilisez le protocole TCP/IP et savez que le gestionnaire de files d'attente cible se connecte via un numéro de port autre que celui par défaut d'IBM MQ, 1414, entrez nom_ordinateur(numéro_port), où nom_ordinateur correspond au nom ou à l'adresse IP de l'ordinateur qui héberge le gestionnaire de files d'attente cible et numéro_port est le port utilisé par le programme d'écoute du gestionnaire de files d'attente cible. Pour les canaux récepteurs de cluster sur Windows, UNIX et Linux, qui utilisent le protocole de transport TCP/IP, ne spécifiez pas de valeur pour cet attribut ; IBM MQ génère un nom à utiliser, en se basant sur le port par défaut et l'adresse IPv4 en cours du système. Si le système ne possède pas d'adresse IPv4, l'adresse IPv6 en cours du système est utilisée. Pour les canaux cluster-récepteurs sur d'autres plateformes et pour les canaux cluster-récepteurs qui n'utilisent pas le protocole de transfert TCP/IP, entrez le nom de l'ordinateur où se trouve le gestionnaire de files d'attente local. | CONNAME |
File de transmission | Indiquez le nom de la file de transmission qui correspond au gestionnaire de files d'attente à l'extrémité réceptrice du canal. | XMITQ |
Adresse de communication locale | Si
le canal utilise TCP/IP et que vous voulez qu'il utilise une adresse IP, un port ou un intervalle de ports pour les communications sortantes, tapez l'adresse de communication locale pour le canal. Le canal est lié localement à l'adresse. Utilisez le format adresse_ip(port-bas, port-haut), où adresse_ip est l'adresse IP spécifiée en notation décimale à point IPv4, hexadécimale IPv6 ou au format de nom d'hôte alphanumérique. Par exemple, 192.0.2.0 définit l'adresse
IPv4 avec n'importe quel port ; 192.0.2.0(1000) définit l'adresse
IPv4 et un port spécifique ; 192.0.2.0(1000,2000) définit
l'adresse IPv4 et une plage de ports ; (1000) définit
un port uniquement. Canaux émetteurs de cluster : Si vous tapez une valeur dans la zone Adresse de communication locale d'un canal émetteur de cluster défini manuellement, elle est remplacée par les valeurs du canal récepteur de cluster du référentiel complet lorsque la communication est établie avec le gestionnaire de files d'attente de ce dernier. Outre la spécification de la valeur dans le canal émetteur de cluster défini manuellement, vous devez écrire un exit de définition automatique de canal pour forcer la valeur de l'attribut Adresse de communication locale dans les canaux émetteurs de cluster définis automatiquement. Canaux récepteurs de cluster : Ne placez une adresse IP dans la zone Adresse de communication locale d'un canal récepteur de cluster que si tous les gestionnaires de files d'attente se trouvent sur le même ordinateur. Ceci est dû au fait que si un gestionnaire de files d'attente tente de se connecter à un gestionnaire dont l'adresse IP est dans la zone Adresse de communication locale de son canal récepteur de cluster, ces valeurs sont propagées dans ses canaux émetteurs de cluster définis automatiquement. Cependant, vous pouvez placer un numéro de port ou un intervalle de ports dans la zone Adresse de communication locale d'un canal récepteur de cluster si vous voulez que tous les gestionnaires de files d'attente d'un cluster utilisent un port ou un intervalle de ports spécifique pour toutes leurs communications sortantes. |
LOCLADDR |
Etat général du canal | Lecture seule. Il s'agit de l'état du canal. | STATUS |
Page Etendu
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Etendu de la boîte de dialogue Propriétés d'un canal.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Longueur maximale des messages | Entrez la longueur maximale d'un message pouvant être transmis sur le canal :
|
MAXMSGL |
Intervalle des pulsations | Entrez la durée de l'intervalle des pulsations, comprise entre 0 et 999999. La valeur zéro indique qu'aucune pulsation n'est transmise. Il est recommandé de choisir une valeur inférieure à celle de l'attribut Intervalle de déconnexion. Le système utilise la valeur la plus élevée spécifiée aux extrémités émettrice et réceptrice. 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 de transmission. La transmission des pulsations permet à l'agent MCA récepteur de mettre le canal au repos. | HBINT |
Nombre maximal d'instances | Ce paramètre est utilisé sur les canaux de connexion serveur et les canaux AMQP. Nombre maximal d'instances indique le nombre maximal d'instances simultanées d'un canal de connexion serveur individuel ou d'un canal AMQP. La plage de valeurs doit être comprise entre 0 et 999999999. La valeur par défaut est 999999999 La valeur zéro indique que tous les accès client sont interdits. Si Nombre maximal d'instances a une valeur inférieure au nombre d'instances du canal de connexion serveur actuellement exécutées, les nouvelles instances ne peuvent démarrer tant qu'un nombre suffisant d'instances existantes n'auront pas été arrêtées.
|
MAXINST |
Nombre maximal d'instances par client | Ce paramètre est utilisé sur les canaux de connexion serveur. Nombre maximal d'instances par client spécifie le nombre maximal d'instances simultanées d'un canal de connexion serveur individuel qui peuvent être démarrées à partir d'un seul client. Dans ce contexte, les connexions émanant de la même adresse réseau distante peuvent être considérées comme issues du même client. La valeur peut être comprise entre 0 et 999999999. La valeur par défaut est 999999999 La valeur zéro indique que tous les accès client sont interdits. Nombre maximal d'instances diffère de Nombre maximal d'instances par client dans la mesure où Nombre maximal d'instances correspond au nombre maximal de connexions, alors que Nombre maximal d'instances par client correspond au nombre maximal de connexions que chaque client peut établir avec le serveur. |
MAXINSTC |
Intervalle de signal de présence | Entrez la longueur de l'intervalle de signal de présence, entre 0 et 99999. Cet attribut est ignoré si le canal utilise une type de transport autre que TCP ou SPX. L'attribut Signal de présence TCP doit être défini sur Oui sur la page Canaux des propriétés du gestionnaire de files d'attente. Sur les gestionnaires de files d'attente z/OS, l'attribut Intervalle de signal de présence spécifie l'intervalle de signal de présence pour chaque canal. Pour les gestionnaires de files d'attente sur d'autres plateformes, l'attribut Intervalle de signal de présence n'est utilisé que si le canal se connecte à un gestionnaire de files d'attente z/OS. Pour utiliser la fonctionnalité fournie par l'attribut Intervalle de signal de présence, attribuez à l'attribut Intervalle de signal de présence la valeur Auto afin d'utiliser une valeur basée sur l'intervalle des pulsations négocié. | KAINT |
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. Entrez le nombre le plus élevé, de 100 à 999999999 (ou, pour z/OS utilisant CICS, de 1 à 999999999), que le numéro de séquence des messages doit atteindre avant d'être réinitialisé à 1. Cette valeur doit être suffisamment élevée pour que le numéro ne soit pas réémis s'il est utilisé par un message plus ancien. 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 des messages non persistants | Pour indiquer que des messages non persistants d'un canal ne sont pas transmis lors de d'une transaction, sélectionnezRapide. Les messages non persistants sont donc disponibles pour extraction plus rapidement que s'ils font partie d'une transaction. Toutefois, dans la mesure où les messages non persistants ne font pas partie d'une transaction, ils risquent d'être perdus, par exemple, en cas d'arrêt du canal pendant leur transmission. Pour éviter cela, sélectionnez Normale. | NPMSPEED |
Taille du lot | Entrez le 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. Indiquez la taille de lot par défaut 50 et modifiez cette valeur uniquement si cela est nécessaire. | BATCHSZ |
Compression de message | Cliquez sur Editer pour ouvrir la boîte de dialogue Editer la compression du message. Sélectionnez 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. Aucun(e) signifie qu'aucune compression de message n'est effectuée ; RLE signifie que la compression des données du message est effectuée via la codage RLE ; ZLIBFAST signifie qu'elle est effectuée via la technique de compression zlib et qu'un temps de compression rapide est préféré ;ZLIBHIGH signifie qu'elle est effectuée via la technique de compression zlib et qu'un niveau de compression élevé est préféré ; ANY signifie que la technique de compression prise en charge par le gestionnaire de files d'attente peut être utilisée. Pour plus d'informations, voir Mise en file d'attente répartie et clusters dans la documentation en ligne du produit IBM MQ. | COMPMSG |
Compression d'en-tête | Cliquez sur Editer pour ouvrir la boîte de dialogue Editer la compression de l'en-tête. Sélectionnez 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. Aucun(e) signifie qu'aucune compression d'en-tête n'est effectuée ; Système signifie que la compression est effectuée. Pour plus d'informations, voir Mise en file d'attente répartie et clusters dans la documentation en ligne du produit IBM MQ. | COMPHDR |
Intervalle entre les lots | Tapez le nombre de millisecondes, entre 0 et 999999999, 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 |
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 |
Intervalle de déconnexion | Entrez la durée de l'intervalle, en secondes, comprise entre 0 et 999999, une fois le lot terminé et avant la fermeture du canal. La valeur 0 signifie que le canal ne se déconnecte pas. | DISCINT |
Conversion de données | Pour indiquer que le message est converti par l'application de réception au format requis sur le système récepteur (méthode habituelle), sélectionnez Non ; si le gestionnaire de files d'attente éloignées s'exécute sur une plateforme qui ne prend pas en charge la conversion des données, sélectionnez Oui pour indiquer que le message doit être converti au format requis par le système récepteur avant la transmission. | CONVERT |
Droit d'insertion | Cet attribut spécifie le type de traitement de sécurité devant être effectué par le MCA (Message Channel Agent) lors de l'exécution d'une commande MQPUT sur la file d'attente cible ou d'un appel MQI. Pour indiquer l'ID utilisateur par défaut, cliquez sur Par défaut ; pour indiquer l'ID utilisateur de remplacement à partir des informations contextuelles associées au message, cliquez sur Contexte. | PUTAUT |
Intervalle des pulsations par lots | Si le canal émetteur a reçu une communication du canal récepteur dans l'intervalle des pulsations par lots, le système suppose que le canal récepteur est actif ; sinon, une 'pulsation' est envoyée au canal récepteur pour vérifier son état. Le canal émetteur attend une réponse de l'extrémité réceptrice du canal pendant une période donnée, en fonction du nombre de secondes spécifié dans l'attribut de canal Intervalle des pulsations (HBINT). 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. Tapez le nombre de secondes, entre 0 et 999999, 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 Configuration du canal pour limiter les cas de mise en 'attente de validation'. |
BATCHHB |
Disposition de canal par défaut | Lorsque vous émettez la commande START CHANNEL
sans le mot clé de disposition de canal (CHLDISP), le canal est démarré en utilisant la
valeur de disposition de canal par défaut (DEFCDISP).
Les trois valeurs possibles sont : Privé. Il s'agit de la valeur par défaut. Démarrage en tant que canal privé sur le gestionnaire de files d'attente local. Partagé. Un canal récepteur est partagé s'il a été démarré en réponse à une communication entrante destinée au groupe de partage de files d'attente. Un canal émetteur est partagé si sa file de transmission est associée à l'attribut SHARED. Partage fixe. Un canal émetteur est partagé si sa file de transmission est associée à l'attribut SHARED et que la valeur de CONNAME est renseignée. |
DEFCDISP |
Contrôle des propriétés (Uniquement pour les canaux émetteur, les canaux serveur, les canaux émetteur et récepteur de cluster) |
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 Tous pour conserver la fonction version 6 de propagation RFH2 vers l'appelant. Les valeurs possibles sont : 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 le 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. 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. |
PROPCTL |
Partage des conversations (Seulement sur les canaux serveur-connexion et canaux client-connexion) |
Indique le nombre maximal de conversations
pouvant être partagés sur une instance de canal client TCP/IP donnée
(socket). Les valeurs possibles sont : 0 : indique aucun partage
de conversations sur un socket TCP/IP. L'instance de canal
s'exécute dans un mode avant IBM
WebSphere MQ version 7.0
Version 7.0, avec :
1 : indique aucun partage de conversations sur un socket TCP/IP. Les pulsations clients et lectures anticipées sont disponibles, dans un appel MQGET ou non, et la mise au repos de canal est davantage contrôlable. 2 - 999999999 : le nombre de conversations partagées. La valeur par défaut est 10. Si la valeur SHARECNV client-connexion ne correspond pas à la valeur SHARECNV serveur-connexion, la valeur la plus basse est utilisée. |
SHARECNV |
Numéro de séquence de réinitialisation en attente | Numéro de séquence d'une demande en attente ; indique qu'une demande de commande RESET CHANNEL utilisateur est en attente. Une valeur de zéro indique qu'il n'existe aucun canal en attente RESET CHANNEL. La valeur peut être comprise entre 1 et 999999999. Lorsque la valeur de RESETSEQ est 0, la commande DISPLAY CHANNEL renvoie RESETSEQ(NO). |
RESETSEQ |
Utiliser la file d'attente de rebut (Pas sur les canaux de connexion client, canaux de connexion serveur ou canaux de télémétrie) |
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 :
|
USEDLQ |
![]() (Sur les canaux AMQP seulement) |
![]() |
![]() |
![]() (Sur les canaux AMQP seulement) |
![]() |
![]() |
![]() (Sur les canaux AMQP seulement) |
![]() |
![]() |
![]() (Sur les canaux AMQP seulement) |
![]() La valeur par défaut de TPROOT est SYSTEM.BASE.TOPIC. Si vous l'appliquez, la chaîne de rubrique qu'un client AMQP utilise pour la publication ou l'abonnement ne comporte pas de préfixe, et le client peut échanger des messages avec d'autres applications MS de publication/abonnement. |
![]() |
Page MCA
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page MCA de la boîte de dialogue Propriétés d'un canal. Pour configurer le mode d'exécution d'un agent MCA (Message Channel Agent) pour ce canal, éditez les attributs sur la page MCA.
Attribut | Signification | Paramètre MQSC |
---|---|---|
ID utilisateur MCA | Identifiant de l'utilisateur d'agent de canal de message. S'il n'est pas à blanc, il définit l'identificateur utilisateur que l'agent de canal de message doit utiliser pour l'autorisation d'accès aux ressources IBM MQ, y compris (si PUTAUT a la valeur DEF) l'autorisation de placer le message dans la file d'attente de destination des canaux récepteur ou demandeur. S'il est
vide, l'agent de canal de message utilise son identifiant d'utilisateur par défaut. L'identifiant d'utilisateur par défaut provient de l'ID utilisateur ayant démarré
le canal récepteur. Les valeurs possibles sont :
|
MCAUSER |
Type MCA | Pour indiquer que le programme MCA est exécuté sous forme d'unité d'exécution, sélectionnez Unité d'exécution ; pour indiquer que l'agent MCA s'exécute en tant que processus, sélectionnez Processus. | MCATYPE |
Nom MCA | Lecture seule. Vous ne pouvez pas éditer cet attribut car le nom MCA est réservé et doit être défini uniquement par un blanc. | MCANAME |
Page Exits
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Exits de la boîte de dialogue Propriétés d'un canal. Pour configurer le canal afin qu'il exécute des exits utilisateur, éditez les attributs de la page Exits.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Nom d'exit d'émission | Cliquez sur Editer pour ouvrir la
boîte de dialogue Editer le nom d'exit d'émission. Ajoutez le nom des programmes d'exit d'émission :
|
SENDEXIT |
Données utilisateur transmises à l'exit d'émission | Tapez les données (32 caractères maximum) transmises à l'exit d'émission du canal lorsqu'il est appelé :
|
SENDDATA |
Nom d'exit de réception | Cliquez sur Editer pour ouvrir la
boîte de dialogue Editer le nom d'exit de réception. Ajoutez le nom des programmes d'exit de réception :
|
RCVEXIT |
Données utilisateur transmises à l'exit de réception | Tapez les données (32 caractères maximum) à transmettre à l'exit de réception du canal lorsqu'il est appelé :
|
RCVDATA |
Nom d'exit de sécurité | Entrez le nom du programme d'exit de sécurité :
|
SCYEXIT |
Données utilisateur transmises à l'exit de sécurité | Tapez les données (32 caractères maximum) transmises à l'exit de sécurité du canal lorsqu'il est appelé. | SCYDATA |
Nom d'exit de message | Cliquez sur Editer pour ouvrir la
boîte de dialogue Editer le nom d'exit de message. Ajoutez le nom des programmes d'exit de messages :
|
MSGEXIT |
Données utilisateur transmises à l'exit de message | Tapez les données (32 caractères maximum) transmises à l'exit de message du canal lorsqu'il est appelé :
|
MSGDATA |
Page LU6.2
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page LU6.2 de la boîte de dialogue Propriétés d'un canal. Si le canal utilise le protocole de transfert LU 6.2, éditez les attributs sur la page LU6.2.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Nom de mode | Entrez le nom de mode LU 6.2, identique au nom de mode SNA sauf si la valeur de l'attribut Nom de connexion, sur la page Général, contient un objet, auquel cas, laissez la valeur Nom de mode à blanc. Ce nom ne doit pas dépasser 8 caractères. | MODENAME |
Nom TP | Entrez le nom ou le nom générique du programme MCA exécuté à l'extrémité la plus éloignée de la liaison. | TPNAME |
ID utilisateur | Entrez l'identifiant d'utilisateur pouvant être utilisé par l'agent MCA lorsque ce dernier tente d'ouvrir une session LU 6.2 sécurisée avec un agent MCA éloigné. Bien que la longueur maximale autorisée pour cet attribut soit de 12 caractères, seuls les dix premiers sont utilisés. | USERID |
Mot de passe | Cliquez sur Modifier le mot de passe, puis entrez, dans la boîte de dialogue Modification du mot de passe, le mot de passe utilisé par l'agent MCA lorsqu'il tente d'ouvrir une session LU 6.2 sécurisée avec un agent MCA éloigné. Il ne doit pas dépasser 12 caractères. | PASSWORD |
Page Relance
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Relance de la boîte de dialogue Propriétés d'un canal. Pour configurer le comportement du canal s'il ne peut pas se connecter au gestionnaire de files d'attente éloignées, éditez les attributs sur la page Relance.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Nombre de relances abrégées | Entrez le nombre maximal de tentatives, de 0 à 999999999 (ou, pour z/OS utilisantCICS, de 1 à 999999999), de connexion du canal à un gestionnaire de files d'attente éloignées. | SHORTRTY |
Intervalle entre relances abrégées | Entrez l'intervalle approximatif, en secondes, pendant lequel le canal doit attendre avant de tenter une nouvelle connexion au gestionnaire de files d'attente éloignées, pendant l'intervalle entre relances abrégées. La valeur 0 signifie que le canal effectue immédiatement une nouvelle tentative. | SHORTTMR |
Nombre de relances longues | Entrez le nombre maximal de tentatives, de 0 à 999999999, de connexions du canal à un gestionnaire de files d'attente éloignées. La valeur de cet attribut est utilisée uniquement lorsque le nombre indiqué dans l'attribut Nombre de relances abrégées a été atteint et que le canal n'est toujours pas parvenu à se connecter au gestionnaire de files d'attente éloignées. | LONGRTY |
Intervalle entre relances longues | Entrez l'intervalle approximatif, en secondes, pendant lequel le canal doit attendre avant de tenter une nouvelle connexion au gestionnaire de files d'attente éloignées, pendant l'intervalle entre 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 l'attribut Intervalle de signal de présence indique la valeur d'expiration du canal. Pour baser la valeur de signal de présence sur la valeur de l'intervalle des pulsations négocié, sélectionnez Automatique. Si l'intervalle de pulsations négocié est supérieur à zéro, l'intervalle de signal de présence est l'intervalle de pulsations négocié plus 60 secondes ; si l'intervalle de pulsations négocié est égal à zéro, l'intervalle de signal de présence est également zéro. Pour indiquer une valeur d'expiration, tapez le nombre de secondes, entre 0 et 99999. Pour désactiver le signal de présence sur ce canal, tapez 0. | KAINT |
Page Relance de message
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page relance de message de la boîte de dialogue Propriétés d'un canal. Pour configurer le comportement du canal si sa première tentative d'insertion d'un message dans une file d'attente éloignée échoue, éditez les attributs de la page Relance de message.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Nombre de relances de message | Entrez le nombre de tentatives, de 0 à 999999999, de distribution d'un message par le canal avant qu'il détermine qu'il ne peut pas délivrer le message à la file d'attente éloignée. Cet attribut contrôle l'action de l'agent MCA uniquement si le Nom d'exit de relance de message est à blanc. Si un attribut de nom d'exit de relance de message a été indiqué, la valeur de l'attribut de Nombre de relances de message est transmise à l'exit pour utilisation de ce dernier, mais c'est l'exit, et non l'attribut Nombre de relances de message qui détermine le nombre de tentatives effectuées. | MRRTY |
Intervalle entre relances de message | Entrez la durée minimale, en millisecondes, durant laquelle le canal doit attendre avant de tenter à nouveau de placer le message sur la file d'attente éloignée. | MRTMR |
Nom d'exit de relance de message | Entrez le nom du programme d'exit de relance de message :
|
MRDATA |
Données utilisateur d'exit de relance de message | Entrez les données (32 caractères maximum) transmises à l'exit de relance de message du canal lorsque l'exit de relance de message du canal est appelé. | MREXIT |
Page Cluster
Attribut | Signification | Paramètre MQSC |
---|---|---|
Non partagé dans un cluster | Par défaut, cette option est sélectionnée de sorte que le canal n'est pas partagé dans les clusters. | Non applicable. |
Partagée dans le cluster | Pour partager le canal dans un cluster, sélectionnez cette option, puis entrez le nom du cluster. Voir Chaînes des boîtes de dialogue de propriétés. | CLUSTER |
Partagée dans une liste de clusters | Pour partager le canal dans plusieurs clusters, sélectionnez cette option, puis entrez le nom de l'objet liste de noms contenant les noms de clusters. Voir Chaînes des boîtes de dialogue de propriétés. | CLUSNL |
Priorité de réseau | La valeur de cet attribut indique la priorité des canaux pour la connexion de réseau. Entrez une valeur de 0 à 9 (0 correspondant à la priorité la plus faible). Voir Attribut de canal NETPRTY dans la documentation en ligne du produit IBM MQ. | NETPRTY |
Rang du canal CLWL | Entrez le rang du canal dans le cluster, de 0 à 9 (0 correspondant au rang le plus bas). Voir Attribut de canal CLWLRANK dans la documentation en ligne du produit IBM MQ. | CLWLRANK |
Priorité du canal CLWL | Entrez la priorité du canal dans le cluster, de 0 à 9 (0 correspondant à la priorité la plus faible). Voir Attribut de canal CLWLPRTY dans la documentation en ligne du produit IBM MQ. | CLWLPRTY |
Pondération du canal CLWL | Entrez la pondération appliquée au canal afin que la proportion de messages envoyée via le canal soit contrôlée. La valeur doit être comprise entre 1 et 99 (1 étant la pondération la plus faible). Voir Attribut de canal CLWLWGHT dans la documentation en ligne du produit IBM MQ. | CLWLWGHT |
Page SSL
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page SSL de la boîte de dialogue Propriétés d'un canal. Pour configurer le canal afin qu'il utilise la sécurité SSL, éditez les attributs de la page SSL.
Attribut | Signification | Paramètre MQSC |
---|---|---|
CertificateLabel | Label de certificat de canal à utiliser. Label qui identifie quel certificat personnel dans le référentiel de clés doit être envoyé à l'homologue distant. Si cet attribut n'est pas défini, le certificat est déterminé par l'attribut CertificateLabel du gestionnaire de files d'attente. | CERTLABL |
CipherSpec | Entrez le nom (maximum 32 caractères) de l'attribut CipherSpec pour une connexion TLS. Les deux extrémités de la définition du canal IBM MQ SSL doivent avoir la même valeur dans l'attribut CipherSpec. | SSLCIPH |
Authentification des parties initialisant les connexions | Pour indiquer que le canal doit recevoir et authentifier un certificat TLS d'un client TLS, sélectionnez Requis ; pour préciser que la réception et l'authentification par le canal d'un certificat TLS envoyé par un client TLS sont facultatives, sélectionnez Facultatif ; si vous sélectionnez Facultatif et si le client TLS homologue envoie un certificat, le canal authentifie le certificat comme étant normal. | SSLCAUTH |
Nom de l'émetteur de l'homologue | Filtre du nom distinctif de l'émetteur de certificat. Cette zone contient un filtre de nom distinctif qui correspond au nom distinctif de l'émetteur du certificat personnel de l'homologue distant. Nom de l'émetteur de l'homologue est un champ-clé dans la Mappe d'homologues SSL, à savoir, il est utilisé pour faire correspondre des enregistrements de droits d'accès de canal pour les connexions de canaux de communications entrantes. | SSLCERTI |
Accepter uniquement les certificats dont les noms distinctifs correspondent à ces valeurs | Entrez la valeur du nom distinctif dans le certificat issu du gestionnaire de files d'attente ou du client homologue, à l'autre extrémité du canal IBM MQ. Lorsque le canal démarre, la valeur de cet attribut est comparée avec le nom distinctif du certificat. | SSLPEER |
Accepter uniquement les certificats dont les noms distinctifs correspondent à ces valeurs | Cet enregistrement d'authentification de canal mappe les noms distinctifs TLS à des valeurs MCAUSER. Le paramètre SSLPEERMAP doit être accompagné d'un SSLPEER. | SSLPEERMAP |
Protocole de sécurité | Protocole de sécurité actuellement utilisé sur le canal. La valeur peut être NONE, TLSV1 ou TLSV12. | SECPROT |
Page Equilibrage de charge
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Equilibrage de charge de la boîte de dialogue Propriétés d'un canal.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Pondération | L'attribut de pondération du canal client est utilisé pour spécifier une pondération afin d'influencer le choix de la définition de canal de connexion client à utiliser. L'attribut de pondération du canal client est utilisé pour que les définitions de canal client puissent être sélectionnées de manière aléatoire en fonction de leur pondération lorsque plusieurs définitions sont disponibles. Lorsqu'un client émet une requête de connexion MQCONN pour un groupe de gestionnaires de files d'attente, en spécifiant un nom de gestionnaire de files d'attente commençant par un astérisque, et que plusieurs définitions de canal client existent dans la table de définition de canal du client (CCDT), la définition à utiliser est sélectionnée de manière aléatoire en fonction de sa pondération, toutes les définitions CLNTWGHT(0) applicables étant sélectionnées en premier par ordre alphabétique. Spécifiez une valeur comprise entre 0 et 99. La valeur par défaut est 0. Elle indique qu'aucun équilibrage de charge n'est effectué et que les définitions applicables sont sélectionnées par ordre alphabétique. Pour autoriser un équilibrage de charge, choisissez une valeur comprise entre 1 et 99, où 1 est la pondération la plus faible et 99 la plus élevée. La répartition des messages entre deux ou plusieurs canaux dotés de pondérations non nulles est à peu près proportionnelle au ratio de ces pondérations. |
CLNTWGHT |
Affinité | L'attribut d'affinité du canal est utilisé pour que les applications
client qui se connectent plusieurs fois au même nom de gestionnaire de files d'attente puissent choisir d'utiliser la même définition de canal client à chaque connexion. Utilisez cet attribut
lorsque plusieurs définitions de canal applicables sont disponibles. Les valeurs possibles sont : PREFERRED. Il s'agit de la valeur par défaut. La première connexion dans un processus de lecture d'une table de définition de canal du client (CCDT) crée une liste de définitions applicables basées sur la pondération du canal client, en classant les définitions de pondération nulle en premier et par ordre alphabétique. Chaque connexion du processus tente de se connecter en utilisant la première définition de la liste. Si la connexion échoue, la définition suivante est utilisée. Les définitions infructueuses dotées de valeurs de pondération de canal client autres que 0 sont placées en fin de liste. Les définitions pour lesquelles la pondération de canal client est égale à 0 restent en tête de liste et sont sélectionnées en premier pour chaque connexion. Chaque processus client ayant le même nom d'hôte crée la même liste. NONE. La première connexion dans un processus de lecture d'une table de définition de canal du client (CCDT) crée une liste de définitions applicables. Toutes les connexions du processus sélectionnent une définition applicable basées sur la pondération du canal client, en sélectionnant les définitions de pondération nulle en premier et par ordre alphabétique. |
AFFINITY |
Page Statistiques
Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Statistiques de la boîte de dialogue Propriétés d'un canal. Pour configurer le canal afin qu'il collecte des données de contrôle ou statistiques, éditez les attributs de la page Statistiques.
Attribut | Signification | Paramètre MQSC |
---|---|---|
Date de modification | Lecture seule. Il s'agit de la date à laquelle les attributs de la file d'attente ont été modifiés pour la dernière fois. | ALTDATE |
Heure de modification | Lecture seule. Il s'agit de l'heure à laquelle les attributs de la file d'attente ont été modifiés pour la dernière fois. | ALTTIME |
Contrôle des canaux | Vous pouvez configurer IBM MQ pour collecter des données de contrôle en ligne sur les performances actuelles du canal. Pour hériter la valeur de l'attribut Contrôle de canal du gestionnaire de files d'attente (voir Propriétés de gestionnaire de files d'attente), cliquez sur Gestionnaire de files d'attente. Si l'attribut Contrôle de canal du gestionnaire de files d'attente a la valeur Aucun(e), l'attribut Contrôle de canal de la file d'attente est ignoré. Si l'attribut Contrôle de canal du gestionnaire de files d'attente n'est pas Aucun(e) : pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte des données pour ce canal, cliquez sur Hors fonction ; pour collecter des données lentement, cliquez sur Faible ; pour collecter des données à vitesse moyenne, cliquez sur Moyen ; pour collecter des données rapidement, cliquez sur Elevée. | MONCHL |
Statistiques de canal | Vous pouvez configurer IBM MQ pour collecter des données statistiques sur l'activité du canal. Pour hériter la valeur de l'attribut Statistiques du canal du gestionnaire de files d'attente (voir Propriétés du gestionnaire de files d'attente ), cliquez sur Gestionnaire de files d'attente. Si l'attribut Statistiques du canal du gestionnaire de files d'attente a la valeur Aucun(e), l'attribut Statistiques du canal de la file d'attente est ignoré. Si l'attribut Statistiques du canal du gestionnaire de files d'attente n'est pas Aucun(e), pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte des données pour ce canal, cliquez sur Hors fonction ; pour collecter des données lentement, cliquez sur Faible ; pour collecter des données à vitesse moyenne, cliquez sur Moyen ; pour collecter des données rapidement, cliquez sur Elevée. | STATCHL |