WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Alteraciones temporales del entorno local para el nodo SOAPRequest

Puede alterar dinámicamente valores en el entorno local del mismo modo que se establecen valores en otros elementos de un mensaje.

Hay otras alteraciones temporales de entorno local disponibles para WS-Addressing. Consulte WS-Addressing con el nodo SOAPRequest.

Puede establecer las propiedades siguientes en el nodo SOAPRequest bajo LocalEnvironment.Destination.SOAP.Request. Estas alteraciones temporales del entorno local también se aplican al nodo SOAPAsyncRequest.
Valor Descripción
Operation Altera temporalmente la propiedad Operación del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Operation = 'myOperation';
TransportType Altera temporalmente la propiedad Transporte en el nodo para cambiar de transporte. Por ejemplo, si el nodo está configurado para utilizar el transporte JMS, utilice lo siguiente para cambiar al transporte HTTP:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'http';
Para cambiar al transporte JMS:
SET OutputLocalEnvironment.Destination.SOAP.Request.TransportType = 'jms';
Esto altera temporalmente el transporte de solicitud y respuesta para este mensaje.
UserContext Puede almacenar datos de contexto BLOB en la siguiente ubicación en el entorno local. El nodo SOAPAsyncResponse puede recuperar estos datos posteriormente.
SET OutputLocalEnvironment.Destination.SOAP.Request.UserContext = x'aabbccddeeff11223344556677889900';
Los datos almacenado en UserContext deben estar en formato BLOB. Este campo se incluye en la corriente de bits del mensaje y, por consiguiente, aumenta el tamaño del mensaje.

Este valor sólo se aplica al nodo SOAPAsyncRequest y es ignorado por un nodo SOAPRequest.

Alteraciones temporales de LocalEnvironment para el transporte HTTP

Puede establecer las propiedades HTTP siguientes en el nodo SOAPRequest bajo LocalEnvironment.Destination.SOAP.Request.Transport.HTTP. Estas propiedades solamente se aplican cuando se utiliza el transporte HTTP. Puede conmutar entre el transporte HTTP y JMS utilizando la alteración temporal TransportType o el campo To; consulte Información de WS-Addressing en el entorno local.
Valor Descripción
Compression Altera temporalmente la propiedad Usar compresión del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Compression = 'gzip';
Para establecer un tamaño mínimo (en bytes) en el que aplicar la compresión, utilice la siguiente alteración temporal:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.MinimumCompressionSize = 1048576;
HTTPVersion Altera temporalmente HTTPVersion. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.HTTPVersion = 
'HTTP/1.1';
Method Altera temporalmente Method. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Method = 'GET';
ProxyConnectHeaders Especifica cabeceras adicionales que se utilizan si la solicitud de salida es una conexión SSL a través de un proxy. Estas cabeceras adicionales se envían con una solicitud CONNECT inicial al proxy. Por ejemplo, cuando utiliza SSL puede enviar información de autenticación proxy a un servidor proxy. Puede enviar varias cabeceras, pero cada una de ellas debe estar separada por un retorno de carro y un salto de línea (ASCII 0x0D 0x0A), de acuerdo con RFC2616; por ejemplo:
DECLARE CRLF CHAR CAST(X'0D0A' AS CHAR CCSID 1208);     
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyConnectHeaders =
'Proxy-Authorization: Basic Zm5lcmJsZTpwYXNzd29yZA==' || CRLF || 
'Proxy-Connection: Keep-Alive' || CRLF;
Este valor sólo se utiliza si la solicitud es una solicitud SSL a través de un servidor proxy. Para enviar información de autenticación proxy para una solicitud no SSL, especifique las cabeceras individuales en la carpeta HTTPRequestHeader, tal como se muestra en el siguiente ejemplo:
SET OutputRoot.HTTPRequestHeader."Proxy-Authorization" = 'Basic Zm5lcmJsZTpwYXNzd29yZA==';
SET OutputRoot.HTTPRequestHeader."Proxy-Connection" = 'Keep-Alive';
ProxyURL Altera temporalmente la propiedad Ubicación de proxy HTTP(S) del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.ProxyURL = 
'my.proxy';
RequestURI Altera temporalmente RequestURI, que es la vía de acceso después del URL y el puerto. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.RequestURI = 
'/abc/def?x=y&g=h';
SSLCiphers Altera temporalmente la propiedad Cifrados SSL permitidos (si se utiliza SSL) del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLCiphers = 
'SSL_RSA_FIPS_WITH_3DES_EDE_CBC_SHA';
SSLProtocol Altera temporalmente la propiedad SSLProtocol del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.SSLProtocol = 
'TLS';

Los valores válidos son SSL, SSLv3 y TLS.

Timeout Altera temporalmente la propiedad Tiempo de espera de solicitud (en segundos) del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.Timeout = 42;
TimeoutMillis Altera temporalmente la propiedad Tiempo de espera de solicitud (en segundos) del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.TimeoutMillis = 5000;
Esta propiedad define el tiempo de espera en milisegundos. El valor de TimeoutMillis altera temporalmente el valor de Timeout si se han establecido los dos valores.
WebServiceURL Altera temporalmente la propiedad URL de servicio web en el nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.HTTP.WebServiceURL = 
'http://ibm.com/abc/';

Alteraciones temporales de LocalEnvironment para el transporte JMS

Puede establecer las siguientes propiedades JMS en el nodo SOAPRequest bajo LocalEnvironment.Destination.SOAP.Request.Transport.JMS. Estas propiedades solamente se aplican cuando se utiliza el transporte JMS. Puede conmutar entre el transporte HTTP y JMS utilizando la alteración temporal TransportType o el campo To; consulte Información de WS-Addressing en el entorno local.

