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 :

Certains attributs ne s'appliquent pas à tous les types de canal :
  • Certains attributs sont propres à certains canaux de cluster.
  • [z/OS]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 :
  • Sous AIX, HP-UX, IBM i, Solaris, Windows et VSE/ESA, la valeur doit être supérieure ou égale à zéro et inférieure ou égale à la longueur de message maximale du gestionnaire de files d'attente.
  • Sur les autres plateformes, indiquez une valeur comprise entre 0 et 4,194,304 octets.
  • [z/OS]Sous IBM MQ for z/OS, la valeur doit être supérieure ou égale à zéro et inférieure ou égale à 104 857 600 octets.
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.

[V9.0.0.0 Jun 2016]Si un client se connecte sur un canal AMQP avec un ID déjà connecté (à savoir, il procède à une reprise du client), la reprise aboutit que le nombre de clients connectés ait atteint ou non la valeur de MAXINST.

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 :
  • Arrêt-mise au repos d'administrateur
  • Intervalle des pulsations par lots
  • Lecture anticipée

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 :
  • Non signifie que les messages qui ne peuvent pas être livrés par un canal sont traités comme un échec et soit le canal se termine conformément aux paramètre de Vitesse de messages non persistants, ou élimine les messages.
  • Oui signifie que si l'attribut de gestionnaire de files d'attente File d'attente de rebut fournit le nom d'une file d'attente de rebut, il est utilisé. Autrement, cette valeur est identique à celle de Non.
USEDLQ
[V9.0.0.0 Jun 2016]Port

(Sur les canaux AMQP seulement)

[V9.0.0.0 Jun 2016]Indique le port de la connexion AMQP. Le port par défaut des connexions AMQP 1.0 est 5672. Si vous utilisez déjà le port 5672, vous pouvez en spécifier un autre. [V9.0.0.0 Jun 2016]PORT
[V9.0.0.0 Jun 2016]Utilisation de l'ID client

(Sur les canaux AMQP seulement)

[V9.0.0.0 Jun 2016]Indique que l'ID client est utilisé pour se connecter sur un canal AMQP. Défini sur Oui ou Non. [V9.0.0.0 Jun 2016]USECLTID
[V9.0.0.0 Jun 2016]Signal de présence AMQP

(Sur les canaux AMQP seulement)

[V9.0.0.0 Jun 2016]Indique le signal de présence en secondes. Si le client AMQP n'a pas envoyé de trames au cours de l'intervalle de signal de présence, la connexion est fermée avec la condition d'erreur AMQP amqp:resource-limit-exceeded. [V9.0.0.0 Jun 2016]AMQPKA
[V9.0.0.0 Jun 2016]Racine des rubriques

(Sur les canaux AMQP seulement)

[V9.0.0.0 Jun 2016]Spécifie la racine des rubriques pour un canal AMQP. Utilisez cet attribut pour garantir qu'une application MQ Light, lorsqu'elle est déployée sur un gestionnaire de files d'attente, ne publie pas de message dans des zones de l'arborescence de rubriques utilisées par d'autres applications ou ne s'abonne pas à des messages provenant de zones de l'arborescence de rubriques utilisées par d'autres applications.

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.

[V9.0.0.0 Jun 2016]TPROOT

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 :
  • Sur z/OS, l'ID utilisateur affecté à la tâche démarrée par l'initiateur de canal par la table des procédures démarrées par z/OS.
  • Pour TCP/IP, en-dehors de z/OS, l'ID utilisateur de l'entrée inetd.conf ou l'utilisateur qui a démarré le programme d'écoute.
  • Pour SNA, en-dehors de z/OS, l'ID utilisateur de l'entrée de serveur SNA ou, en son absence, la demande d'association entrante ou l'utilisateur ayant démarré le programme d'écoute.
  • Pour NetBIOS ou SPX, l'ID utilisateur qui a démarré le programme d'écoute.
