Commande modifySIBEngine
La commande modifySIBEngine permet de modifier les propriétés d'un moteur de messagerie pour le membre d'un bus d'intégration de services.
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
Cette commande modifie les propriétés d'un moteur de messagerie.
Objet cible
Moteur de messagerie.
Paramètres requis
- -bus nombus
- Nom du bus d'intégration de services sur lequel le membre de bus est configuré. Vous pouvez utiliser la commande listSIBuses pour afficher la liste des noms des bus existants.
Paramètres conditionnels
- -node nom_noeud-server nom_serveur
- Pour modifier les propriétés d'un moteur de messagerie d'un serveur d'applications membre d'un bus, indiquez le nom du noeud sur lequel le serveur est exécuté et le nom du serveur.
- -cluster cluster
- Pour modifier les propriétés d'un moteur de messagerie pour un cluster de serveurs membre d'un bus, indiquez le nom du cluster.
- -engine nommoteur
- Si le membre du bus ne comporte qu'un moteur de messagerie, vous n'avez pas besoin d'indiquer le nom du moteur. Si le membre de bus possède plusieurs moteurs de messagerie, vous devez indiquer le nom du moteur dont vous voulez modifier les propriétés.
Paramètres optionnels
- -description texte
- Description facultative du moteur de messagerie à des fins administratives.
- -initialState STARTED | STOPPED
- Etat initial déterminant si le moteur de messagerie est démarré automatiquement au démarrage du serveur ou du cluster de serveurs.
- Arrêté
- Lorsque le serveur d'applications associé est démarré, le moteur de messagerie est arrêté et n'est pas disponible pour traiter les messages.
- Démarré
- Lorsque le serveur d'applications associé est démarré, le moteur de messagerie l'est également et devient disponible pour traiter les messages.
- -highMessageThreshold nombre
- Nombre maximal de messages que le moteur de messagerie peut placer sur son point de
message.
Lorsque le moteur de messagerie est créé, le seuil élevé des messages du bus est utilisé pour définir la valeur par défaut de cette propriété. Lorsqu'un point de message est créé sur ce moteur de messagerie, la valeur de cette propriété est utilisée pour définir le seuil supérieur des messages par défaut du point de message.
- -restrictLongDBLock TRUE | FALSE
- Paramètre indiquant si le moteur de messagerie actif doit conserver des verrous de longue durée sur la table SIBOWNER de la base de données.
Si vous sélectionnez cette option, le moteur de messagerie verrouille la base
de données uniquement pendant de courtes périodes. Lorsque le moteur de messagerie
actif ne répond pas à la base de données, celui de secours pourra
en devenir propriétaire car les verrous établis par le moteur de messagerie actif
ne sont que de courte durée. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Restreindre les verrous de longue durée sur la base de données.
- FALSE
- Ne pas restreindre les verrous de longue durée sur la base de données.
Utilisez ce paramètre si le paramètre -dataStore est indiqué.
Important : Bien que la propriété soit sélectionnée, elle ne sera pas effective tant que les tables de base de données ne seront pas mises à niveau à l'aide de la commande sibDBUpgrade pour WebSphere Application Server Version 9.0 et versions ultérieures.
Exemple
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STARTED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'
wsadmin>AdminTask.modifySIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 -initialState STOPPED ]')
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STOPPED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'