Commande createSIBMQLink

La commande createSIBMQLink permet de créer un lien IBM MQ pour un bus d'intégration de services spécifié.

Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.

[IBM i][IBM i]Le client de scriptage wsadmin est exécuté à partir de Qshell. [IBM i]Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.

L'aide de la ligne de commande est fournie pour les commandes de bus d'intégration de services :
  • Pour obtenir une liste des commandes de bus d'intégration de services disponibles dans Jython et une brève description de chacune d'elles, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('SIBAdminCommands')

  • Pour obtenir une aide générale sur une commande donnée, entrez la commande suivante à l'invite wsadmin :

    print AdminTask.help('nom_commande')

Après avoir utilisé ces commandes, sauvegardez les modifications apportées à la configuration maîtresse en exécutant la commande suivante :

AdminConfig.save()

Fonction

La commande createSIBMQLink permet de créer un lien IBM MQ pour un bus d'intégration de services spécifié. Le lien IBM MQ connecte un moteur de messagerie en tant que gestionnaire de files d'attente à IBM MQ, créant ainsi un pont entre un bus d'intégration de services et un réseau IBM MQ.

Objet cible

Un bus.

Paramètres requis

-bus
Nom du bus d'intégration de services pour lequel vous souhaitez créer le lien IBM MQ. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
-messagingEngine
Nom du moteur de messagerie pour lequel vous souhaitez créer le lien IBM MQ. Le lien IBM MQ connecte un moteur de messagerie en tant que gestionnaire de files d'attente à IBM MQ, créant ainsi un pont entre un bus d'intégration de services et un réseau IBM MQ.
-name
Nom sous lequel vous souhaitez que le lien IBM MQ soit connu.
-foreignBusName
Nom du bus externe qui définit le réseau IBM MQ pour le lien IBM MQ. Vous pouvez utiliser la commande listSIBForeignBuses pour afficher la liste des noms des bus externes existants.
-queueManagerName
Nom du gestionnaire de files d'attente virtuel associé au moteur de messagerie, et sous lequel le moteur de messagerie est identifié sur un réseau IBM MQ distant.

Le nom du gestionnaire de files d'attente doit respecter les conventions de dénomination de IBM MQ ; par exemple, il ne doit pas dépasser 48 caractères.

-senderChannelTransportChain OutboundBasicMQLink | OutboundSecureMQLink
Nom du canal émetteur qui envoie des messages au gestionnaire de files d'attente de passerelle. Le canal émetteur communique avec un canal récepteur IBM MQ sur le gestionnaire de files d'attente de passerelle, puis convertit les messages de bus d'intégration de services en messages au format MQ.

Paramètres conditionnels

Aucun

Paramètres facultatifs

Paramètres de configuration de lien IBM MQ :
-description
Description facultative du bus à des fins d'administration.
-exceptionDestination
Destination d'un message entrant lorsque le lienIBM MQ ne peut pas remettre le message à sa destination de bus cible ou à la destination d'exception configurée pour la destination cible ou lorsque la destination cible n'existe pas.
Système
Le lien IBM MQ utilise la destination d'exception par défaut. Les messages qui ne peuvent pas être remis à la destination de bus sont reroutés automatiquement vers la destination d'exception par défaut du système du moteur de messagerie auquel le lien est affecté : _SYSTEM.Exception.Destinationmessaging_engine_name.
Aucun
Le lien IBM MQ n'a pas de destination d'exception. Les messages qui ne peuvent pas être distribués ne sont pas reroutés vers une destination d'exception et peuvent bloquer le traitement des autres messages en attente de remise via le lien au même bus. Cette option peut être utilisée pour préserver l'ordre des messages.
Spécifier
Le lien IBM MQ utilise la destination d'exception définie ici. Si cette opération est impossible, il utilise la destion d'exception du système.
-batchSize

La taille du lot n'affecte pas la manière dont les canaux émetteur et récepteur de ce lien transfèrent les messages. Les messages sont toujours transférés individuellement, mais sont validés ou sauvegardés par lot.

Pour plus d'informations sur le choix de la taille de lot, voir la description de la propriété BATCHSZ dans la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 50
Plage 1 à 9999
-maxMsgSize

Pour plus d'informations sur le choix de la valeur appropriée, voir la description de la propriété MAXMSGL dans la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 4194304 octets (4 Mo)
Plage De 0 à 104857600

Indiquez 0 pour utiliser la valeur la plus élevée acceptée par le gestionnaire de files d'attente cible.

-heartBeat

Le signal de présence permet au canal récepteur de mettre sa connexion au repos .

Pour plus d'informations sur le choix de la valeur de cette propriété, voir la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 300 secondes
Plage De 0 à 999999
-sequenceWrap
Par exemple, si vous indiquez la valeur 1 000, le numéro de séquence de message démarre à nouveau à 1 lorsqu'il atteint 1 001.

