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.

[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

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.
La valeur par défaut est TRUE.

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}

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=rjfp_cli_mqserver_busm_mod
Nom du fichier : rjfp_cli_mqserver_busm_mod.html