La longueur maximale de la chaîne est de 64 caractères sur Windows et de 12 caractères sur les autres plateformes. Sur Windows, vous pouvez qualifier éventuellement un identificateur utilisateur avec le nom de domaine dans le format utilisateur@domaine.
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 :
  • Sous UNIX et Linux, entrez les noms d'un ou de plusieurs programmes d'exit. La longueur totale maximale de tous les noms est de 999 caractères. Utilisez le format nom_bibliothèque(nom_fonction), où le nombre maximal de caractères dans un nom est 128.
  • Sous Windows, entrez le nom d'un ou de plusieurs programmes d'exit. La longueur totale maximale de tous les noms est de 999 caractères. Utilisez le format nom_dll(nom_fonction), où le nombre maximal de caractères dans un nom est 128.
  • Sous IBM i, vous pouvez indiquer jusqu'à 10 noms de programmes d'exit. Utilisez le format nom_programme nom_bibliothèque, où nom_programme occupe les 10 premiers caractères et nom_bibliothèque occupe les 10 caractères suivants. Ajoutez des espaces à la fin des noms abrégés pour que leur longueur atteigne 10 caractères.
  • Sous z/OS, vous pouvez indiquer jusqu'à 10 noms de programmes d'exit. Utilisez le nom du module de chargement, où le nombre maximal de caractères d'un nom est 8.
  • Sur d'autres plateformes, vous pouvez indiquer le nom d'un seul programme d'exit d'émission pour chaque canal.
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é :
  • Sous Windows, UNIX et Linux, entrez les noms d'un ou de plusieurs programmes d'exit. Séparez ces données par des virgules. La longueur totale maximale de la zone est de 999 caractères.
  • Sous IBM i, tapez jusqu'à chaînes de données, chacune d'une longueur de 32 caractères. La première chaîne est transmise au premier exit d'émission, la seconde au deuxième et ainsi de suite.
  • Sous z/OS, tapez jusqu'à 8 chaînes de données, chacune d'une longueur de 32 caractères. La première chaîne est transmise au premier exit d'émission, la seconde au deuxième et ainsi de suite.
  • Sur les autres plateformes, vous ne pouvez indiquer qu'une seule chaîne de données d'exit d'émission par canal.
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 :
  • Sous UNIX et Linux, entrez les noms d'un ou de plusieurs programmes d'exit. Le nombre total maximal de caractères de tous les noms est de 999 caractères. Utilisez le format nom_bibliothèque(nom_fonction), où le nombre maximal de caractères dans une chaîne est 128.
  • Sous Windows, entrez le nom d'un ou de plusieurs programmes d'exit. Séparez ces noms par des virgules. La longueur totale maximale de la zone est de 999 caractères. Utilisez le format nom_dll(nom_fonction), où le nombre maximal de caractères dans une chaîne est 128.
  • Sous Windows, vous pouvez indiquer jusqu'à 10 noms de programmes d'exit. Séparez ces noms par des virgules. Utilisez le format nom_programme nom_bibliothèque, où nom_programme occupe les 10 premiers caractères et nom_bibliothèque occupe les 10 caractères suivants. Ajoutez des espaces à la fin des noms abrégés pour que leur longueur atteigne 10 caractères.
  • Sous z/OS, vous pouvez indiquer jusqu'à 10 noms de programmes d'exit. Séparez ces noms par des virgules. Utilisez le nom du module de chargement où le nombre maximal de caractères est 8.
  • Sur d'autres plateformes, vous pouvez indiquer le nom d'un seul programme d'exit d'émission pour chaque canal.
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é :
  • Sous Windows, UNIX et Linux, entrez les noms d'un ou de plusieurs programmes d'exit. Séparez ces données par des virgules. La longueur totale maximale de la zone est de 999 caractères.
  • Sous IBM i, tapez jusqu'à chaînes de données, chacune d'une longueur de 32 caractères. La première chaîne est transmise au premier exit de réception, la seconde au deuxième et ainsi de suite.
  • Sous z/OS, tapez jusqu'à 8 chaînes de données, chacune d'une longueur de 32 caractères. La première chaîne est transmise au premier exit de réception, la seconde au deuxième et ainsi de suite.
  • Sur les autres plateformes, vous ne pouvez indiquer qu'une seule chaîne de données d'exit de réception pour chaque canal.
