Propriétés de canal
Vous pouvez définir des propriétés pour tous les types de canal, notamment les canaux de connexion client. Certaines propriétés sont propres à certains types de canal.
Les tableaux suivants répertorient toutes les propriétés que vous pouvez définir :
- Généralités
- Etendu
- MCA
- Exits
- LU6.2
- Relance
- Relance de message
- Cluster
- SSL
- Equilibrage des charges
- Statistiques
- Certaines propriétés sont propres à certains canaux de cluster.
Certaines propriétés sont spécifiques aux canaux z/OS® .
Pour chaque propriété, une brève description indique dans quel cas vous pourriez avoir à la configurer. Les tableaux indiquent également le paramètre MQSC équivalent pour les commandes DEFINE, ALTER et DISPLAY CHANNEL. Pour plus d'informations sur les commandes MQSC, voir Administration à l'aide des commandes MQSC dans la documentationIBM®.
Page Général
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans la page Général de la boîte de dialogue Propriétés d'un canal.
Propriété | Explication | Paramètre MQSC |
---|---|---|
Nom de canal | Lecture seule. Nom de la définition de canal. | Canal |
Tapez | Lecture seule. Type de la définition de canal. | CHLTYPE |
Disposition QSG | Lecture seule. Disposition du groupe de partage de files d'attente de la définition
de canal. Vous ne pouvez pas modifier la disposition d'une définition de canal après l'avoir créée. Queue manager signifie que la définition d'objet n'est disponible que pour le gestionnaire de files d'attente qui l'héberge ; Group signifie que la définition d'objet est stockée dans le référentiel partagé et que chaque gestionnaire de files d'attente du groupe de partage de files d'attente possède une copie de la définition ; Copy signifie que la définition d'objet est la copie du gestionnaire de files d'attente d'une définition dans le référentiel partagé. |
QSGDISP |
Description | Entrez une description de la fonction du canal. Voir Chaînes dans les boîtes de dialogue de propriétés. | DESCR |
Nom gest. de files | 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 que vous savez que le gestionnaire de files d'attente cible se connecte à l'aide d'un numéro de port autre que la valeur par défaut IBM MQ 1414, entrez computer_name(port_number) , où nom_ordinateur est le 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.
|
CONNAME |
File d'attente de transmission | Indiquez le nom de la file d'attente 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 souhaitez qu'il utilise une adresse IP, un port ou une plage de ports particuliers pour les communications sortantes, entrez l'adresse des communications locales du canal. Le canal est lié localement à l'adresse. Utiliser le formatipaddress(low-port, high-port), où 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. Par exemple,192.0.2.0indique l'adresse IPv4 avec n'importe quel port ;192.0.2.0(1000)indique l'adresse IPv4 et un port spécifique ;192.0.2.0(1000,2000)indique l'adresse IPv4 et une plage de ports ;(1000)indique un port uniquement. Cluster-sender channels: Si vous entrez une valeur dans la zone |
LOCLADDR |
Cluster-receiver channels: N'insérez pas d'adresse IP dans la zone |
||
Statut général des canaux | Lecture seule. Il s'agit du statut du canal. | statut |
Page Etendu
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans la page Etendu de la boîte de dialogue Propriétés d'un canal.
Propriété | Explication | 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. Définissez la valeur à être inférieure à celle de la propriété Disconnect
interval . 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 d'attente 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. 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. Cette
propriété est ignorée si le canal utilise un type de transport autre que TCP ou SPX. La propriété TCP Keep alive doit être définie sur Yes dans la page Canaux des propriétés du gestionnaire de files d'attente.
|
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.
Pour toutes les autres plateformes, entrez le nombre le plus élevé de la plage 100 à 999999999 à atteindre par le numéro de séquence du message avant qu'il ne soit 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 de 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 des lots | 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. Essayez la taille de lot par défaut de50et modifiez la valeur uniquement si 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. Aucune 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 Distributed queueing and clusters dans la documentationIBM. | 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. Aucune 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 Distributed queueing and clusters dans la documentationIBM. | 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 | 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. 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 la propriété 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 réduire la possibilité d'être mis'en attente de validation'. |
BATCHHB |
Disposition par défaut du canal | 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 d'attente de transmission est associée à l'attribut SHARED. Partage fixe. Un canal émetteur est partagé si sa file d'attente 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) |
Définit ce qu'il advient des propriétés des messages qui sont sur le point d'être envoyés à un gestionnaire de files d'attente IBM WebSphere® MQ 6.0 ou version antérieure. La valeur Compatibility doit être remplacée par All pour conserver le comportement IBM WebSphere MQ 6.0 de propagation de RFH2 à la 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 que les propriétés liées à JMS se trouvent dans un en-tête MQRFH2 dans les données du message de continuer à fonctionner 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. 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ées sur une instance de canal client TCP/IP donnée (socket). Les valeurs possibles sont les suivantes: 0 : indique aucun partage
de conversations sur un socket TCP/IP. L'instance de canal s'exécute dans un mode antérieur à celui d' IBM WebSphere MQ 7.0, en ce qui concerne:
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 |
Port (Sur les canaux AMQP seulement) |
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. | PORT |
Utiliser l'ID client (Sur les canaux AMQP seulement) |
Indique que l'ID client est utilisé pour se connecter sur un canal AMQP. Défini sur Oui ou Non. | USECLTID |
Signal de présence AMQP (Sur les canaux AMQP seulement) |
Spécifie la durée du signal de présence en millisecondes. Si le client AMQP n'a pas envoyé de trames dans l'intervalle de signal de présence, la connexion est fermée avec unamqp:resource-limit-exceededCondition d'erreur AMQP. | AMQPKA |
Racine des rubriques (Sur les canaux AMQP seulement) |
Spécifie la racine des rubriques pour un canal AMQP. Utilisez cette propriété pour vous assurer qu'une application MQ Light , lorsqu'elle est déployée sur un gestionnaire de files d'attente, ne publie pas de messages dans les zones de l'arborescence de rubriques utilisées par d'autres applications ou ne s'y abonne pas. 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. |
TPROOT |
![]() (Sur les canaux AMQP seulement) |
Indique le nom de la file d'attente modèle à utiliser lors de la création d'une file d'attente temporaire (d'une longueur maximale de 48 caractères). Par défaut, SYSTEM.DEFAULT.MODEL.QUEUE. |
TMPMODEL |
![]() (Sur les canaux AMQP seulement) |
Préfixe du nom de file d'attente temporaire à ajouter au début de la file d'attente modèle lors de la définition du nom d'une file d'attente temporaire (longueur maximale de 32 caractères). Par défaut, AMQP.* |
TMPQPRFX |
![]() |
Définit le comportement de l'agent MCA lors de l'obtention de
messages depuis une file d'attente de transmission ou du placement de messages dans
une file d'attente cible, en matière d'application des stratégies de protection AMS. Valable
pour les canaux de type émetteur, serveur, récepteur et demandeur. Les valeurs possibles sont les suivantes:
|
SPLPROT |
Page MCA
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans 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 propriétés figurant dans la page MCA.
Propriété | Explication | Paramètre MQSC |
---|---|---|
ID utilisateur MCA | Identifiant de l'utilisateur d'agent de canal de message. S'il n'est pas vide, il s'agit de l'identificateur utilisateur qui doit être utilisé par l'agent de canal de message pour l'autorisation d'accès aux ressources IBM MQ , y compris (si PUTAUT est DEF) l'autorisation d'insérer le message dans la file d'attente de destination pour les 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 les suivantes:
La longueur maximale de cette chaîne est :
|
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 cette propriété car le nom MCA est réservé et doit correspondre à des blancs uniquement. | MCANAME |
Page Exits
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans 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 propriétés de la page Exits.
Propriété | Explication | 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 d'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 d'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 d'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 d'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 ci-après répertorie les propriétés que vous pouvez définir dans 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 propriétés figurant dans la page LU6.2.
Propriété | Explication | Paramètre MQSC |
---|---|---|
Nom de mode | Entrez le nom du mode LU 6.2, qui est le nom du mode SNA, à moins que la valeur de la propriété Connection name sur la page Général ne contienne un objet latéral, auquel cas ne renseigne pas la valeur Mode name . Ce nom ne doit pas dépasser 8 caractères. |
MODENAME |
Nom de 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 distant. 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 distant. Il ne doit pas dépasser 12 caractères. | MOT de passe |
Page Relance
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans 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 propriétés figurant dans la page Relance.
Propriété | Explication | Paramètre MQSC |
---|---|---|
Nombre de relances courtes | Entrez le nombre maximal de fois, de 0 à 999999999 (ou, pour z/OS utilisant CICS, de 1 à 999999999), que le canal peut tenter de se connecter à un gestionnaire de files d'attente éloignées. | SHORTRTY |
Intervalle entre relances courtes | 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 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 | 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 la propriété Keep alive interval indique la valeur temporelle 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 des pulsations négocié est supérieur à zéro, Keep alive interval est l'intervalle de pulsations négocié plus 60 secondes ; si l'intervalle de pulsations négocié est égal à zéro, Keep alive interval est égal à 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 ci-après répertorie les propriétés que vous pouvez définir dans 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 propriétés de la page Relance de message.
Propriété | Explication | 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. 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é Message retry exit name 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 distribution du message par le canal est contrôlé par l'exit, et non par la propriété Message retry count . |
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
Propriété | Explication | 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 dans les 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 dans les boîtes de dialogue de propriétés. | CLUSNL |
Priorité de réseau | La valeur de cette propriété indique la priorité des canaux pour la connexion réseau. Entrez une valeur de 0 à 9 (0 correspondant à la priorité la plus faible). Voir NETPRTY channel attribute dans la documentationIBM. | NETPRTY |
Rang du canal CLWL | Entrez le rang du canal dans le cluster, de 0 à 9 (0 correspondant au rang le plus bas). Voir CLWLRANK channel attribute dans la documentationIBM. | CLWLRANK |
Priorité du canal CLWL | Entrez la priorité du canal dans le cluster, de 0 à 9 (0 correspondant à la priorité la plus faible). Voir CLWLPRTY channel attribute dans la documentationIBM. | 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 CLWLWGHT channel attribute dans la documentationIBM. | CLWLWGHT |
Page SSL
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans 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 propriétés figurant dans la page SSL.
Propriété | Explication | 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 cette propriété n'est pas définie, le certificat est déterminé par la propriété 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 de canal SSL IBM MQ doivent avoir la même valeur dans la propriété CipherSpec. Pour plus d'informations, voir la propriété SSLCIPH dans DEFINE CHANNEL dans la documentationIBM. La valeur de ce paramètre est également utilisée pour définir la valeur de la propriété Protocole de sécurité, qui est une zone de sortie de la page Attributs de statut de canal . |
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 sur le certificat 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 cette propriété est comparée au 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 |
Page Equilibrage de charge
Le tableau ci-après répertorie les propriétés que vous pouvez définir dans la page Equilibrage de charge de la boîte de dialogue des propriétés de canal.
Propriété | Explication | Paramètre MQSC |
---|---|---|
Pondération | La propriété de pondération du canal client est utilisée pour
spécifier une pondération afin d'influencer le choix de la définition de canal de
connexion client à utiliser. La propriété de pondération du canal client est utilisée
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é | La propriété d'affinité du canal est utilisée 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 cette propriété lorsque plusieurs définitions de canal
applicables sont
disponibles. Les valeurs possibles sont les suivantes: PREFEREZ. 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. AUCUNE. 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 ci-après répertorie les propriétés que vous pouvez définir dans 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 des statistiques, éditez les propriétés figurant dans la page Statistiques.
Propriété | Explication | Paramètre MQSC |
---|---|---|
Date de modification | Lecture seule. Il s'agit de la date à laquelle les propriétés de la file d'attente ont été modifiées pour la dernière fois. | ALTDATE |
Heure de modification | Lecture seule. Il s'agit de l'heure à laquelle les propriétés de la file d'attente ont été modifiées pour la dernière fois. | ALTTIME |
Contrôle des canaux | Vous pouvez configurer IBM MQ pour collecter des données de surveillance en ligne sur les performances actuelles du canal. Pour hériter de la valeur de la propriété Channel monitoring du gestionnaire de files d'attente (voir Propriétés du gestionnaire de files d'attente), cliquez sur Gestionnaire de files d'attente. Si la propriété Channel
monitoring du gestionnaire de files d'attente est None , la propriété Channel
monitoring de la file d'attente est ignorée. Si la propriété Channel monitoring du gestionnaire de files d'attente n'est pas None : pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte de données pour ce canal, cliquez sur Désactivé ; pour collecter les données à un taux bas, cliquez sur Faible ; pour collecter les données à un taux moyen, cliquez sur Moyen ; pour collecter des données à un taux élevé, cliquez sur Élevé. |
MONCHL |
Statistiques de canal | Vous pouvez configurer IBM MQ pour collecter des données statistiques sur l'activité du canal. Pour hériter de la valeur de la propriété Channel
statistics du gestionnaire de files d'attente (voir Propriétés du gestionnaire de files d'attente), cliquez sur Gestionnaire de files d'attente. Si la propriété Channel statistics du gestionnaire de files d'attente est None , la propriété Channel
statistics de la file d'attente est ignorée. Si la propriété Channel statistics du gestionnaire de files d'attente n'est pas None , pour remplacer les paramètres du gestionnaire de files d'attente et empêcher la collecte de données pour ce canal, cliquez sur Désactivé ; pour collecter les données à un taux bas, cliquez sur Faible ; pour collecter les données à un taux moyen, cliquez sur Moyen ; pour collecter des données à un taux élevé, cliquez sur Élevé. |
STATCHL |