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.

[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 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')

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

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.

Cette commande crée les ressources suivantes :
  • 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é.
Les modalités d'utilisation de cette commande varie en fonction de la topologie dans laquelle la commande est exécutée. La topologie détermine les paramètres conditionnels que vous indiquez :
  • 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
Si le type de service est Version 7.0, ne spécifiez pas les paramètres facultatifs suivants, qui concernent la configuration JAX-RPC :
-eplName
-eplURLRoot
-eplWSDLServingURLRoot
Si le type de service est Version 6.1, ne spécifiez pas les paramètres facultatifs suivants, qui concernent la configuration JAX-WS :
-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 :
protocole://nom_hôtenuméro_port/emplacement_service
protocole a la valeur http ou https. Exemple :
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"] )

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