RCVDATA
Nom d'exit de sécurité Entrez le nom du programme d'exit de sécurité :
  • Sous UNIX et Linux, utilisez le format nom_bibliothèque(nom_fonction), où le nombre maximal de caractères dans une chaîne est 128.
  • Sous IBM i, utilisez le format nom_programme nom_bibliothèque, où nom_programme occupe les 10 premiers caractères et nom_bibliothèque occupe les 10 caractères suivants. Ajoutez des espaces à la fin des noms abrégés pour que leur longueur atteigne 10 caractères.
  • Sous z/OS, utilisez le nom du module de chargement où le nombre maximal de caractères est 8.
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 :
  • Sous UNIX et Linux, entrez les noms d'un ou de plusieurs programmes d'exit. La longueur totale maximale de tous les noms est de 999 caractères. Utilisez le format nom_bibliothèque(nom_fonction), où le nombre maximal de caractères dans un nom est 128.
  • Sous Windows, entrez le nom d'un ou de plusieurs programmes d'exit. La longueur totale maximale de tous les noms est de 999 caractères. Utilisez le format nom_dll(nom_fonction), où le nombre maximal de caractères dans un nom est 128.
  • Sous IBM i, vous pouvez indiquer jusqu'à 10 noms de programmes d'exit. Utilisez le format nom_programme nom_bibliothèque, où nom_programme occupe les 10 premiers caractères et nom_bibliothèque occupe les 10 caractères suivants. Ajoutez des espaces à la fin des noms abrégés pour que leur longueur atteigne 10 caractères.
  • Sous z/OS, vous pouvez indiquer jusqu'à 10 noms de programmes d'exit. Utilisez le nom du module de chargement, où le nombre maximal de caractères d'un nom est 8.
  • Sur d'autres plateformes, vous pouvez indiquer le nom d'un seul programme d'exit de messages pour chaque canal.
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é :
  • Sous Windows, UNIX et Linux, entrez les noms d'un ou de plusieurs programmes d'exit. Séparez ces données par des virgules. La longueur totale maximale de la zone est de 999 caractères.
  • Sous IBM i, tapez jusqu'à chaînes de données, chacune d'une longueur de 32 caractères. La première chaîne est transmise au premier exit de message du canal, la seconde au deuxième et ainsi de suite.
  • Sous z/OS, tapez jusqu'à 8 chaînes de données, chacune d'une longueur de 32 caractères. La première chaîne est transmise au premier exit de message du canal, la seconde au deuxième et ainsi de suite.
  • Sur les autres plateformes, vous ne pouvez indiquer qu'une seule chaîne de données d'exit de message de canal par canal.
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 :
  • Sous UNIX et Linux, utilisez le format nom_bibliothèque(nom_fonction), où le nombre maximal de caractères dans une chaîne est 128.
  • Sous IBM i, utilisez le format nom_programme nom_bibliothèque, où nom_programme occupe les 10 premiers caractères et nom_bibliothèque occupe les 10 caractères suivants. Ajoutez des espaces à la fin des noms abrégés pour que leur longueur atteigne 10 caractères.
  • Sous z/OS, utilisez le nom du module de chargement où le nombre maximal de caractères est 8.
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

Le tableau suivant répertorie les attributs que vous pouvez définir sur la page Cluster de la boîte de dialogue Propriétés d'un canal. Pour partager le canal entre un ou plusieurs clusters, éditez les attributs sur la page Cluster.
Remarque : Indiquez les attributs du canal du cluster dans les canaux récepteurs de cluster, dans les gestionnaires de files d'attente cible. Les attributs que vous spécifiez dans les canaux émetteurs de cluster correspondants sont susceptibles d'être ignorés. Voir Canaux de cluster dans la documentation en ligne du produit IBM MQ.
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

Référence Référence

Commentaires

Icône d'horodatage Dernière révision: Wednesday, 14 February 2018
http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.mq.explorer.doc/com.ibm.mq.explorer.doc/e_properties_channels.htm