Commande createWSNServicePoint
La commande createWSNServicePoint permet de créer un point de service WS-Notification.
Vous pouvez créer un point de service WS-Notification à l'aide l'outil wsadmin, comme décrit dans cette rubrique, ou de la console d'administration, comme décrit dans Création d'un point de service WS-Notification service version 6.1 et Création d'un point de service WS-Notification version 7.0.
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 WS-Notification disponibles et une brève description de chacune d'elles, entrez la commande suivante à l'invite wsadmin :
print AdminTask.help('WSNotificationCommands')
- 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
L'existence d'un point de service WS-Notification sur un membre de bus implique qu'un service Web WS-Notification est exposé à partir de ce membre de bus et entraîne l'exposition des noeuds finaux des services Web du courtier de notification, du gestionnaire des abonnements et du gestionnaire de l'enregistrement des diffuseurs de publications du service WS-Notification, sur le membre de bus auquel le point de service est associé. Les applications WS-Notification utilisent ces points finaux pour communiquer avec le service WS-Notification.
- Elle crée un point de service WS-Notification sur un service WS-Notification.
- Pour un point de service WS-Notification version 7.0, elle expose les noeuds finaux de service Web des trois rôles exécutés par le courtier sur le membre de bus.
- Pour un point de service WS-Notification version 6.1, elle crée les trois ports entrants du bus d'intégration de services qui représentent les trois rôles exécutés par le courtier, elle crée un programme d'écoute de noeud final du bus d'intégration de services si nécessaire et elle connecte le programme d'écoute du noeud final (nouveau ou existant) au bus d'intégration de services avec lequel le service WS-Notification est associé.
- type de membre de bus (serveur ou cluster)
- programme d'écoute de noeud final (création d'un nouveau ou utilisation d'un existant) pour les points de service WS-Notification version 6.1
- -eplName
- -eplURLRoot
- -eplWSDLServingURLRoot
- -transportURLRoot
- -transportSoapVersion
- -jaxwsHandlerListNB
- -jaxwsHandlerListSM
- -jaxwsHandlerListPRM
Vous ne pouvez créer des points de service que pour les services WS-Notification version 7.0 sur des membres de bus WebSphere Application Server Version 7.0 ou ultérieures. Si le membre de bus est un cluster, tous les serveurs de ce cluster doivent être des serveurs d'applications WebSphere Application Server Version 7.0 ou ultérieures.
Vous pouvez créer des points de service pour les services WS-Notification version 6.1 sur des serveurs d'applications WebSphere Application Server Version 6.1 ou versions ultérieures.
Objet cible
WSNService
Paramètres requis
- -name
Paramètres conditionnels
Choisir un serveur ou un cluster pour le membre de bus associé :
- -server
- Nom du serveur sur lequel le point de service WS-Notification est créé.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Si vous utilisez ce paramètre, alors le paramètre noeud doit être indiqué, et le paramètre cluster peut être omis.
- -node
- Nom du noeud sur lequel se trouve le serveur.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Si vous utilisez ce paramètre, alors le paramètre serveur doit être indiqué, et le paramètre cluster peut être omis.
- -cluster
- Nom du cluster sur lequel le point de service WS-Notification est créé.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Si vous utilisez ce paramètre, alors vous pouvez omettre les paramètres serveur et noeud.
Pour un service WS-Notification version 6.1, choisissez de configurer un nouveau programme d'écoute de noeud final ou d'en utiliser un existant :
- -eplName
- Nom d'un programme d'écoute de noeud final.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Si ce programme d'écoute de noeud final a déjà été défini sur le serveur ou cluster choisi, vous devez omettre les paramètres eplURLRoot et eplWSDLServingURLRoot. Sinon, les paramètres eplURLRoot et eplWSDLServingURLRoot doivent l'être tous les deux.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 6.1.
- -eplURLRoot
- Racine de l'adresse URL du noeud final visible en externe des services Web accessibles à l'aide de l'écouteur de noeud final.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Si le programme d'écoute de noeud final a déjà été défini sur le serveur ou cluster choisi, alors vous devez omettre ce paramètre.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 6.1.
- -eplWSDLServingURLRoot
- Racine de l'URL HTTP visible externe sur laquelle se trouve le fichier WSDL
associé à ce programme d'écoute de noeud final. La plupart du temps, il s'agit de
http://nom_hôte:numéro_port/SIBWS.
Pour plus d'informations, voir Création d'une configuration de module d'écoute de noeud final ou Commande createSIBWSEndpointListener.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Si le programme d'écoute de noeud final a déjà été défini sur le serveur ou cluster choisi, alors vous devez omettre ce paramètre.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 6.1.
Pour un service WS-Notification version 7.0, configurez le noeud final du service Web :
- -transportURLRoot
- Racine de l'adresse du noeud final visible en externe pour le point de
service WS-Notification, au format suivant :
où protocole a la valeur http ou https. Exemple :protocole://nom_hôtenuméro_port/emplacement_service
http://myhostname:9080/ctx123/mySvc
- Vous pouvez utiliser ce paramètre pour associer une adresse Web externe particulière au service WS-Notification lorsque vous publiez le document WSDL dans un fichier compressé via la console d'administration. Notez que cette adresse risque de ne pas correspondre à celle à laquelle le service WS-Notification est exposé. Cette adresse est requise lors de l'accès à un service WS-Notification via un proxy.
- Si vous n'indiquez pas ce paramètre, l'implémentation JAX-WS sous-jacente crée une URL appropriée en fonction des informations fournies dans le cadre de la procédure d'installation du point de service.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Cet attribut est l'équivalent du paramètre eplURLRoot pour les points de service créés sur les services WS-Notification version 6.1. Spécifiez ce paramètre uniquement pour les services WS-Notification version 7.0.
- -transportSoapVersion
- Les valeurs autorisées sont 1.1 pour SOAP 1.1 (par défaut) et 1.2 pour SOAP 1.2.
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 7.0.
Copiez la configuration à partir d'une définition de point de service WS-Notification existante :
- -copyServicePoint
- Nom d'un point de service existant configuré sur le service WS-Notification d'où proviennent les autres attributs de configuration qui ont été copiés. Si vous spécifiez ce paramètre, vous devez indiquer uniquement le paramètre nom. Toutes les autres valeurs proviennent du point de service existant sélectionné.
Paramètres optionnels
- -description
- -jaxwsHandlerListNB
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 7.0.
- -jaxwsHandlerListSM
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 7.0.
- -jaxwsHandlerListPRM
- Si vous indiquez le paramètre copyServicePoint, vous pouvez omettre ce paramètre.
- Spécifiez ce paramètre uniquement pour les services WS-Notification version 7.0.
Exemples
Dans les exemples suivants, le point de service WS-Notification utilise le service WS-Notification newService créé dans l'exemple de la rubrique "Création d'un service de notification WS-Notification à l'aide de l'outil wsadmin".
Création d'un point de service WS-Notification version 6.1 sur cluster1 qui utilise l'écouteur de noeud final existant SIBWSHTTPChannel1:
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-cluster", "cluster1", "-eplName", "SIBWSHTTPChannel1"] )
Création d'un point de service WS-Notification version 6.1 sur server1 sous node1 et création d'un modèle d'écoute de noeud final qui utilise SOAP sous le protocole HTTP sur le canal 1, où l'adresse hôte du serveur est http://myHost:9080 :
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1", "-eplName", "myNewEPL",
"-eplURLRoot", "http://myhost:9080/wsn", "-eplWSDLServingURLRoot", "http://myhost:9080/sibws"] )
Créez un point de service WS-Notification version 7.0 sur server1 sur node1 (ensemble de paramètres minimal) :
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1",
"-transportURLRoot", "http://myhost:9080/myWSN"] )
Créez un point de service WS-Notification version 7.0 sur server1 sur node1 (ensemble de paramètres intégral) :
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1",
"-transportURLRoot", "http://myhost:9080/myWSN", "-transportSoapVersion", "1.1",
"-jaxwsHandlerListNB", "nbList", "-jaxwsHandlerListSM", "smList", "-jaxwsHandlerListPRM", "prmList"] )