Commande modifySIBWMQServerBusMember
Use the modifySIBWMQServerBusMember command to modify the attributes of a IBM MQ server bus member.
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.
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
Un membre de bus de serveur IBM MQ est utilisé pour attribuer des points de file d'attente et de médiation aux files d'attentes IBM MQ. Cette commande permet de modifier les attributs d'un membre du bus du serveur IBM MQ.
Objet cible
Un membre du bus du serveur IBM MQ sélectionné.
Paramètres obligatoires.
- -name
- Cette valeur est le nom indiqué dans le paramètre -name lors de la création de la définition du serveur IBM MQ.
- -bus
- Nom du bus d'intégration de services dont le serveur IBM MQ est membre.
Paramètres conditionnels
Aucune
Paramètres optionnels
- -virtualQueueManagerName
- Lors de l'envoi de messages à IBM MQ, le gestionnaire de files d'attente de passerelle IBM MQ considère le bus comme un gestionnaire de files d'attente éloignées. Le nom du gestionnaire de files d'attente
virtuelles est celui qui est transmis à IBM MQ en tant que nom de ce gestionnaire de files d'attente éloignées. La valeur par défaut est le nom du bus d'intégration de services. Si ce nom de bus n'est pas un nom valide pour un gestionnaire de files d'attente IBM MQ, ou si un autre gestionnaire de files d'attente IBM MQ porte déjà le même nom, remplacez la valeur par défaut par un nom valide et unique pour un gestionnaire de files d'attente IBM MQ.
- Il doit comporter entre 1 et 48 caractères.
- Il doit être conforme aux conventions de dénomination de file d'attente IBM MQ (voir la rubrique Rules for naming IBM MQ objects dans le centre de documentation IBM MQ).
- -host
- Nouvelle valeur de l'attribut host remplacé.
Cette valeur est le nom ou l'adresse IP de l'hôte
vers lequel une connexion est établie lors de la communication avec un gestionnaire de files
d'attente ou un groupe de partage de files d'attente représenté par ce serveur IBM MQ.
Cette valeur correspond à une chaîne d'une des valeurs suivantes :
- Nom d'hôte symbolique
- Adresse IPv4
- Adresse IPv6
- -port
- Nouvelle valeur de l'attribut port remplacé. Cette valeur correspond au numéro de port TCP/IP sur lequel le gestionnaire de files d'attente, ou le groupe de partage de files d'attente représenté par ce serveur IBM MQ est à l'écoute. La valeur par défaut est 1414.
- -channel
- Nouvelle valeur de l'attribut de canal remplacé. Cette valeur correspond au nom du canal du client IBM MQ à utiliser lors de la connexion au gestionnaire de files d'attente ou au groupe de partage de files d'attente représenté par ce serveur IBM MQ. La valeur par défaut est SYSTEM.DEF.SVRCONN.
- -securityAuthAlias
- Nouvelle valeur de l'attribut securityAuthAlias remplacé. Il s'agit de l'alias d'authentification à utiliser lors de la connexion à un gestionnaire de files d'attente ou à un groupe de partage de files d'attente. Ce paramètre diffère de l'alias d'authentification de la reconnaissance.
- -transportChain
- Nouvelle valeur de l'attribut transportChain remplacé. Cette valeur est la chaîne de transport sortante à utiliser pour établir une connexion à IBM MQ. La valeur par défaut est OutboundBasicWMQClient.
- -trustUserIds TRUE | FALSE
- Nouvelle valeur de l'attribut trustUserIds remplacé.
Cette valeur permet de déterminer si les identifiants d'utilisateur reçus dans les messages
à partir de IBM MQ sont propagés
dans le message (c'est-à-dire si les identifiants d'utilisateur reçus
comme faisant partie des données du message sont utilisés dans le bus d'intégration
des services). L'ID utilisateur de l'application est toujours défini à partir de la valeur jsAppUserId RFH2. Si cette valeur est absente (soit parce que la paire clé/valeur
est absente de l'en-tête RFH2 ou que le message ne comporte pas d'en-tête RFH2), cette zone ne sera pas définie. Si vous lui attribuez la valeur FALSE, l'ID utilisateur est remplacé par le nom du serveur IBM MQ. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- Les ID utilisateur sont propagés dans les messages.
- FALSE
- Les ID utilisateur ne sont pas propagés dans les messages.
Exemple
- En langage
Jython :
wsadmin>AdminTask.modifySIBWMQServerBusMember(["-name", "Finance dept QM-Bus1", "-bus", "Bus1", "-trustUserIds", "false"])
- Avec Jacl :
wsadmin>$AdminTask modifySIBWMQServerBusMember {-name "Finance dept QM-Bus1" -bus Bus1 -trustUserIds false}