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.
Le client de scriptage wsadmin est exécuté à partir de Qshell.
Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
- 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')
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
- -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 .
- -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 .
- -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]')