Réception sur TCP

Les programmes de canal récepteur sont démarrés en réponse à une demande de démarrage du canal émetteur. Pour répondre à la demande de démarrage, un programme d'écoute doit être démarré pour détecter les demandes réseau entrantes et démarrer le canal associé. Vous démarrez ce programme d'écoute à l'aide de la commande STRMQMLSR.

Vous pouvez démarrer plusieurs programmes d'écoute pour chaque gestionnaire de files d'attente. Par défaut, la commande STRMQMLSR utilise le port 1414, mais vous pouvez remplacer cette valeur. Pour remplacer le paramètre par défaut, ajoutez les instructions suivantes au fichier qm.ini du gestionnaire de files d'attente sélectionné. Dans cet exemple, le programme d'écoute doit utiliser le port 2500:

TCP:
Port=2500

Le fichier qm.ini se trouve dans ce répertoire IFS : /QIBM/UserData/mqm/qmgrs/ nom du gestionnaire de file d'attente.

Cette nouvelle valeur est lue uniquement lorsque le programme d'écoute TCP est démarré. Si un programme d'écoute est déjà en cours d'exécution, ce changement n'est pas visible par ce programme. Pour utiliser la nouvelle valeur, arrêtez le programme d'écoute et relancez la commande STRMQMLSR. Désormais, chaque fois que vous utilisez la commande STRMQMLSR, le programme d'écoute utilise par défaut le nouveau port.

Vous pouvez également spécifier un numéro de port différent dans la commande STRMQMLSR. Exemple :

STRMQMLSR MQMNAME( queue manager name ) PORT(2500)

Cette modification rend le programme d'écoute par défaut sur le nouveau port pendant la durée du travail du programme d'écoute.

Utilisation de l'option TCP SO_KEEPALIVE

Si vous souhaitez utiliser l'option SO_KEEPALIVE (pour plus d'informations, voir Vérifier que l'autre extrémité du canal est toujours disponible ), vous devez ajouter l'entrée suivante au fichier de configuration de votre gestionnaire de files d'attenteqm.ini dans le répertoire IFS, /QIBM/UserData/mqm/qmgrs/ nom du gestionnaire de files d'attente ) :

TCP:
KeepAlive=yes

Vous devez ensuite exécuter la commande suivante:

CFGTCP

Sélectionnez l'option 3 (Modifier les attributs TCP). Vous pouvez désormais spécifier un intervalle de temps en minutes. Vous pouvez indiquer une valeur comprise entre 1 et 40320 minutes ; la valeur par défaut est 120.

Utilisation de l'option en attente du programme d'écoute TCP

Lors de la réception sur TCP, un nombre maximal de demandes de connexion en attente est défini. Ce nombre peut être considéré comme un arriéré de demandes en attente sur le port TCP pour que le programme d'écoute accepte la demande.

La valeur par défaut du journal des éléments en attente du programme d'écoute sous IBM® i est 255. Si le journal des éléments en attente atteint cette valeur, la connexion TCP est rejetée et le canal ne peut pas démarrer.

Pour les canaux MCA, 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 peut relancer la connexion ultérieurement.

Toutefois, pour éviter cette erreur, vous pouvez ajouter une entrée dans le fichier qm.ini :

ListenerBacklog = n

Cette valeur remplace le nombre maximal par défaut de demandes en attente (255) pour le programme d'écoute TCP.

Remarque: Certains systèmes d'exploitation prennent en charge une valeur supérieure à la valeur par défaut. Si nécessaire, cette valeur peut être utilisée pour éviter d'atteindre la limite de connexion.