Commande modifySIBWMQServer
Use the modifySIBWMQServer command to modify a IBM MQ server.
You can modify a IBM MQ server by using the wsadmin tool as described in this topic, or by using the administrative console as described in Modifying an IBM MQ server definition.
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
Un serveur IBM MQ représente un gestionnaire de files d'attente IBM MQ ou (pour IBM MQ for z/OS) un groupe de partage de files d'attente. This command modifies a IBM MQ server. Il n'est pas possible de modifier les attributs de nom ou de type avec cette commande.
Objet cible
A selected IBM MQ server.
Paramètres obligatoires.
- -name
- Nom du serveur IBM MQ. The name is specified when creating the IBM MQ server definition.
Paramètres conditionnels
Aucune
Paramètres optionnels
- -serverName
- Nom du gestionnaire de files d'attente ou du groupe de partage de files d'attente. Il s'agit du nom à l'aide duquel ils sont identifiés. Cette valeur est attribuée par l'administration IBM MQ administration à la ressource IBM MQ concernée. L'administrateur utilise toujours le nom attribué par l'administration IBM MQ.
- -host
- Nouvelle valeur de l'attribut host. This value
is the name or the IP address of the host to which a connection is
established when communicating with a queue manager or queue-sharing
group that this IBM MQ server represents. Il s'agit de l'une des chaînes suivantes :
- Nom d'hôte symbolique
- Adresse IPv4
- Adresse IPv6
- -bindingsMode
- Nouvelle valeur de l'attribut bindingsMode.
Cette valeur indique si un transport en mode liaison est utilisé lors de la connexion à un gestionnaire de files d'attente ou à un groupe de partage de files d'attente.
La connexion en mode liaison est possible si le serveur d'applications et le gestionnaire de files d'attente se trouvent sur le même noeud, mais la connexion n'est admise que vers un seul gestionnaire de files d'attente, même si plusieurs gestionnaires de files d'attente coexistent sur le même noeud. Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- S'il est disponible, le mode liaison est utilisé. Si vous sélectionnez cette option alors que le mode liaison est indisponible, les mécanismes de connexion utilisent par défaut le transport en mode client.
- FALSE
- Le mode client est toujours utilisé.
- -port
- Nouvelle valeur de l'attribut IBM MQ port. 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 IBM MQ channel. This value is the IBM MQ client channel name to use when connecting to the queue manager or queue sharing group that this IBM MQ server represents. Ce nom est attribué par l'administration IBM MQ à l'objet IBM MQ et doit toujours être utilisé par l'administrateur de WebSphere Application Server. La valeur par défaut est SYSTEM.DEF.SVRCONN.
- -description
- Nouvelle valeur de l'attribut description. This value is a short description of the IBM MQ server, and is used for administrative purposes only.
- -securityAuthAlias
- Nouvelle valeur de l'attribut securityAuthorizationAlias. 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. Cette valeur est la chaîne de transport sortante à utiliser pour établir une connexion à IBM MQ. La valeur par défaut est OutboundBasicWMQClient.
- -trustUserIds
- Nouvelle valeur de l'attribut trustUserIds.
Ce paramètre détermine si les ID utilisateur reçus dans les messages provenant de IBM MQ sont propagés ou non dans le message
(c'est-à-dire si les ID utilisateur faisant partie des données de message sont utilisés dans le bus d'intégration de 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.
- -allowDiscovery
- Nouvelle valeur de l'attribut allowDiscovery.
Ce paramètre indique si la reconnaissance automatique des ressources IBM MQ a lieu.
Ce paramètre peut avoir l'une des valeurs suivantes :
- TRUE
- La reconnaissance automatique des ressources est activée.
- FALSE
- La reconnaissance automatique des ressources est désactivée.
- -discoveryAuthAlias
- Nouvelle valeur de l'attribut discoveryAuthAlias. Il s'agit de l'alias d'authentification à utiliser lors de l'établissement d'une connexion de reconnaissance des ressources à un gestionnaire de files d'attente ou à un groupe de partage de files d'attente, il diffère du paramètre d'alias d'authentification de sécurité.
- -replyToQueue
- Nouvelle valeur de l'attribut replyToQueue. Cette valeur est la file d'attente de réponse à utiliser pour la reconnaissance des ressources, le nom attribué par l'administration IBM MQ à l'objet IBM MQ et le nom d'une file d'attente modèle d'une file d'attente dynamique temporaire. L'administration WebSphere Application Server doit toujours utiliser le nom déterminé en accord avec l'administration IBM MQ. La valeur par défaut est SYSTEM.DEFAULT.MODEL.QUEUE.
Exemple
- En langage
Jython :
wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM", "-allowDiscovery", "false"] )
- Avec Jacl :
wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM" -allowDiscovery false}