Algunas alteraciones temporales del entorno local JMS para el nodo SOAPRequest tienen propiedades equivalentes en la cabecera JMSTransport. Si especifica una alteración de entorno local, tiene prioridad sobre cualquier propiedad equivalente establecida en la cabecera JMSTransport.

Valor Descripción
BindingsLocation Altera temporalmente la propiedad Ubicación de enlaces URL de JNDI en el nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.BindingsLocation = 
'file:/C:/mqsi6/Webservices/SOAP/JMS/JNDI';
ConnectionFactoryName Altera temporalmente la propiedad Nombre de fábrica de conexiones en el nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ConnectionFactoryName = 
'QCF';
ContextParameters Especifique parámetros de contexto JNDI, además de los parámetros de contexto JNDI definidos en el nodo. Puede definir parámetros de contexto JNDI específicos, por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.ContextParameters.property2 = 
'value2';
CorrelationID Establece el CorrelID del mensaje de solicitud. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationID  = 
'myCorrelID';
CorrelationPattern Establece el patrón de correlación de mensajes de solicitud. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.CorrelationPattern  = 
1;
Los valores permitidos son los enteros 1 y 2:
  • 1 indica que los mensajes se deben correlacionar automáticamente mediante el CorrelID si hay uno presente. De lo contrario, los mensajes se correlacionan mediante el ID de mensaje. Éste es el comportamiento predeterminado.
  • 2 obliga a que los mensajes se correlacionen mediante el ID de mensaje. aunque haya presente un CorrelID.
DeliveryMode Altera temporalmente la propiedad DeliveryMode del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.DeliveryMode = 
'NON_PERSISTENT';
Los valores permitidos para esta propiedad son PERSISTENT y NON_PERSISTENT. Si UriFormat es ibm, 1 y 0 son valores permitidos adicionales para DeliveryMode.
Destination Altera temporalmente la propiedad Destination del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Destination = 
'REPLYTOQ2';
DestinationURI Puede alterar temporalmente varias propiedades JMS al mismo tiempo en el entorno local utilizando el valor DestinationURI. Las propiedades que se establecen de este modo se pueden alterar temporalmente estableciendo alteraciones temporales de entorno local para propiedades JMS individuales, tal como se muestra en las tablas siguientes.
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';
Esta alteración temporal de entorno local se puede establecer con un formato de URI de estilo W3C o de estilo IBM. Para obtener más información, consulte Formatos de URI de WSDL de JMS.
Expiration Altera temporalmente la propiedad Expiration del nodo. Esta propiedad se especifica en milisegundos. Por ejemplo, para establecer una caducidad de 100 milisegundos:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Expiration = 
'100';
InitialContextFactory Altera temporalmente la propiedad Fábrica de contexto inicial en el nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.InitialContextFactory = 
'com.sun.jndi.fscontext.RefFSContextFactory';
MessagePriority Altera temporalmente la propiedad MessagePriority del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessagePriority = 
'7';
MessageType Altera temporalmente la propiedad MessageType del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.MessageType = 
'text';
Los valores permitidos para esta propiedad son text y bytes.
ProviderName Altera temporalmente la propiedad Nombre del proveedor JMS en el nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ProviderName = 
'WebSphere MQ';
ReplyToDestination Altera temporalmente la propiedad ReplyToDestination del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.ReplyToDestination = 
'REPLYTOQ3';
TargetService Altera temporalmente la propiedad TargetService del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TargetService = 
'testService';
Timeout Altera temporalmente la propiedad Timeout del nodo. Este valor se especifica en segundos. Por ejemplo, para establecer un valor de tiempo de espera de 30 segundos:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.Timeout = 
'30';
TransactionMode Altera temporalmente la propiedad Modalidad de transacción en el nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.TransactionMode = 'Yes';
Los valores permitidos para esta propiedad son Yes, No y ForceLocal.
  • No significa que no se lleva a cabo ninguna transacción, y equivale a None.
  • Yes significa que se lleva a cabo una transacción local si la propiedad Transacción coordinada del flujo no está seleccionada, o se lleva a cabo una transacción coordinada XA si la propiedad Transacción coordinada del flujo está seleccionada.
  • ForceLocal significa que se utiliza siempre una transacción local, incluso si la propiedad Transacción coordinada del flujo está seleccionada.
UriFormat Altera temporalmente la propiedad UriFormat del nodo. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.UriFormat  = 
'w3c';
Los valores permitidos para esta propiedad son w3c e ibm.
UserProperties Especifique parámetros de contexto de usuario, además de los parámetros de contexto de usuario definidos en el nodo. Puede definir parámetros de contexto de usuario específicos, por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property1 = 
'value1';
SET OutputLocalEnvironment.Destination.SOAP.Request.Transport.JMS.JNDI.UserProperties.property2 = 
'value2';
Valor Descripción
OneWay Indica al nodo que el mensaje de entrada era un mensaje unidireccional y que no es necesario ningún mensaje de respuesta. Por ejemplo:
SET OutputLocalEnvironment.Destination.SOAP.Request.Gateway.OneWay = True

Si el mensaje se envía a través del transporte HTTP, el nodo espera un mensaje de respuesta de acuse de recibo HTTP 202 del servidor remoto. Si el mensaje se envía a través del transporte JMS, no se espera ninguna respuesta. En este ejemplo, el mensaje de salida no tiene ninguna cola de respuestas, y el nodo no espera ninguna respuesta.

Para obtener más información, consulte Mensajes unidireccionales en modalidad de pasarela.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

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

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:48


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac56192_