WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Substituições do Ambiente Local para o Nó de SOAPAsyncRequest

Você pode substituir dinamicamente os valores no ambiente local da mesma maneira que configura valores em outros elementos de uma mensagem. Essas substituições de ambiente local são usadas somente pelo nó SOAPAsyncRequest e não pelo nó SOAPAsyncResponse.

Substituições do Ambiente Local para o Nó de SOAPAsyncRequest

É possível configurar as seguintes propriedades em LocalEnvironment.Destination.SOAP.Request:
Configuração Descrição
TransportType Substitui a propriedade Transport no nó para alternar o transporte. Por exemplo, se o nó for configurado para usar o transporte JMS, use o seguinte para comutar para o transporte HTTP:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'http';
Para alternar para o transporte JMS:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'jms';
Isso substitui apenas o transporte de solicitação para essa mensagem. O transporte de resposta não é alterado do conjunto de propriedades no nó SOAPAsyncResponse.
Operação Substitui a propriedade Operation no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Operation = 'myOperation';
UserContext É possível armazenar dados de contexto no seguinte local no ambiente local. O nó SOAPAsyncResponse pode ser recuperado posteriormente nesses dados.
SET OutputLocalEnvironment.Destination.SOAP.Request.UserContext = 'myData';

O LocalEnvironment substitui o transporte HTTP

Você pode configurar as seguintes propriedades em LocalEnvironment.Destination.SOAP.Request.Transport.HTTP. Essas propriedades se aplicam na utilização do transporte HTTP.

É possível alternar entre o transporte HTTP e JMS utilizando a substituição TransportType ou o campo To de WS-Addressing (consulte Informações de WS-Addressing no Ambiente Local).
Configuração Descrição
WebServiceURL Substitui a propriedade URL do serviço da Web no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.WebServiceURL = 
'http://ibm.com/abc/';
RequestURI Substitui a RequestURI, que é o caminho após a URL e a porta. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.RequestURI = 
'/abc/def?x=y&g=h';
Timeout Substitui a propriedade Tempo Limite do Pedido (em segundos) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Timeout = 42;
Esse é o tempo que o nó aguarda para receber o reconhecimento HTTP 202, e não o tempo de espera pela resposta do serviço da web associado.
ProxyURL Substitui a propriedade Local do proxy HTTP(S) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyURL = 
'my.proxy';
SSLProtocol Substitui a propriedade SSLProtocol no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLProtocol = 
'TLS';

Os valores válidos são: SSL, SSLv3 e TLS.

SSLCiphers Substitui a propriedade Cifras SSL Permitidas (se estiver utilizando SSL) no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLCiphers = 
'SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA';
HTTPVersion Substitui a HTTPVersion. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.HTTPVersion = 
'HTTP/1.1';
Método Substitui o Método. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Method = 'GET';
ProxyConnectHeaders Especifica cabeçalhos adicionais que serão utilizados caso o pedido de saída seja uma conexão SSL através de um proxy. Estes cabeçalhos adicionais são enviados juntamente com o pedido inicial CONNECT ao proxy. Por exemplo, você poderá enviar informações sobre autenticação de proxy para um servidor proxy quando estiver utilizando o SSL. Múltiplos cabeçalhos podem ser enviados mas cada um deve ser separado por um retorno de carro e um avanço de linha (ASCII 0x0D 0x0A) de acordo com o RFC2616; por exemplo:
DECLARE CRLF CHAR CAST(X'0D0A' AS CHAR CCSID 1208);     
SET OutputLocalEnvironment.Destination.HTTP.ProxyConnectHeaders =
'Proxy-Authorization: Basic Zm5lcmJsZTpwYXNzd29yZA==' || CRLF || 
'Proxy-Connection: Keep-Alive' || CRLF;
Esta configuração é utilizada apenas se for um pedido SSL através de um servidor proxy. Para enviar informações sobre autenticação de proxy para um pedido não SSL, especifique os cabeçalhos individuais na pasta HTTPRequestHeader, conforme mostrado nos exemplos a seguir:
SET OutputRoot.HTTPRequestHeader."Proxy-Authorization" = 
'Basic Zm5lcmJsZTpwYXNzd29yZA==';
SET OutputRoot.HTTPRequestHeader."Proxy-Connection" = 'Keep-Alive';
Compactação Substitui a propriedade Usar compactação no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Compression = 
'gzip';

Substituições de Ambiente Local para Transporte JMS

Você pode configurar as seguintes propriedades do JMS no nó SOAPAsyncRequest em LocalEnvironment.Destination.SOAP.Request.Transport.JMS. Essas propriedades se aplicam apenas quando se utiliza o transporte JMS.

É possível alternar entre o transporte HTTP e JMS utilizando a substituição TransportType ou o campo To de WS-Addressing (consulte Informações de WS-Addressing no Ambiente Local).

Algumas substituições do ambiente local JMS para o nó SOAPAsyncRequest possui propriedades equivalentes no cabeçalho JMSTransport. Se você especificar uma substituição de ambiente local, ela tem precedência sobre qualquer propriedade equivalente configurada no cabeçalho JMSTransport.

