Comando createWSNServicePoint

Use o comando createWSNServicePoint para criar um novo ponto de serviço do WS-Notification.

É possível criar um novo ponto de serviço WS-Notification ao usar a ferramenta wsadmin, conforme descrito neste tópico, ou usar o console administrativo, conforme descrito em Criando um Novo Ponto de Serviço WS-Notification da Versão 6.1 e Criando um Novo Ponto de Serviço do WS-Notification da Versão 7.0.

Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.

[IBM i][IBM i]O cliente de script wsadmin é executado do Qshell. [IBM i]Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.

A ajuda da linha de comandos é fornecida para comandos do barramento de integração de serviços:

  • Para obter uma lista dos comandos de WS-Notification disponíveis, além de uma breve descrição de cada comando, digite o seguinte comando no prompt wsadmin:

    print AdminTask.help('WSNotificationCommands')

  • Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:

    print AdminTask.help('command_name')

Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:

AdminConfig.save()

Propósito

A existência de um ponto de serviço do WS-Notification em um membro do barramento implica em que um serviço da Web do WS-Notification seja exposto a partir desse membro do barramento e faz com que os terminais de serviço da Web para o broker de notificação, gerenciador de assinaturas e gerenciador de registro do publicador para esse serviço do WS-Notification sejam expostos no membro do barramento ao qual o ponto de serviço está associado. Os aplicativos do WS-Notification utilizam estes nós de extremidade para interagir com o serviço do WS-Notification.

Este comando cria os seguintes recursos:
  • Cria um novo ponto de serviço do WS-Notification em um serviço WS-Notification.
  • Para um ponto de serviço do WS-Notification Versão 7.0, isso faz com que os terminais de serviço da web para as três funções atuadas pelo broker sejam expostos no membro do barramento.
  • Para um ponto de serviço WS-Notification Versão 6.1, cria as portas de entrada do barramento de integração de serviços que representam as três funções reproduzidas pelo intermediário, cria um listener do terminal do barramento de integração de serviços, se necessário, e conecta o listener do terminal novo ou existente ao barramento de integração de serviços com o qual o serviço WS-Notification está associado.
A maneira como este comando é usado depende da topologia na qual esse comando está sendo executado. A topologia determina os parâmetros condicionais fornecidos:
  • tipo de membro do barramento (servidor ou cluster)
  • listener terminal (criar novo ou usar existente) para os pontos de serviço do WS-Notification Versão 6.1
Se o tipo de serviço for Versão 7.0, não especifique os seguintes parâmetros opcionais, que estão relacionados à configuração do JAX-RPC:
-eplName
-eplURLRoot
-eplWSDLServingURLRoot
Se o tipo de serviço for Versão 6.1, não especifique os seguintes parâmetros opcionais, que estão relacionados à configuração do JAX-WS:
-transportURLRoot
1-transportSoapVersion
-jaxwsHandlerListNB
-jaxwsHandlerListSM
-jaxwsHandlerListPRM

É possível criar pontos de serviço apenas para os serviços do WS-Notification Versão 7.0 nos membros do barramento do WebSphere Application Server Versão 7.0 ou posterior. Se o membro do barramento for um cluster, todos os servidores no cluster deverão ser servidor de aplicativos do WebSphere Application Server Versão 7.0 ou posterior.

É possível criar pontos de serviço para os serviços do WS-Notification Versão 6.1 nos servidores de aplicativos do WebSphere Application Server Versão 6.1 ou posterior.

Objeto de destino

WSNService

Parâmetros necessários

-name

Parâmetros Condicionais

Escolha um servidor ou um cluster para o membro do barramento associado:

-server
Nome do servidor no qual o ponto de serviço do WS-Notification é criado.
  • Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
  • Se este parâmetro for utilizado, o parâmetro node deverá ser especificado e o parâmetro cluster não deverá ser especificado.
-node
Nome do nó no qual o servidor está localizado.
  • Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
  • Se este parâmetro for utilizado, o parâmetro server deverá ser especificado e o parâmetro cluster não deverá ser especificado.
-cluster
Nome do cluster no qual o ponto de serviço do WS-Notification é criado.
  • Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
  • Se este parâmetro for utilizado, os parâmetros server e node não deverão ser especificados.

Para o serviço do WS-Notification Versão 6.1, escolha entre configurar um novo listener terminal ou usar um existente:

