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.

[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()

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

lien IBM MQ configuration parameters:
-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 .
lien IBM MQ sender channel parameters:
-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 .
lien IBM MQ receiver channel parameters:
-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>

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_modify
Nom du fichier : rjj_mqlink_modify.html