Configuração Descrição
CorrelationID Configura a mensagem de solicitação CorrelID. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationID  = 
'myCorrelID';
DeliveryMode Substitui a propriedade DeliveryMode no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.DeliveryMode = 
'NON_PERSISTENT';
Os valores permitidos para esta propriedade são PERSISTENT e NON_PERSISTENT. Se UriFormat for ibm, 1 e 0 são valores adicionais permitidos para DeliveryMode.
Destino Substitui a propriedade Destination no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Destination = 
'REPLYTOQ2';
DestinationURI É possível substituir múltiplas propriedades do JMS ao mesmo tempo no ambiente local usando a configuração DestinationURI. As propriedades que você configura desta maneira podem ser substituídas configurando as substituições do ambiente local para as propriedades individuais do JMS conforme exibido nas tabelas a seguir.
SET OutputLocalEnvironment.Destination.SOAP.Reply.Transport.JMS.DestinationURI = 
	'jms:jndi:INPUTQ1?jndiConnectionFactoryName=QCF&
	replyToName=REPLYTOQ2&
	jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
	jndiURL=file:/C:/Webservices/SOAP/JMS/JNDI&
	userParam1=value1&
	userParam2=value2&
	timeToLive=30000';
Essa substituição do ambiente local pode ser configurada com um formato de URI de estilo W3C ou de estilo IBM. Para obter informações adicionais, consulte Formatos de URI WSDL para JMS.
Expiração Substitui a propriedade Expiration no nó. Esta propriedade é especificada em milissegundos. Por exemplo, para configurar uma expiração de 100 milissegundos:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Expiration = 
'100';
MessagePriority Substitui a propriedade MessagePriority no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessagePriority = 
'7';
MessageType Substitui a propriedade MessageType no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessageType = 
'text';
Os valores permitidos para esta propriedade são text e bytes.
ProviderName Substitui a propriedade Nome do Provedor JMS no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ProviderName = 
'WebSphere MQ';
TargetService Substitui a propriedade TargetService no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TargetService = 
'testService';
TransactionMode Substitui a propriedade Modo de Transação no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TransactionMode = 'Yes';
Os valores permitidos para essa propriedade são Sim, Não e ForceLocal.
  • Não significa que nenhuma transação ocorre e é equivalente a Nenhum.
  • Sim significa que uma transação local ocorrerá se a Transação Coordenada do fluxo não estiver selecionada, ou uma transação coordenada por XA ocorrerá se a propriedade Transação Coordenada do fluxo estiver selecionada.
  • ForceLocal significa que uma transação local sempre será usada, mesmo que a propriedade Transação Coordenada do fluxo seja selecionada.
UriFormat Substitui a propriedade UriFormat no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.UriFormat  = 
'w3c';
Os valores permitidos para esta propriedade são w3c e ibm.

Substituições de Ambiente Local para JNDI

Você pode configurar as seguintes propriedades JMS no nó SOAPAsyncRequest em LocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI. Essas propriedades se aplicam apenas quando se utiliza o transporte JMS.

Configuração Descrição
BindingsLocation Substitui a propriedade Local das ligações da URL do JNDI no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.BindingsLocation = 
'file:/C:/Webservices/SOAP/JMS/JNDI';
ConnectionFactoryName Substitui a propriedade Nome da connection factory no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters Especifique os parâmetros de contexto JNDI além dos parâmetros de contexto JNDI definidos no nó. É possível definir os parâmetros de contexto JNDI, por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property2 = 
'value2';
InitialContextFactory Substitui a propriedade Factory de contexto inicial no nó. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
UserProperties Especifique os parâmetros de contexto do usuário além dos parâmetros de contexto do usuário definidos no nó. É possível definir os parâmetros de contexto do usuário específicos, por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property2 = 
'value2';

Substituições de Ambiente Local para WS-Addressing ReplyTo

Você pode configurar as seguintes propriedades JMS WS-Addressing ReplyTo no nó SOAPAsyncRequest em LocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply. Configure essas propriedades se você quiser substituir como o servidor remoto localiza as definições da JNDI para a fila de resposta.

Essas propriedades se aplicam apenas quando se utiliza o transporte JMS. É possível alternar entre o transporte HTTP e JMS utilizando a substituição TransportType ou o campo To de WS-Addressing (consulte Informações de WS-Addressing no Ambiente Local).

Configuração Descrição
BindingsLocation Substitui a propriedade BindingsLocation no WS-Addressing ReplyTo.
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.BindingsLocation = 
'file:/C:/webservices/SOAP/JMS/JNDI';
ConnectionFactoryName Substitui a propriedade ConnectionFactoryName no WS-Addressing ReplyTo.
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters Especifique parâmetros de contexto JNDI no WS-Addressing ReplyTo. É possível definir os parâmetros de contexto JNDI, por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.ContextParameters.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.ContextParameters.property2 = 
'value2';
InitialContextFactory Substitui a propriedade InitialContextFactory no WS-Addressing ReplyTo.
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.AsyncReply.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
Configuração Descrição
OneWay Instrui o nó que a mensagem de entrada era uma mensagem unidirecional e que nenhuma mensagem de resposta é necessária. Por exemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Gateway.OneWay = True
Se a mensagem de entrada tiver usado o transporte HTTP, o nó enviará uma mensagem HTTP 202 de reconhecimento. Se a mensagem de entrada tiver usado o transporte JMS, nenhuma resposta será esperada. A mensagem de saída não tem fila de resposta e o nó não aguarda uma resposta.

Para obter mais informações, consulte Mensagens Unidirecionais no Modo de Gateway.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:47


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac56202_