[UNIX, Linux, Windows, IBM i]

Section TCP du fichier qm.ini

La strophe TCP spécifie les paramètres de configuration TCP/IP ( Transmission Control Protocol / Internet Protocol ). Ces paramètres remplacent les attributs par défaut des canaux.

Utilisez la section TCP du fichier qm.ini pour spécifier les paramètres de configuration TCP/IP.

[Windows][Linux]Alternativement, sur Linux® ( x86 et x86-64 ) et Windows, utilisez la page de propriétés du gestionnaire de file d'attente TCP IBM® MQ Explorer SPX .

Port = 1414 (valeur par défaut) | numéro_port
Numéro de port par défaut, en notation décimale, pour les sessions TCP/IP. Le numéro de port bien connu pour IBM MQ est 1414.
[Windows]Library1= DLLName1 (Windows uniquement)
Nom de la DLL des sockets TCP/IP.

La valeur par défaut est WSOCK32.

[UNIX, Linux, Windows, IBM i]SecureCommsOnly = NO|N|FALSE|F (default) |VRAI|T|OUI|Y
Indiquez si la communication en texte en clair est autorisée ou non.
SecureCommsOnly=NO|N|FALSE|F
La communication en texte en clair est autorisée et un message d'avertissement est généré lorsque le gestionnaire de files d'attente démarre.
SecureCommsOnly=YES|Y|TRUE|T
La communication en texte brut n'est pas autorisée et un message d'information est généré lorsque le gestionnaire de files d'attente démarre.
KeepAlive = NO (par défaut) |OUI
Activez ou désactivez la fonction KeepAlive . KeepAlive=YES permet à TCP/IP de vérifier périodiquement que l'autre extrémité de la connexion est toujours disponible. Si ce n'est pas le cas, le canal est fermé.
ListenerBacklog=number
Remplacez le nombre par défaut de demandes en attente pour le programme d'écoute TCP/IP.
Lors de la réception sur TCP/IP, un nombre maximal de demandes de connexion en attente est défini. Il peut s'agir d'un journal des demandes en attente sur le port TCP/IP pour que le programme d'écoute accepte la demande. Les valeurs par défaut du carnet de commandes de l'auditeur sont indiquées dans le tableau 1.
Tableau 1. Demandes de connexion en attente par défaut (TCP)
Plateforme Valeur ListenerBacklog par défaut
[Windows]Windows Serveur 100
[Linux]Linux 100
[AIX]AIX® V5.3 ou plus tard 100
Remarque: Certains systèmes d'exploitation prennent en charge une valeur supérieure à la valeur par défaut affichée. Utilisez cette option pour éviter d'atteindre le nombre maximal de connexions.

A l'inverse, certains systèmes d'exploitation peuvent limiter la taille du journal des éléments en attente TCP, de sorte que le journal des éléments en attente TCP effectif peut être plus petit que celui demandé ici.

Si l'arriéré atteint les valeurs indiquées dans le tableau 1, la connexion TCP/IP est rejetée et le canal ne peut pas démarrer. Pour les canaux de transmission de messages, le canal passe à l'état RETRY et relance la connexion ultérieurement. Pour les connexions client, le client reçoit un code anomalie MQRC_Q_MGR_NOT_AVAILABLE de MQCONN et relance la connexion ultérieurement.

Le groupe de propriétés suivant peut être utilisé pour contrôler la taille des mémoires tampon utilisées par TCP/IP. Les valeurs sont transmises directement à la couche TCP/IP du système d'exploitation. L'utilisation de ces propriétés doit être très soignée. Si les valeurs sont définies de manière incorrecte, cela peut avoir un impact négatif sur les performances TCP/IP. Pour plus d'informations sur la façon dont cela affecte les performances, reportez-vous à la documentation TCP/IP de votre environnement. La valeur zéro indique que le système d'exploitation va gérer les tailles de mémoire tampon, par opposition aux tailles de mémoire tampon fixées par IBM MQ.

Connect_Timeout = 0 (valeur par défaut) |nombre
Nombre de secondes avant qu'une tentative de connexion du socket n'expire. La valeur par défaut zéro indique qu'il n'y a pas de délai de connexion.

Les processus de canal IBM MQ se connectent via des sockets non bloquants. Par conséquent, si l'autre extrémité du socket n'est pas prête, connect () renvoie immédiatement EINPROGRESS ou EWOULDBLOCK. Par la suite, la connexion sera tentée à nouveau, jusqu'à un total de 20 tentatives de ce type, lorsqu'une erreur de communication est signalée.

Si Connect_Timeout est défini sur une valeur différente de zéro, IBM MQ attend la période stipulée sur l'appel select () pour que le socket soit prêt. Cela augmente les chances de réussite d'un appel connect () ultérieur. Cette option peut être utile dans les cas où les connexions nécessitent un délai d'attente, en raison d'une charge élevée sur le réseau.

