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 :

Pourquoi et quand exécuter 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 avec IBM MQ Explorer

Procédure

  1. Dans le gestionnaire de files d'attente de réception, QM_APPLE, créez l'extrémité réceptrice du canal :
    1. Dans la vue Navigateur, développez le gestionnaire de files d'attente QM_APPLE que vous avez créé précédemment.
    2. Cliquez avec le bouton droit sur le dossier Canaux, puis cliquez sur Création > d'un canal récepteur.
      L'assistant de création d'un canal récepteur s'ouvre.
    3. Dans la zone Nom, tapez QM_ORANGE.QM_APPLE
    4. Cliquez sur Terminer.
      Vous avez créé le canal récepteur sur la machine réceptrice.
  2. Dans 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 créé plus tôt.
    2. Cliquez avec le bouton droit sur le dossier Canaux, puis cliquez sur Création > d'un canal émetteur.
      L'assistant de création d'un canal émetteur s'ouvre.
    3. Dans la zone Nom, tapez QM_ORANGE.QM_APPLE, puis cliquez sur Suivant.
    4. Dans la zone Nom de la connexion, entrez le nom de l'ordinateur ou l'adresse IP de la machine réceptrice (vous devez l'avoir demandé à 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 de la file d'attente de transmission, tapez QM_APPLE.
      Le nom de la file d'attente de transmission que vous entrez ici doit correspondre au nom entré pour la file d'attente de transmission dans Création de files d'attente dans le gestionnaire de files d'attente émetteur.
    6. Cliquez sur Terminer.
    7. Cliquez sur le dossier Canaux.
    8. Cliquez avec le bouton droit de votre souris sur QM_ORANGE.QM_APPLE.
    9. Dans le menu en incrustation, cliquez sur Démarrer.
    10. Cliquez sur OK.
      Vous avez créé le canal émetteur sur la machine réceptrice.
      Remarque : Vous n'avez pas à redémarrer le canal récepteur, parce qu'il est démarré automatiquement lorsque vous configurez 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 commencé.
    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 de démarrer le programme d'écoute par défaut IBM MQ. Par défaut, le programme d'écoute écoute sur le port 1414. Si vous avez détecté que le port 1414 est disponible à l'étape c, aucune action n'est requise. 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(numéro_port)
      numéro_port correspond au numéro du port sur lequel le programme d'écoute doit s'exécuter. 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 par défaut IBM MQ 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 commencé.
    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

Maintenant, vous pouvez créer tous les objets IBM MQ nécessaires aux messages à envoyer du gestionnaire de files d'attente émetteur QM_ORANGE à la file d'attente Q1 dans le gestionnaire de files d'attente récepteur QM_APPLE. La tâche suivante consistera à envoyer un message de test.