-eplName
Nome de um listener do terminal.
  • Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
  • Se este listener do terminal já tiver sido definido no servidor ou cluster escolhido, os parâmetros eplURLRoot e eplWSDLServingURLRoot não deverão ser especificados. Caso contrário, os parâmetros eplURLRoot e eplWSDLServingURLRoot deverão ser especificados.
Especifique este parâmetro apenas para serviços do WS-Notification versão 6.1.
-eplURLRoot
Raiz da URL do endereço do terminal visível externamente para os serviços da web que são acessados por meio deste listener terminal.
  • Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
  • Se o listener do terminal já tiver sido definido no servidor ou cluster escolhido, este parâmetro não deverá ser especificado.
Especifique este parâmetro apenas para serviços do WS-Notification versão 6.1.
-eplWSDLServingURLRoot
Raiz da URL HTTP visível externamente na qual o arquivo WSDL associado a este listener do terminal está localizado. Na maioria das vezes, ela é http://host_name:port_number/SIBWS. Para obter informações adicionais, consulte Criando uma Nova Configuração de Listener de Nó de Extremidade ou Comando createSIBWSEndpointListener.
  • Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
  • Se o listener do terminal já tiver sido definido no servidor ou cluster escolhido, este parâmetro não deverá ser especificado.
Especifique este parâmetro apenas para serviços do WS-Notification versão 6.1.

Para um serviço do WS-Notification Versão 7.0, configure o terminal de serviço da Web:

-transportURLRoot
Raiz do endereço de terminal visível externamente para o ponto de serviço do WS-Notification no seguinte formato:
protocol://host_nameport_number/service_location
em que protocol é http ou https. Por exemplo:
http://myhostname:9080/ctx123/mySvc
Esse parâmetro pode ser usado para associar um determinado endereço da web externo ao serviço do WS-Notification quando publicar o WSDL em um arquivo compactado por meio do console administrativo. Note que esse endereço pode não ser o mesmo endereço no qual o serviço do WS-Notification é exposto. Esse endereço é necessário quando o serviço WS-Notification é acessado por meio de um proxy.
Se você não especificar esse parâmetro, a implementação JAX-WS subjacente criará uma URL apropriada com base nas informações fornecidas como parte do processo de instalação do ponto de serviço.
Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
Esse atributo é equivalente ao parâmetro eplURLRoot para os pontos de serviço criados nos serviços do WS-Notification Versão 6.1. Especifique este parâmetro apenas para serviços do WS-Notification versão 7.0.
1-transportSoapVersion
Os valores permitidos são 1.1 para SOAP 1.1 (o padrão) e 1.2 para SOAP 1.2.
Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
Especifique este parâmetro apenas para serviços do WS-Notification versão 7.0.

Copie a configuração de uma definição do ponto de serviço do WS-Notification existente:

-copyServicePoint
O nome de um ponto de serviço existente configurado no Serviço WS-Notification do qual os outros atributos de configuração são copiados. Se você especificar este parâmetro, será necessário especificar apenas o parâmetro name. Todos os demais valores são obtidos do ponto de serviço indicado existente.

Parâmetros Opcionais

-description
-jaxwsHandlerListNB
Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
Especifique este parâmetro apenas para serviços do WS-Notification versão 7.0.
-jaxwsHandlerListSM
Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
Especifique este parâmetro apenas para serviços do WS-Notification versão 7.0.
-jaxwsHandlerListPRM
Se você especificar o parâmetro copyServicePoint, não será necessário especificar este parâmetro.
Especifique este parâmetro apenas para serviços do WS-Notification versão 7.0.

Exemplos

Nos exemplos a seguir, o ponto de serviço do WS-Notification usa o serviço do WS-Notification newService criado no exemplo do tópico "Criando um Novo Serviço WS-Notification Usando a Ferramenta wsadmin".

Crie um ponto de serviço do WS-Notification Versão 6.1 no cluster1 que usa o listener terminal existente SIBWSHTTPChannel1:

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

Crie um ponto de serviço do WS-Notification no server1 no node1 e crie um novo listener terminal que usa SOAP sobre HTTP no canal 1, em que o endereço do host do servidor é 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"] )

Crie um ponto de serviço do WS-Notification Versão 7.0 no server1 no node1 (conjunto de parâmetros mínimo):

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

Crie um ponto de serviço do WS-Notification Versão 7.0 no server1 no node1 (conjunto de parâmetros integral):

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

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjwsn_cli_wsnservpt_new
Nome do arquivo: rjwsn_cli_wsnservpt_new.html