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.

[IBM i][IBM i]El cliente de scripts wsadmin se ejecuta desde Qshell. [IBM i]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')

Después de utilizar el mandato, guarde los cambios en la configuración maestra utilizando el mandato siguiente:

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.

Este mandato crea los recursos siguientes:
  • 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.
La forma en que utilice este mandato depende de la topología bajo la cual se ejecuta. La topología determina los parámetros condicionales que proporciona:
  • 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
Si el tipo de servicio es Versión 7.0, no especifique los siguientes parámetros opcionales, que están relacionados con la configuración de JAX-RPC:
-eplName
-eplURLRoot
-eplWSDLServingURLRoot
Si el tipo de servicio es Versión 6.1, no especifique los siguientes parámetros opcionales, que están relacionados con la configuración de JAX-WS:
-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:
protocolo://nombre_hostnúmero_puerto/ubicación_servicio
donde protocolo puede ser http o https. Por ejemplo:
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"] )

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjwsn_cli_wsnservpt_new
File name: rjwsn_cli_wsnservpt_new.html