Commande createSIBWMQServer
La commande createSIBWMQServer permet de créer un serveur IBM MQ dans la portée d'une cellule.
Vous pouvez créer un serveur IBM MQ à l'aide l'outil wsadmin, comme décrit dans cette rubrique, ou de la console d'administration, comme décrit dans Création d'une définition de serveur IBM MQ.
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
Objet cible
Une cellule WebSphere Application Server.
Paramètres obligatoires.
- -name
- Nom du serveur IBM MQ. Cette valeur est réservée à l'administration et son choix dépend de l'administrateur. Ce nom n'est pertinent qu'au sein-même de l'administration WebSphere Application Server et doit être unique au niveau de la cellule. Il n'existe pas de valeur par défaut. Ce paramètre n'est pas modifiable.
- -serverName
- Nom du gestionnaire de files d'attente ou du groupe de partage de files d'attente. Il identifie le gestionnaire de files d'attente ou le groupe de partage de files d'attente et est attribué par l'administration IBM MQ à l'objet IBM MQ concerné. L'administrateur de WebSphere Application Server doit toujours utiliser le nom attribué par l'administration IBM MQ.
- -host
- Hôte vers lequel une connexion est établie pour permettre la
communication avec un gestionnaire de files d'attente ou un groupe de partage
de files d'attente. Cette valeur est le nom d'hôte ou l'adresse IP du
gestionnaire de files d'attente ou du groupe de partage de files d'attente que
ce serveur IBM MQ représente. Il s'agit de l'une des chaînes suivantes :
- Nom d'hôte symbolique
- Adresse IPv4
- Adresse IPv6
- -transportChain
- Chaîne de transport sortante de structure de canal utilisée pour établir une connexion à IBM MQ. Si vous n'indiquez pas cette option, une valeur par défaut de OutboundBasicWMQClient est prise en compte.
Paramètres conditionnels
Aucune
Paramètres facultatifs
Les attributs facultatifs d'hôte, de port, de canal et d'alias d'authentification spécifient le chemin d'accès à la connexion de ce serveur IBM MQ pour les applications de messagerie exécutées dans l'intégration de services. Pour plus d'informations, voir la rubrique Serveur IBM MQ : Connexion et authentification.
- -port
- Numéro du port TCP/IP que le gestionnaire de files d'attente ou le groupe de partage de files d'attente représenté par ce serveur IBM MQ écoute. La valeur par défaut est 1414.
- -channel
- Nom du canal du client IBM MQ à utiliser pour la connexion au gestionnaire de files d'attente ou au groupe de partage de files d'attente représenté par ce serveur IBM MQ. Cette valeur est le nom attribué par l'administration IBM MQ à l'objet IBM MQ, elle doit toujours être utilisée par l'administration WebSphere Application Server. La valeur par défaut est SYSTEM.DEF.SVRCONN.
- -description
- Brève description du serveur IBM MQ. Cette valeur n'est utilisée que pour l'administration.
- -securityAuthAlias
- 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 ne doit pas être confondu avec l'alias d'authentification de la reconnaissance.
- -trustUserIds
- Détermine si les ID utilisateur reçus dans les messages provenant de IBM MQ
sont transmis avec les messages par 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
- 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 est utilisée.
- FALSE
- La reconnaissance automatique n'est pas utilisée.
- -discoveryAuthAlias
- Alias d'authentification à utiliser lors de l'établissement d'une connexion de reconnaissance des ressources au gestionnaire de files d'attente ou au groupe de partage de files d'attente. Cette valeur ne doit pas être confondue avec l'alias d'authentification de sécurité.
- -replyToQueue
- La file d'attente de réponse à utiliser pour la reconnaissance des ressources. Cette valeur est le nom attribué par l'administration IBM MQ à l'objet IBM MQ, il s'agit du nom d'une file d'attente modèle d'une file d'attente dynamique temporaire. L'administrateur de WebSphere Application Server doit toujours utiliser le nom attribué par l'administration IBM MQ. La valeur par défaut est SYSTEM.DEFAULT.MODEL.QUEUE.
- -type
- Détermine si l'objet serveur IBM MQ est un gestionnaire de files d'attente
ou un groupe de partage de files d'attente, selon l'administration WebSphere
Application Server.
Il peut avoir l'une des valeurs suivantes :
- MQ_QUEUE_MANAGER
- Le serveur IBM MQ représente un gestionnaire de files d'attente. Si vous sélectionnez cette valeur, la procédure de reconnaissance des ressources extrait les noms de files d'attente faisant partie des gestionnaires de files d'attente.
- MQ_QUEUE_SHARING_GROUP
- Le serveur IBM MQ représente un groupe de partage de files d'attente. Si vous sélectionnez cette valeur, la procédure de reconnaissance des ressources extrait les noms de files d'attente faisant partie des groupes de partage de files d'attente.
- -bindingsMode
- Ce paramètre 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 disponible si le serveur d'applications et le gestionnaire de files d'attente se trouvent sur le même noeud. Le mode liaison n'est possible que pour une connexion à 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é.
Exemple
- En langage
Jython :
wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", "-host", "findep01.ibm.com", "-port", 1414, "-transportChain", "OutboundSecureWMQClient"])
- Avec Jacl :
wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" -serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true -host findep01.ibm.com -port 1414 -transportChain OutboundSecureWMQClient}