Mandato createWSNServicePoint
Utilice el mandato createWSNServicePoint para crear un nuevo punto de servicio WS-Notification.
Puede crear un nuevo punto de servicio WS-Notification utilizando la herramienta wsadmin como se describe en este tema, o bien utilizando la consola administrativa como se describe en Creación de un nuevo punto de servicio WS-Notification Versión 6.1 y Creación de un nuevo punto de servicio WS-Notification Versión 7.0.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
Para los mandatos del bus de integración de servicios se proporciona ayuda de línea de mandatos:
- Si desea una lista de los mandatos de WS-Notification disponibles, además de una breve
descripción de cada mandato, escriba el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('WSNotificationCommands')
- Si desea ayuda general sobre un mandato determinado,
especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Finalidad
La existencia de un punto de servicio WS-Notification en un miembro de bus implica que un servicio web WS-Notification está expuesto desde dicho miembro de bus y hace que los puntos finales de servicio web del intermediario de notificaciones, el gestor de suscripciones y el gesto de registros editores para este servicio WS-Notification estén expuestos en el miembro de bus con el que está asociado el punto de servicio. Las aplicaciones WS-Notification utilizan estos puntos finales para interactuar con el servicio WS-Notification.
- Crea un nuevo punto de servicio WS-Notification en un servicio WS-Notification.
- Para un punto de servicio WS-Notification Versión 7.0, hace que los puntos finales del servicio web para los tres roles que desempeña el intermediario se expongan en el miembro de bus.
- Para un punto de servicio WS-Notification Versión 6.1, crea los tres puertos de entrada del bus de integración de servicios que representan los tres roles que desempeña el intermediario, crea un escucha de punto final del bus de integración de servicios, si es necesario, y conecta el escucha de punto final, nuevo o existente, con el bus de integración de servicios al cual está asociado el servicio WS-Notification.
- tipo de miembro del (servidor o clúster)
- escucha de punto final (crear uno nuevo o utilizar uno existente) para los puntos de servicio WS-Notification Versión 6.1
- -eplName
- -eplURLRoot
- -eplWSDLServingURLRoot
- -transportURLRoot
- -transportSoapVersion
- -jaxwsHandlerListNB
- -jaxwsHandlerListSM
- -jaxwsHandlerListPRM
Sólo se pueden crear puntos de servicio para los servicios WS-Notification Versión 7.0 en los miembros de bus de WebSphere Application Server Versión 7.0 o posterior. Si el miembro del bus es un clúster, todos los servidores del clúster deben ser servidores de aplicaciones WebSphere Application Server Versión 7.0 o posterior.
Puede crear puntos de servicio para los servicios WS-Notification Versión 6.1 en los servidores de aplicaciones WebSphere Application Server Versión 6.1 o posterior.
Objeto de destino
WSNService
Parámetros necesarios
- -name
Parámetros condicionales
Elija entre servidor o clúster para el miembro del bus asociado:
- -server
- Nombre del servidor en el cual se crea el punto de servicio WS-Notification.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Si se utiliza este parámetro, se debe especificar el parámetro node, y el parámetro cluster no se debe especificar.
- -node
- El nombre del nodo en el cual se encuentra el servidor.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Si se utiliza este parámetro, se debe especificar el parámetro server y, en cambio, no se debe especificar el parámetro cluster.
- -cluster
- Nombre del clúster en el cual se crea el punto de servicio WS-Notification.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Si se utiliza este parámetro, no deben especificarse los parámetros server y node.
Para un servicio WS-Notification Versión 6.1, elija entre configurar un nuevo escucha de punto final o utilizar uno existente:
- -eplName
- Nombre del escucha de punto final.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Si este escucha de punto final ya ha sido definido en el servidor o clúster seleccionado, no deben especificarse los parámetros eplURLRoot y eplWSDLServingURLRoot. De lo contrario, deben especificarse los parámetros eplURLRoot y eplWSDLServingURLRoot.
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
- -eplURLRoot
- Raíz del URL de dirección del punto final visible externamente para los servicios web a los que se accede mediante este escucha de punto final.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Si ya se ha definido el escucha de punto final en el servidor o clúster, no deberá especificarse este parámetro.
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
- -eplWSDLServingURLRoot
- Raíz del URL HTTP visible externamente donde se encuentra el archivo WSDL asociado con este escucha de punto final. En la mayoría de circunstancias, éste es http://nombre_host:número_puerto/SIBWS.
Para obtener más información, consulte Creación de una configuración de escucha de punto final nueva o Mandato createSIBWSEndpointListener.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Si ya se ha definido el escucha de punto final en el servidor o clúster, no deberá especificarse este parámetro.
- Especifique únicamente este parámetro para los servicios de la Versión 6.1 de WS-Notification.
Para un servicio WS-Notification Versión 7.0, configure el punto final de servicio web:
- -transportURLRoot
- Raíz de la dirección de punto final visible externamente para el punto de servicio WS-Notification, en el siguiente formato:
donde protocolo puede ser http o https. Por ejemplo:protocolo://nombre_hostnúmero_puerto/ubicación_servicio
http://nombre_mi_host:9080/ctx123/mySvc
- Puede utilizar este parámetro para asociar una determinada dirección web externa con el servicio WS-Notification cuando publique WSDL en un archivo comprimido mediante la consola administrativa. Tenga en cuenta que esta dirección podría no ser la misma que la dirección en la que está expuesto el servicio WS-Notification. Esta dirección es obligatorio cuando se accede al servicio WS-Notification a través de un servidor proxy.
- Si no especifica este parámetro, la implementación JAX-WS subyacente crea un URL apropiado a partir de la información proporcionada como parte del proceso de instalación del punto de servicio.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Este atributo es equivalente al parámetro eplURLRoot para los puntos de servicio creados en los servicios WS-Notification Versión 6.1. Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
- -transportSoapVersion
- Los valores permitidos son 1.1 para SOAP 1.1 (el valor predeterminado) y 1.2 para SOAP 1.2.
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
Copie la configuración de una definición de punto de servicio WS-Notification existente:
- -copyServicePoint
- El nombre de un punto de servicio existente configurado en WS-Notification Service del cual se copian otros atributos de configuración. Si especifica este parámetro, sólo tendrá que especificar el parámetro name. Todos los demás valores se extraen del punto de servicio existente designado.
Parámetros opcionales
- -description
- -jaxwsHandlerListNB
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
- -jaxwsHandlerListSM
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
- -jaxwsHandlerListPRM
- Si especifica el parámetro copyServicePoint, no tendrá que especificar este parámetro.
- Especifique únicamente este parámetro para los servicios de la Versión 7.0 de WS-Notification.
Ejemplos
En los ejemplos siguientes, el punto de servicio WS-Notification utiliza el servicio WS-Notification newService creado en el ejemplo del tema "Creación de un nuevo servicio WS-Notification con la herramienta wsadmin".
Cree un punto de servicio WS-Notification Versión 6.1 en cluster1 que utilice el escucha de punto final existente SIBWSHTTPChannel1:
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-cluster", "cluster1", "-eplName", "SIBWSHTTPChannel1"] )
Cree un punto de servicio WS-Notification Versión 6.1 en server1 en node1 y cree un escucha de punto final nuevo que utilice SOAP en HTTP en el canal 1, donde la dirección del host del servidor es http://mi_host:9080:
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1", "-eplName", "myNewEPL",
"-eplURLRoot", "http://myhost:9080/wsn", "-eplWSDLServingURLRoot", "http://myhost:9080/sibws"] )
Cree un punto de servicio WS-Notification Versión 7.0 en el server1 del node1 (conjunto mínimo de parámetros):
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1",
"-transportURLRoot", "http://myhost:9080/myWSN"] )
Cree un punto de servicio WS-Notification Versión 7.0 en el server1 del node1 (conjunto completo de parámetros):
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1",
"-transportURLRoot", "http://myhost:9080/myWSN", "-transportSoapVersion", "1.1",
"-jaxwsHandlerListNB", "nbList", "-jaxwsHandlerListSM", "smList", "-jaxwsHandlerListPRM", "prmList"] )