Création d'un canal de transmission

Avant de commencer

Avant de créer un canal de transmission, vous devez avoir terminé les tâches suivantes dans le tutoriel :

A propos de cette tâche

Dans cette partie du tutoriel, vous apprendrez à créer un canal de transmission entre les gestionnaires de files d'attente émetteur et récepteur.
Vous pouvez effectuer cette tâche dans l'une des interfaces suivantes :

Création du canal de transmission de messages à l'aide de IBM MQ Explorer

Procédure

  1. Sur le gestionnaire de files d'attente de réception QM_APPLE, créez l'extrémité réceptrice du canal:
    1. Dans la vue Navigator, développez le gestionnaire de files d'attente QM_APPLE que vous avez créé précédemment.
    2. Cliquez avec le bouton droit de la souris sur le dossier Canaux , puis cliquez sur Nouveau > Canal récepteur.
      L'assistant de création d'un canal récepteur s'ouvre.
    3. Dans la zone Nom , entrez QM_ORANGE.QM_APPLE
    4. Cliquez sur Terminer.
      Vous avez créé le canal récepteur sur la machine réceptrice.
  2. Sur le gestionnaire de files d'attente émetteur QM_ORANGE, créez l'extrémité émettrice du canal:
    1. Développez le gestionnaire de files d'attente QM_ORANGE que vous avez créé précédemment.
    2. Cliquez avec le bouton droit de la souris sur le dossier Canaux , puis cliquez sur Nouveau > Canal émetteur.
      L'assistant de création d'un canal émetteur s'ouvre.
    3. Dans la zone Nom , entrez QM_ORANGE.QM_APPLE, puis cliquez sur Suivant.
    4. Dans la zone Nom de connexion , entrez le nom de l'ordinateur ou l'adresse IP de la machine réceptrice (vous devez l'avoir déjà obtenu avec l'aide de votre administrateur système).
      Si le numéro de port par défaut 1414 n'a pas été utilisé lors de la création de QM_APPLE, l'entrée de zone de nom Connexion doit être au format :
      
      con-name(port)
      con-name représente le nom de l'ordinateur ou l'adresse IP de la machine réceptrice et port représente le numéro de port utilisé lors de la configuration du gestionnaire de files récepteur.
    5. Dans la zone File d'attente de transmission , entrez QM_APPLE
      Le nom de la file d'attente de transmission que vous entrez ici doit correspondre à celui que vous avez entré pour la file d'attente de transmission dans la rubrique Création de files d'attente sur le gestionnaire de files d'attente d'envoi.
    6. Cliquez sur Terminer.
    7. Cliquez sur le dossier Canaux .
    8. Cliquez avec le bouton droit de la souris sur QM_ORANGE.QM_APPLE.
    9. Dans le menu contextuel, cliquez sur Démarrer.
    10. Cliquez sur OK.
      Vous avez créé le canal émetteur sur la machine réceptrice.
      Remarque: Vous n'avez pas besoin de démarrer le canal récepteur car il a démarré automatiquement lorsque vous avez configuré le canal émetteur (lorsque vous avez configuré le canal émetteur, vous avez spécifié l'adresse IP du canal récepteur).

Résultats

Vous avez créé un canal récepteur QM_ORANGE.QM_APPLE dans le gestionnaire de files d'attente récepteur QM_APPLE, et un canal émetteur QM_ORANGE.QM_APPLE dans le gestionnaire de files d'attente émetteur QM_ORANGE. Vous avez également démarré le canal émetteur, ce qui a démarré automatiquement le canal récepteur.

Création du canal de transmission à l'aide de MQSC

Procédure

  1. Ouvrez une invite de commande sur la machine réceptrice et suivez la procédure ci-dessous :
    1. Démarrez MQSC en entrant la commande suivante :
      
      runmqsc
      Un message vous informe qu'une session MQSC a démarré.
    2. Définissez un canal récepteur en entrant la commande suivante :
      
      define channel (QM_ORANGE.QM_APPLE) chltype (RCVR) trptype (TCP)
      Dès que le canal a été créé, un message vous en informe.
    3. Ouvrez une nouvelle fenêtre de commande et vérifiez quels sont les ports disponibles. Entrez la commande suivante :
      
      netstat -an

      Les processus en cours d'exécution sont alors répertoriés. Vérifiez le numéro de port de chaque processus pour savoir si le port 1414 est utilisé ; pour ce faire, consultez la colonne d'adresse locale. Ces informations sont fournies sous la forme adresse_ip:port_utilisé.

      Si le port 1414 n'est pas utilisé, utilisez-le comme numéro de port pour votre programme d'écoute et pour le canal émetteur ultérieurement dans la vérification. S'il est utilisé, sélectionnez un autre port non utilisé; par exemple 1415, s'il n'est pas utilisé par un autre processus.

    4. La vérification nécessite que vous démarriez le programme d'écoute IBM MQ par défaut. Par défaut, le programme d'écoute écoute sur le port 1414. Si vous avez constaté que le port 1414 était libre à l'étape c, aucune action n'est requise et vous pouvez passer à l'étape e. Si vous devez utiliser un port autre que le port 1414, modifiez la définition de SYSTEM.DEFAULT.LISTENER.TCP. Par exemple, pour utiliser le port 1415, entrez la commande suivante dans la fenêtre MQSC :
      
      alter listener(system.default.listener.tcp) trptype(tcp) port(port_number)
      port_number correspond au numéro du port sur le programme d'écoute. Il doit correspondre au numéro utilisé lors de la définition du canal émetteur à l'étape 2b de cette procédure.
    5. Dans la fenêtre MQSC, démarrez le programme d'écoute IBM MQ par défaut en entrant la commande suivante:
      
      start listener(system.default.listener.tcp)
    6. Arrêtez MQSC en tapant :
      
      end
      Des messages s'affichent, suivis de l'invite de commande.
  2. Ouvrez une invite de commande sur la machine émettrice et suivez la procédure ci-dessous :
    1. Démarrez MQSC en entrant la commande suivante :
      runmqsc
      Un message vous informe qu'une session MQSC a démarré.
    2. Définissez un canal émetteur en entrant la commande suivante :
      
      define channel(QM_ORANGE.QM_APPLE) chltype(sdr) conname('con-name(port)') xmitq(QM_APPLE) trptype(tcp)
      La valeur con-name représente l'adresse TCP/IP du poste récepteur. La valeur port correspond au port sur lequel le programme d'écoute s'exécute sur le poste récepteur, la valeur par défaut est 1414.
    3. Démarrez le canal en entrant la commande suivante :
      
      start channel (QM_ORANGE.QM_APPLE)
    4. Arrêtez MQSC en tapant :
      
      end
      Des messages s'affichent, suivis de l'invite de commande.

Résultats

Vous venez de créer tous les objets IBM MQ requis pour l'envoi des messages du gestionnaire de files d'attente émetteur QM_ORANGE à la file d'attente Q1 sur le gestionnaire de files d'attente récepteur QM_APPLE. La tâche suivante consistera à envoyer un message de test.