SndBuffSize = nombre |0 (valeur par défaut)
Taille en octets de la mémoire tampon d'envoi TCP/IP utilisée par l'extrémité émettrice des canaux. Cette valeur peut être remplacée par une valeur plus spécifique au type de canal, par exemple RcvSndBuffSize. Si la valeur est définie sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. Si aucune valeur n'est définie, la valeur par défaut IBM MQ , 32768, est utilisée.
[UNIX, Linux, Windows, IBM i]New queue managers are automatically created with a default setting of 0 (see Exemple de strophe.
RcvBuffSize = nombre |0 (valeur par défaut)
Taille en octets de la mémoire tampon de réception TCP/IP utilisée par l'extrémité réceptrice des canaux. Cette valeur peut être remplacée par une valeur plus spécifique au type de canal, par exemple RcvRcvBuffSize. Si la valeur est définie sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. Si aucune valeur n'est définie, la valeur par défaut IBM MQ , 32768, est utilisée.
[UNIX, Linux, Windows, IBM i]New queue managers are automatically created with a default setting of 0 (see Exemple de strophe.
RcvSndBuffSize = nombre |0 (valeur par défaut)
Taille en octets de la mémoire tampon d'envoi TCP/IP utilisée par l'extrémité émettrice d'un canal récepteur. Si la valeur est définie sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. Si aucune valeur n'est définie, la valeur par défaut IBM MQ , 32768, est utilisée.
[UNIX, Linux, Windows, IBM i]New queue managers are automatically created with a default setting of 0 (see Exemple de strophe.
RcvRcvBuffSize = nombre |0 (valeur par défaut)
Taille en octets de la mémoire tampon de réception TCP/IP utilisée par l'extrémité réceptrice d'un canal récepteur. Si la valeur est définie sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. Si aucune valeur n'est définie, la valeur par défaut IBM MQ , 32768, est utilisée.
[UNIX, Linux, Windows, IBM i]New queue managers are automatically created with a default setting of 0 (see Exemple de strophe.
SvrSndBuffSize = nombre |0 (valeur par défaut)
Taille en octets de la mémoire tampon d'envoi TCP/IP utilisée par l'extrémité serveur d'un canal de connexion serveur de connexion client. Si la valeur est définie sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. Si aucune valeur n'est définie, la valeur par défaut IBM MQ , 32768, est utilisée.
[UNIX, Linux, Windows, IBM i]New queue managers are automatically created with a default setting of 0 (see Exemple de strophe.
SvrRcvBuffSize = nombre |0 (valeur par défaut)
Taille en octets de la mémoire tampon de réception TCP/IP utilisée par l'extrémité serveur d'un canal de connexion serveur de connexion client. Si la valeur est définie sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. Si aucune valeur n'est définie, la valeur par défaut IBM MQ , 32768, est utilisée.
[UNIX, Linux, Windows, IBM i]New queue managers are automatically created with a default setting of 0 (see Exemple de strophe).
[ MQ 9.4.3 Jul 2025][ MQ 9.4.0.10 Feb 2025]DNSResolutionOrder=list|IPV6,IPV4,ANY (default)
Ordre dans lequel IBM MQ recherche les noms d'hôtes dans les environnements mixtes IPv6 et IPv4 . Si la variable d'environnement AMQ_NO_IPV6 est définie, IBM MQ agit comme si DNSResolutionOrder=IPV4 était définie, quelle que soit la valeur configurée.
La valeur de DNSResolutionOrder est une liste séparée par des virgules avec les valeurs suivantes IPV6, IPV4 et ANY dans l'ordre préféré. Ces valeurs correspondent aux recherches DNS dans les familles d'adresses IPv6, IPv4 et non spécifiées, une recherche non spécifiée pouvant résoudre à la fois les adresses IPv6 et IPv4 . Chaque valeur ne peut apparaître qu'une seule fois dans la liste. Si IPV4 ou IPV6 sont absents de la liste, IBM MQ ajoute implicitement ANY pour s'assurer qu'il peut résoudre tous les types d'adresses.
La définition de la valeur de la liste à ANY pourrait permettre d'obtenir des performances plus rapides. IPV6 et IPV4 peuvent être classés dans l'ordre reflétant leur importance sur le réseau local.

Exemple de section

 TCP:
   SndBuffSize=0
   RcvBuffSize=0
   RcvSndBuffSize=0
   RcvRcvBuffSize=0
   ClntSndBuffSize=0
   ClntRcvBuffSize=0
   SvrSndBuffSize=0
   SvrRcvBuffSize=0
[UNIX, Linux, Windows, IBM i]Note : Pour les nouveaux gestionnaires de file d'attente sur Multiplatforms, les tailles de tampon d'envoi et de réception TCP par défaut dans la strophe TCP de qm.ini file sont définies pour être gérées par le système d'exploitation. Comme illustré dans l'exemple précédent, les nouveaux gestionnaires de files d'attente sont créés automatiquement avec la valeur par défaut 0 pour les mémoires tampon d'envoi et de réception. S'applique uniquement aux nouveaux gestionnaires de files d'attente. Les paramètres de mémoire tampon d'envoi et de réception TCP pour les gestionnaires de files d'attente migrés à partir de versions antérieures d' IBM MQ sont conservés.

Si les propriétés de taille de la mémoire tampon TCP sont supprimées du fichier qm.ini , la mémoire tampon par défaut est définie sur 32K. Vous devez être prudent lorsque vous utilisez cette valeur par défaut car 32K peut ne pas être une mémoire tampon appropriée pour tous les scénarios de messagerie.

Si les propriétés de mémoire tampon d'envoi et de réception TCP sont définies sur zéro, les valeurs par défaut du système d'exploitation sont utilisées. La méthode de sélection de ces valeurs par défaut varie en fonction du système d'exploitation, mais peut généralement être trouvée dans les pages de manuel du système d'exploitation "tcp" ou get/setsockopt ().