createWSNServicePoint 命令

使用 createWSNServicePoint 命令创建新 WS-Notification 服务点。

可按本主题中所述使用 wsadmin 工具创建新 WS-Notification 服务点,或按创建新的 V6.1 WS-Notification 服务点创建新的 V7.0 WS-Notification 服务点中所述使用管理控制台进行创建。

要运行该命令,请使用 wsadmin 脚本编制客户机AdminTask 对象

[IBM i][IBM i]wsadmin 脚本编制客户机通过 Qshell 运行. [IBM i]有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.

已经为服务集成总线命令提供了命令行帮助:

  • 要获取可用的 WS-Notification 命令列表以及每个命令的简要描述,请在 wsadmin 提示符处输入以下命令:

    print AdminTask.help('WSNotificationCommands')

  • 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:

    print AdminTask.help('command_name')

使用此命令后,请使用以下命令将更改保存到主配置中:

AdminConfig.save()

用途

如果总线成员上存在 WS-Notification 服务点,那么意味着会在该总线成员中公开此 WS-Notification Web Service,并导致对与该服务点相关联的总线成员公开通知代理、预订管理器和发布者注册管理器的 Web Service 端点。WS-Notification 应用程序使用这些端点来与 WS-Notification 服务进行交互。

此命令创建下列资源:
  • 它在 WS-Notification 服务上创建新的 WS-Notification 服务点。
  • 对于 V7.0 WS-Notification 服务点,这会导致代理充当的三个角色的 Web Service 端点在总线成员上公开。
  • 对于 V6.1 WS-Notification 服务点,它创建三个服务集成总线入站端口以表示代理充当的三个角色,并在必要时创建服务集成总线端点侦听器,然后将新的或现有端点侦听器连接至与 WS-Notification 服务相关联的服务集成总线。
使用此命令的方式取决于运行此命令时采用的拓扑。该拓扑确定您提供的条件参数:
  • 总线成员类型(服务器或集群)
  • V6.1 WS-Notification 服务点的端点侦听器(创建新端点侦听器或使用现有端点侦听器)
如果服务类型为 V7.0,那么不要指定以下与 JAX-RPC 配置有关的可选参数:
-eplName
-eplURLRoot
-eplWSDLServingURLRoot
如果服务类型为 V6.1,那么不要指定以下与 JAX-WS 配置有关的可选参数:
-transportURLRoot
-transportSoapVersion
-jaxwsHandlerListNB
-jaxwsHandlerListSM
-jaxwsHandlerListPRM

只能为 WebSphere® Application Server V7.0 或更高版本 总线成员上的 V7.0 WS-Notification 服务创建服务点。如果总线成员是集群,那么集群中的所有服务器必须是 WebSphere Application Server V7.0 或更高版本 应用程序服务器。

可为 WebSphere Application Server V6.1 或更高版本 应用程序服务器上的 V6.1 WS-Notification 服务创建服务点。

目标对象

WSNService

必需参数

-name

条件参数

选择相关联的总线成员的服务器或集群:

-server
要创建的 WS-Notification 服务点所在服务器的名称。
  • 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
  • 如果使用了此参数,那么必须指定 node 参数,并且不能指定 cluster 参数
-node
服务器所在节点的名称。
  • 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
  • 如果使用了此参数,那么必须指定 server 参数,并且不能指定 cluster 参数
-cluster
要创建的 WS-Notification 服务点所在集群的名称。
  • 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
  • 如果使用了此参数,那么不能指定 servernode 参数。

对于 V6.1 WS-Notification 服务,选择是配置新的端点侦听器还是使用现有的端点侦听器:

-eplName
端点侦听器的名称。
  • 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
  • 如果已经在所选服务器或集群上定义了此端点侦听器,那么不应该指定 eplURLRooteplWSDLServingURLRoot 参数。否则,必须同时指定 eplURLRooteplWSDLServingURLRoot 参数。
仅对 V6.1 WS-Notification 服务指定此参数。
-eplURLRoot
通过此端点侦听器访问的 Web Service 的外部可视端点地址 URL 的根。
  • 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
  • 如果已经在所选服务器或集群上定义了此端点侦听器,那么不应该指定此参数。