Pour plus d'informations sur le choix de la valeur de cette propriété, voir la description de la propriété SEQWRAP dans la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 999999999
Plage De 1 à 999999999
-nonPersistentMessageSpeed Fast | Normal
Informations Valeur
Par défaut Rapide
Plage
Rapide
Les messages non persistants peuvent être perdus en cas d'échec de transmission ou si le canal s'arrête lorsque les messages sont en transit.
Normal
Les messages non persistants ne sont pas perdus en cas d'échec de transmission ou si le canal s'arrête lorsque les messages sont en transit.
-adoptable True | False
Propriété du lien IBM MQ qui indique si une instance en cours d'un canal récepteur de lien IBM MQ (associé à ce lien IBM MQ) doit être adoptée. En cas d'échec des communications, une instance en cours d'un canal récepteur de lien IBM MQ pourrait être en attente de messages. Lorsque la communication est rétablie et que le canal émetteur IBM MQ partenaire tente de nouveau d'établir une session avec le canal récepteur de lien IBM MQ, la demande échoue, car il existe déjà une instance active du canal récepteur de lien IBM MQ qui pense qu'elle est en session avec le canal émetteur IBM MQ partenaire. Vous pouvez résoudre cet incident en sélectionnant cette option qui provoque l'arrêt de l'instance active du canal récepteur de lien IBM MQ et démarre une nouvelle instance.

Si vous attribuez la valeur True à cette option, les canaux émetteurs de IBM MQ ont la possibilité de rétablir une connexion à ce lien IBM MQ en cas d'échec de communication si le lien n'a pas encore détecté la condition d'échec.

Informations Valeur
Par défaut True
-initialState Started | Stopped
Etat du lien IBM MQ, qui indique si ce dernier est démarré ou arrêté lors du premier démarrage du moteur de messagerie d'hébergement. Jusqu'à son démarrage, le lien IBM MQ est indisponible.
Informations Valeur
Par défaut Démarré
Plage
Arrêté
When the associated messaging engine is started, the lien IBM MQ is in a stopped state and cannot communicate with the IBM MQ .
Démarré
When the associated messaging engine is started, the lien IBM MQ is started automatically and is enabled for communication with the IBM MQ .
Paramètres du canal émetteur de lien IBM MQ :
-senderChannelName

Ce nom doit correspondre au nom du canal récepteur sur IBM MQ.

Pour plus d'informations sur le choix du nom des canaux, voir la description de la propriété CHANNEL dans la section Intercommunication du centre de documentation de IBM MQ.

-hostName
Nom d'hôte ou adresse TCP/IP du gestionnaire de files d'attente de passerelle utilisé pour se connecter au réseau IBM MQ.

Entrez le nom d'hôte ou l'adresse IP de l'hôte sur lequel est exécuté le gestionnaire de files d'attente de passerelle.

Si cette zone est vide, cela signifie que le gestionnaire de files d'attente de passerelle est exécuté sur le même hôte que le moteur de messagerie sur lequel le lien IBM MQ est défini.

-port
Informations Valeur
Par défaut 1414
Plage De 0 à 65535
-connameList
Liste de noms de connexion du gestionnaire de file d'attente de passerelle qui est utilisé pour la connexion au réseau IBM MQ. Les tentatives de connexion se font dans l'ordre où les connexions sont indiquées dans la liste de noms de connexion jusqu'à ce qu'une connexion soit établie. Si aucune connexion n'aboutit, le canal relance le traitement.

Les noms de connexion de la liste doivent être séparés par des virgules au format suivant :

Dnsname1(portnumber1) , Dnsname2(portnumber2)

Entrez le nom de serveur de noms de domaine ou l'adresse IP de l'hôte sur lequel est exécuté le gestionnaire de file d'attente de passerelle. Entrez un numéro de port compris entre 0 et 65535.

Si vous n'indiquez pas de paramètre de liste de noms de connexion, l'on considère que le gestionnaire de file d'attente de passerelle s'exécute sur le même hôte que le moteur de messagerie sur lequel le lien IBM MQ est défini.

Si vous indiquez le paramètre de liste de noms de connexion, vous devez avoir déjà spécifié une valeur pour le paramètre de nom de canal émetteur, faute de quoi, la valeur que vous affectez au paramètre de liste de noms de connexion n'est pas prise en compte.

Si vous spécifiez le paramètre de nom d'hôte et de port, ainsi que le paramètre de liste de noms de connexion, la valeur de ce dernier est utilisée en priorité lors de l'exécution et les valeurs de nom d'hôte et de port ne sont pas prises en compte.

-discInterval

La valeur par défaut est un intervalle raisonnable. Ne modifiez cette valeur que si vous en connaissez l'impact sur les performances et que vous avez besoin d'une autre valeur pour satisfaire les exigences de trafic sur vos canaux.

Les performances sont affectées par la valeur spécifiée pour l'intervalle de déconnexion. Une valeur très faible (quelques secondes) peut nécessiter un nombre inacceptable de ressources car le canal est constamment démarré. Une valeur très élevée (plus d'une heure) peut signifier que les ressources système sont bloquées inutilement.

