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.

[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 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. Cette commande crée un serveur IBM MQ dans la portée d'une cellule à l'aide des valeurs fournies pour ses paramètres.
Remarque : Lors de la création d'un serveur IBM MQ, il est important de connaître la signification des paramètres -name et -serverName. Par exemple, si l'administration de WebSphere Application Server crée un objet serveur IBM MQ appelé "Serveur de la zone européenne" qui représente un gestionnaire de files d'attente IBM MQ dont la valeur de l'attribut serverName est QM1. L'administrateur WebSphere Application Server peut alors créer un second objet serveur IBM MQ appelé "Serveur français" qui représente également le même gestionnaire de files d'attente IBM MQ avec l'attribut serverName QM1.

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

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_create
Nom du fichier : rjfp_cli_mqserver_create.html