仅对 V6.1 WS-Notification 服务指定此参数。
-eplWSDLServingURLRoot
与此端点侦听器相关联的 WSDL 文件所在外部可视 HTTP URL 的根。在大多数情况下,此值是 http://host_name:port_number/SIBWS。有关更多信息,请参阅创建新的端点侦听器配置createSIBWSEndpointListener 命令
  • 如果指定了 copyServicePoint 参数,那么不需要指定此参数。
  • 如果已经在所选服务器或集群上定义了此端点侦听器,那么不应该指定此参数。
仅对 V6.1 WS-Notification 服务指定此参数。

对于 V7.0 WS-Notification 服务,请配置 Web Service 端点:

-transportURLRoot
WS-Notification 服务点的外部可视端点地址的根,格式如下:
protocol://host_nameport_number/service_location
其中 protocolhttphttps。例如:
http://myhostname:9080/ctx123/mySvc
通过管理控制台将 WSDL 发布至压缩文件时,可以使用此参数使特定的外部 Web 地址与 WS-Notification 服务相关联。请注意,此地址可能与公开 WS-Notification 服务的地址不同。通过代理访问 WS-Notification 服务时,需要此地址。
如果未指定此参数,那么底层 JAX-WS 实现会根据服务点安装过程中提供的信息创建适当的 URL。
如果指定了 copyServicePoint 参数,那么不需要指定此参数。
对于对 V6.1 WS-Notification 服务创建的服务点,此属性是 eplURLRoot 参数的等价项。仅对 V7.0 WS-Notification 服务指定此参数。
-transportSoapVersion
对于 SOAP 1.1,允许的值为 1.1(缺省值),对于 SOAP 1.2,允许的值为 1.2
如果指定了 copyServicePoint 参数,那么不需要指定此参数。
仅对 V7.0 WS-Notification 服务指定此参数。

从现有 WS-Notification 服务点定义复制配置:

-copyServicePoint
WS-Notification 服务上配置的现有服务点的名称,将从此服务点复制其他配置属性。如果指定此参数,那么只需指定 name 参数。所有其他值都是从所指定现有服务点中获取的。

可选参数

-description
-jaxwsHandlerListNB
如果指定了 copyServicePoint 参数,那么不需要指定此参数。
仅对 V7.0 WS-Notification 服务指定此参数。
-jaxwsHandlerListSM
如果指定了 copyServicePoint 参数,那么不需要指定此参数。
仅对 V7.0 WS-Notification 服务指定此参数。
-jaxwsHandlerListPRM
如果指定了 copyServicePoint 参数,那么不需要指定此参数。
仅对 V7.0 WS-Notification 服务指定此参数。

示例

在下列示例中,WS-Notification 服务点使用“使用 wsadmin 工具创建新的 WS-Notification 服务”主题中的示例所创建的 WS-Notification 服务 newService

在使用现有端点侦听器 SIBWSHTTPChannel1cluster1 上创建 V6.1 WS-Notification 服务点:

newServicePoint = AdminTask.createWSNServicePoint(newService, 
[“-name”, “newServicePoint”, “-cluster”, “cluster1”, “-eplName”, “SIBWSHTTPChannel1”] )

node1 上的 server1 中创建 V6.1 WS-Notification 服务点,并在通道 1 上创建使用 SOAP over HTTP 的新端点侦听器,其中服务器的主机地址是 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”] )

node1 上的 server1 上创建 V7.0 WS-Notification 服务点(最少参数集合):

newServicePoint = AdminTask.createWSNServicePoint(newService, 
[“-name”, “newServicePoint”, “-node”, “node1”, “-server”, “server1”, 
“-transportURLRoot”, “http://myhost:9080/myWSN”] ) 

node1 上的 server1 上创建 V7.0 WS-Notification 服务点(完整参数集合):

newServicePoint = AdminTask.createWSNServicePoint(newService, 
[“-name”, “newServicePoint”, “-node”, “node1”, “-server”, “server1”, 
“-transportURLRoot”, “http://myhost:9080/myWSN”, “-transportSoapVersion”, “1.1”, 
“-jaxwsHandlerListNB”, “nbList”, “-jaxwsHandlerListSM”, “smList”, “-jaxwsHandlerListPRM”, “prmList”] )

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjwsn_cli_wsnservpt_new
文件名:rjwsn_cli_wsnservpt_new.html