Commande modifySIBMQLink
Use the modifySIBMQLink command to modify the properties of a lien IBM MQ.
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()
Rôle
La commande modifySIBMQLink modifie les propriétés d'une liaison IBM MQ.
Objet cible
Une liaison IBM MQ.
Paramètres obligatoires.
- -bus
- The name of the service integration bus for which you created the 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 avez créé la liaison IBM MQ. Vous pouvez utiliser la commande listSIBEngines pour afficher la liste des noms des moteurs de messagerie existants.
- -name
- Nom de la liaison IBM MQ.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -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.
- -description
- Description facultative du bus à des fins d'administration.
- -exceptionDestination
- Destination d'un message entrant lorsque la liaison IBM 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
- La liaison 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 la liaison est affectée : _SYSTEM.Exception.Destinationmessaging_engine_name.
- Aucun
- La liaison 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 la liaison au même bus. Cette option peut être utilisée pour préserver l'ordre des messages.
- Spécifier
- La liaison IBM MQ utilise la destination d'exception définie ici. Si cette opération est impossible, elle utilise la destination d'exception du système.
- -batchSize
La taille du lot n'affecte pas la manière dont les canaux émetteur et récepteur de cette liaison 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.
Information Value Par défaut 50 Intervalle 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.
Information Value Par défaut 4194304 octets (4 Mo) Intervalle 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.
Information Value Par défaut 300 secondes Intervalle 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.
Information Value Par défaut 999999999 Intervalle De 100 à 999999999 - -nonPersistentMessageSpeed Fast | Normal
Information Value Par défaut Rapide Intervalle - 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
- A property of the lien IBM MQ, which shows whether a running instance of a lien IBM MQ receiver channel
(associated with this lien IBM MQ) should be adopted. In the event of a communications failure, a running
instance of a lien IBM MQ receiver channel might be waiting for messages. When communication is
reestablished, and the partner IBM MQ sender channel next attempts to establish a session with the
lien IBM MQ receiver channel, the request will fail as there is already a running instance of the lien IBM MQ
receiver channel that believes it is in session with the partner lien IBM MQ sender channel. You
can overcome this problem by selecting this option, which causes the already running instance of the
lien IBM MQ receiver channel to be stopped and a new instance to be started.
If you set this option to True, the IBM MQ sender channels might reestablish a connection to this lien IBM MQ in the event that a communications failure has occurred and the link has not yet detected the failure condition.
Information Value Par défaut True - -initialState Started | Stopped
- The state of the lien IBM MQ, which shows
whether the link is started or stopped when the hosting messaging
engine is first started. Until it is started, the lien IBM MQ is unavailable.
Information Value Par défaut Démarré Intervalle - 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.
If this field is blank, the gateway queue manager is assumed to be running on the same host as the messaging engine on which the lien IBM MQ is defined.
- -port
Information Value Par défaut 1414 Intervalle 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 la liaison IBM MQ est définie.
Si vous indiquez le paramètre de liste de connexions, 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.
Information Value Par défaut 900 secondes Intervalle De 0 à 999999 La valeur 0 (zéro) signifie que le canal n'est jamais déconnecté ; il attend indéfiniment des messages.
- -shortRetryCount
Information Value Par défaut 10 Intervalle 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.
Information Value Par défaut 60 secondes Intervalle 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.
Information Value Par défaut 999999999 Intervalle 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.
Information Value Par défaut 1200 secondes Intervalle De 0 à 999999 - -senderChannelInitialState Started | Stopped
- The state of the lien IBM MQ, which shows whether the sender
channel is started or stopped when the associated lien IBM MQ is first started. Jusqu'à son démarrage, le canal est indisponible.
Information Value Par défaut Démarré Intervalle - 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.
Information Value Par défaut Fiable Intervalle - 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
- Fiable
- Les messages sont éliminés lorsqu'un moteur de messagerie s'arrête ou échoue.
- -inboundPersistentReliability Reliable | Assured
Information Value Par défaut Assuré Intervalle - Fiable
- Les messages peuvent être éliminés lorsqu'un moteur de messagerie échoue.
- Assuré
- Les messages ne sont pas éliminés.
- -receiverChannelInitialState Started | Stopped
- The state of the lien IBM MQ, which shows
whether the receiver channel is started or stopped when the associated lien IBM MQ is first started. Jusqu'à son démarrage, le canal est indisponible.
Information Value Par défaut Démarré Intervalle - 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 la liaison 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 qu'elle, le cas échéant. La liaison doit être détenue par
un moteur de messagerie s'exécutant sur WebSphere
Application Server version 7.0 ou ultérieure.
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 ServerVersion 7.0 ou ultérieures et connectée à un moteur de messagerie exécuté sur un serveur WebSphere Application ServerVersion 7.0 ou ultérieures. L'utilisation sur des versions antérieures de WebSphere Application Server entraîne une exception de l'application.
Information Value Par défaut TRUE Intervalle - 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 la liaison, le cas échéant.
- FALSE
- Envoie les messages entrants à tous les points de file d'attente des destinations cible.
Exemples
Show the properties of a lien IBM MQ, modify the link to change the batch size, then show the properties of the link again.
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=50, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
wsadmin>AdminTask.modifySIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-name myMQLink -batchSize 100]')
'myMQLink(cells/cell01/nodes/node01/servers/server1|sib-engines.xml#SIBMQLink_1132608724468)'
wsadmin>AdminTask.showSIBMQLink('[-bus myBus -messagingEngine myHostNode01.server1-myBus
-mqLink myMQLink]')
'{nonPersistentMessageSpeed=FAST, qmName=myBus, adoptable=false, sequenceWrap=999999999,
name=myMQLink, targetUuid=738AE126B908E5451A3D4691, initialState=STARTED,
senderChannel=null, brokerProfile=[], receiverChannel=null, preferLocalQueuePoints=true,
batchSize=100, uuid=6B89C4F08AB072C5, heartBeat=300, description=null, maxMsgSize=4194304,
exceptionDestination=_SYSTEM.Exception.Destination.myHostNode01.server1-myBus}'
wsadmin>
Modify a lien IBM MQ so that the link has no preference for which queue points to use.
wsadmin>AdminTask.modifySIBMQLink('[-bus Bus1 -messagingEngine
node1.node1server1-Bus1 -name MQLink -queueManagerName QM2 -preferLocal FALSE]')
wsadmin>