Si vous voulez que vos canaux ne soient actifs que lorsqu'ils doivent transmettre des messages, vous devez choisir un intervalle de déconnexion relativement faible. Notez que le paramètre par défaut est assez élevé et qu'il n'est donc pas recommandé pour les canaux nécessitant ce niveau de contrôle. Comme il est difficile d'interrompre le canal récepteur, l'option la plus rentable consiste à déconnecter et reconnecter automatiquement le canal en fonction de la demande de la charge de travail. Pour certains canaux, l'intervalle de déconnexion approprié peut être établi de manière heuristique.

Informations Valeur
Par défaut 900 secondes
Plage De 0 à 999999

La valeur 0 (zéro) signifie que le canal n'est jamais déconnecté ; il attend indéfiniment des messages.

-shortRetryCount

Pour plus d'informations sur l'utilisation des mécanismes de tentatives avec IBM MQ, voir la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 10
Plage De 0 à 999999999
-shortRetryInterval

Pour plus d'informations sur l'utilisation des mécanismes de tentatives avec IBM MQ, voir la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 60 secondes
Plage De 0 à 999999
-longRetryCount

Pour plus d'informations sur l'utilisation des mécanismes de tentatives avec IBM MQ, voir la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 999999999
Plage De 0 à 999999999
-longRetryInterval

Pour plus d'informations sur l'utilisation des mécanismes de tentatives avec IBM MQ, voir la section Intercommunication du centre de documentation de IBM MQ.

Informations Valeur
Par défaut 1200 secondes
Plage De 0 à 999999
-senderChannelInitialState Started | Stopped
Etat du lien IBM MQ qui indique si le canal émetteur est démarré ou arrêté lors du premier démarrage du lien IBM MQ associé. Jusqu'à son démarrage, le canal est indisponible.
Informations Valeur
Par défaut Démarré
Plage
Arrêté
When the associated messaging engine is started, the lien IBM MQ is in a stopped state and cannot communicate with the IBM MQ .
Démarré
When the associated messaging engine is started, the lien IBM MQ is started automatically and is enabled for communication with the IBM MQ .
Paramètres du canal récepteur de lien IBM MQ :
-receiverChannelName

Ce nom doit être identique à celui du canal émetteur de IBM MQ.

-inboundNonPersistentReliability Best effort | Reliable

Cette option de distribution fiable est affectée à tous les messages IBM MQ non persistants qui passent par ce canal récepteur.

Informations Valeur
Par défaut Fiable
Plage
Tentatives
Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue. Les messages peuvent également être éliminés si une connexion utilisée pour les envoyer devient indisponible ou si les ressources systèmes sont soumises à des contraintes.
Express
Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue. Les messages peuvent également être éliminés si une connexion utilisée pour les envoyer devient non disponible.
Fiable
Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue.
-inboundPersistentReliability Reliable | Assured
Informations Valeur
Par défaut Assuré
Plage
Fiable
Les messages peuvent être éliminés lorsqu'un moteur de messagerie échoue.
Assuré
Les messages ne sont pas éliminés.
-receiverChannelInitialState Started | Stopped
Etat du lien IBM MQ qui indique si le canal récepeteur est démarré ou arrêté lors du premier démarrage du lien IBM MQ associé. Jusqu'à son démarrage, le canal est indisponible.
Informations Valeur
Par défaut Démarré
Plage
Arrêté
When the associated messaging engine is started, the lien IBM MQ is in a stopped state and cannot communicate with the IBM MQ .
Démarré
When the associated messaging engine is started, the lien IBM MQ is started automatically and is enabled for communication with the IBM MQ .
-preferLocal TRUE | FALSE
Cette option indique que le lien préfère envoyer des messages entrants au point de file d'attente de la destination cible située sur le même moteur de messagerie que lui, le cas échéant. Le lien doit être détenu par un moteur de messagerie qui s'exécute sur un serveur WebSphere Application Server Version 7.0 ou ultérieures.

Cette option est prise en charge uniquement si elle est utilisée par une application JMS qui est exécutée avec un serveur ou un client WebSphere Application Server Version 7.0 ou ultérieures et connectée à un moteur de messagerie exécuté sur un serveur WebSphere Application Server Version 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.

Informations Valeur
Par défaut TRUE
Plage
TRUE
Envoie chaque message entrant au point de file d'attente de la destination cible située sur le même moteur de messagerie que le lien, le cas échéant.
FALSE
Envoie les messages entrants à tous les points de file d'attente des destinations cible.

Exemples

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name myMQLink2 -foreignBusName MQNetwork2 -queueManagerName MQMgrIPL 
-senderChannelTransportChain OutboundBasicMQLink]')
'myMQLink2(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#
SIBMQLink_1132607756126)'

Créez un SIBMQLink utilisant les points de file d'attente sur le même moteur de messagerie que la destination cible, à chaque fois que cela est possible.

AdminTask.createSIBMQLink('[-bus bus1 -messagingEngine cluster1.000-bus1 
-name MyMQLink -foreignBusName -MQQMgr1 -queueManagerName bus1 
-senderChannelTransportChain OutboundBasicMQLink  -preferLocal TRUE]')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjj_mqlink_create
Nom du fichier : rjj_mqlink_create.html