Utilice el nodo IMSRequest para enviar una solicitud para ejecutar una transacción en un sistema IMS local y remoto, y esperar una respuesta. IMS Connect debe configurarse y ejecutarse en un sistema IMS.
Este tema contiene las siguientes secciones:
El siguiente ejemplo muestra una situación en la que podría utilizar un nodo IMSRequest.
WebSphere Message Broker puede utilizarse para exponer una aplicación de banca de IMS de un destino existente como un servicio web. Por ejemplo, la aplicación IMS proporciona transacciones que operan en una base de datos que contiene información sobre cuentas bancarias de clientes. En este ejemplo, el cliente del servicio web envía un mensaje SOAP a través de HTTP a WebSphere Message Broker y espera de forma síncrona la respuesta. El flujo de mensajes de WebSphere Message Broker convierte el mensaje SOAP en formato IMS (incluidos los campos de código de transacción y LLZZ) y, a continuación, envía esa corriente de bits a IMS. El flujo de mensajes espera una respuesta. IMS planifica el programa de destino y pone en la cola los datos de solicitud para ese programa. Este programa de destino accede a la base de datos de cuenta de cliente, crea un mensaje de respuesta que consta de una sentencia de cuenta y la devuelve al flujo de mensajes de WebSphere Message Broker. El flujo de mensajes convierte el formato IMS en un formato SOAP y vuelve a enviar esa respuesta SOAP a través de HTTP al cliente del servicio web.
El nodo IMSRequest se encuentra en la bandeja IMS de la paleta de nodos de flujos de mensajes y se representa en el WebSphere Message Broker Toolkit mediante el icono siguiente:
El nodo IMSRequest también puede utilizar una identidad que esté presente en un mensaje de entrada, y propagarla a IMS, utilizando la propiedad Propagate del perfil de seguridad definido para el nodo. Para ver más información, consulte Propagación de las credenciales de seguridad a IMS.
Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.
Utilización de servicios configurables para nodos IMS
Puede configurar nodos IMS para obtener detalles de conexión de un servicio configurable. Para obtener información sobre la creación, el cambio, la notificación y la supresión de servicios configurables, consulte Cambio de la información de conexión para el nodo IMSRequest.
Cuando haya colocado una instancia del nodo IMSRequest en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se muestran en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.
Los terminales del nodo IMSRequest están descritos en la siguiente tabla.
Terminal | Descripción |
---|---|
In (de entrada) | Terminal de entrada que recibe el mensaje que desencadena el nodo. |
Out (de salida) | El terminal de salida al que el nodo envía un mensaje después de haberlo recibido del recurso externo. El mensaje se envía al terminal sin modificar, excepto alguna información de estado añadida. |
Failure (de anomalías) | Si se produce un error en el nodo IMSRequest, el mensaje se envía al terminal Failure (de anomalías). |
Timeout (de tiempo de espera) | El terminal de salida al que se envía el mensaje si se produce un tiempo de espera excedido. El mensaje de entrada se propaga a este terminal con una lista de excepciones que describe el tiempo de espera excedido. Si el terminal Timeout no está conectado y se produce un tiempo de espera excedido, el mensaje se direcciona al terminal Failure. Un tiempo de espera excedido puede producirse en las siguientes situaciones:
|
Las tablas siguientes describen las propiedades de nodo. Las columnas con la cabecera O indican si la propiedad es obligatoria (marcada con un asterisco en el panel si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); las columnas con la cabecera C indican si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo, IMSRequest | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Usar propiedades de conexión definidas en nodo | No | Sí | Seleccionado | Si selecciona este recuadro de selección, se utilizan las propiedades de conexión que están definidas en nodo en lugar de un servicio configurable y la identidad de seguridad que están definidas en el intermediario. Si deselecciona este recuadro de selección, debe establecer las propiedades Servicio configurable y Identidad de seguridad. |
|
Nombre de host | Sí | Sí | La dirección IP o el nombre de host del sistema que está ejecutando el sistema IMS Connect de destino. Esta propiedad es obligatoria si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado y se puede establecer sólo si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado. | hostname | |
Número de puerto | Sí | Sí | 0 | El número de puerto en el que IMS Connect está a la escucha de conexiones TCP/IP. Puede obtener el número de puerto del registro de trabajo IMS Connect en el sistema IMS. Esta propiedad es obligatoria sólo si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado y se puede establecer sólo si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado. | portNumber |
Nombre de almacén de datos | Sí | Sí | Nombre del almacén de datos que IMS Connect está utilizando. Este valor debe coincidir con el parámetro ID de la sentencia del almacén de datos que se especifica en el miembro de configuración de IMS Connect. Este nombre también sirve como nombre de miembro XCF para IMS durante las comunicaciones XCF internas entre IMS Connect y IMS OTMA. Puede obtener el nombre del almacén de datos del registro de trabajo IMS Connect en el sistema IMS. Esta propiedad es obligatoria sólo si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado y se puede establecer sólo si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado. | dataStoreName | |
Tiempo de espera a la espera de que se ejecute una transacción | No | No | 60 | El tiempo (en segundos) que el nodo espera a que IMS procese una transacción. Si IMS no puede procesar una transacción en este momento, el nodo emite una excepción, pero la conexión no se cierra. Puede establecer esta propiedad sólo si el recuadro de selección Usar propiedades de conexión definidas en nodo está seleccionado. Si el recuadro de selección no está seleccionado, se utiliza la propiedad ExecutionTimeoutSec en el servicio configurable. |
|
Servicio configurable | Sí | Sí | El servicio configurable del que se obtienen los detalles de conexión. Todos los detalles de conexión se obtienen del servicio configurable, excepto la información de seguridad, que se obtiene de la propiedad Identidad de seguridad. Esta propiedad es obligatoria si el recuadro de selección Usar propiedades de conexión definidas en nodo no está seleccionado, y sólo se puede establecer si no está seleccionado Usar propiedades de conexión definidas en nodo. |
configurableService | |
Identidad de seguridad | No | Sí | Una serie vacía | La identidad de seguridad a buscar en el intermediario para obtener el nombre de usuario y la contraseña que se debe utilizar. Utilice al mandato mqsisetdbparms para establecer la identidad de seguridad en el intermediario. El valor predeterminado para esta propiedad es una serie vacía, que significa que el ID de usuario y la contraseña no se pasan a IMS Connect. | securityIdentity |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Modalidad de confirmación | Sí | No | 1: SEND_THEN_COMMIT | La modalidad de confirmación al procesar transacciones IMS. Los valores disponibles son:
|
Nivel de sincronización | Sí | No | 1: CONFIRM | El nivel de sincronización al procesar transacciones IMS. Si la Modalidad de confirmación se establece en 0, el Nivel de sincronización se establece automáticamente en
1: CONFIRM. Si la Modalidad de confirmación se establece en 1, la propiedad Nivel de sincronización puede tener uno de los siguientes valores:
Normalmente, el Nivel de sincronización se puede establecer en 0: NONE para los tipos de interacciones de sólo lectura, como las consultas, que no necesitan un acuse de recibo. Sin embargo, para las transacciones críticas que incluyen actualizaciones y supresiones, es importante poder reconocer la salida de IMS. Si no se recibe el acuse de recibo (por ejemplo, debido a una anomalía en la conexión entre WebSphere Message Broker y IMS Connect), la transacción se restituye, y se evita la necesidad de una transacción de compensación. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Ubicación de datos | Sí | No | $Body | La ubicación del árbol de mensajes de entrada de la que se recuperan los datos para formar la petición que se envía del nodo IMSRequest a IMS. El valor predeterminado, $Body, representa el cuerpo del mensaje de entrada. Puede especificar cualquier expresión XPath o ESQL que defina la ubicación del árbol de mensajes para serializar y enviar a IMS. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Ubicación de datos de salida | No | No | $OutputRoot | La ubicación del árbol de mensajes en la que el nodo IMSRequest copia el árbol de mensajes de respuesta en el conjunto de mensajes de salida. El valor predeterminado, $OutputRoot, sustituye el mensaje de entrada por la respuesta. Consulte el apartado Combinación de un mensaje de resultado con un mensaje de entrada. |
Copiar entorno local | No | No | Seleccionado | Esta propiedad controla si se debe copiar el entorno local de entrada o propagar el entorno local de entrada. De forma predeterminada, este recuadro de selección está seleccionado, lo que significa que el entorno local se copia de modo para que se conserve el entorno local de entrada. Las adiciones al entorno local sólo son visibles para los nodos en sentido descendente de este nodo. Si este recuadro de selección no está seleccionado, el entorno local de entrada se utiliza para el mensaje de salida. Todas las modificaciones que se realizan en el entorno local mediante este nodo son visibles para los nodos en sentido descendente y en sentido ascendente después de que este nodo se haya completado. |
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Dominio de mensajes | No | No | Dominio que a utilizar para analizar el mensaje de la corriente de bits proporcionada por el recurso externo. | ||
Conjunto de mensajes | No | No | Se establece automáticamente | Nombre del conjunto de mensajes en el que se define el mensaje
de entrada. Si establece esta propiedad y a continuación actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes. |
|
Tipo de mensaje | No | No | Nombre del mensaje de respuesta. | ||
Formato del mensaje | No | No | Nombre del formato físico del mensaje de respuesta. | ||
ID de juego de caracteres codificado del mensaje | Sí | No | EBCDIC (500) | El ID del juego de caracteres codificado que se utiliza para interceptar los bytes de los datos que se leen. Los valores válidos son EBCDIC (500) y Valor predeterminado del sistema de intermediario. | messageCodedCharSetIdProperty |
Codificación del mensaje | Sí | No | Big Endian, con coma flotante S390 (785) | El esquema de codificación para números y caracteres
grandes que se utiliza para interpretar los bytes de los datos que se leen. Los valores válidos son:
|
messageEncodingProperty |
Las propiedades Opciones de análisis del nodo IMSRequest se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | Sí | No | A petición | Esta propiedad controla cuándo se analiza un mensaje de respuesta. Los valores válidos son A
petición, Inmediato
y Completo. Para obtener una descripción completa de esta propiedad, consulte Análisis a petición. |
Crear árbol utilizando los tipos de datos de esquema XML | Sí | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos de sintaxis en el árbol de mensajes con tipos de datos tomados del esquema XML. Esta propiedad sólo se puede seleccionar si se establece la propiedad Validar del separador Validación en Contenido o Contenido y valor. |
Utilizar analizador compacto XMLNSC para dominio XMLNS | Sí | No | No seleccionado | Esta propiedad controla si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje de respuesta aparecerán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o el Dominio de las propiedades de Análisis de mensajes de respuesta sea XMLNS. |
Retener contenido mixto | Sí | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra texto mixto en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento. |
Retener comentarios | Sí | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra comentarios en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento. |
Retener instrucciones de proceso | Sí | No | No seleccionado | Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra instrucciones de proceso en un mensaje de respuesta. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento. |
Elementos opacos | No | No | Espacio en blanco | Esta propiedad se utiliza para especificar una lista de elementos en el mensaje de respuesta que se analizan opacamente por el analizador XMLNSC. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada. |
Las propiedades de validación del nodo IMSRequest se describen en la siguiente tabla.
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | Sí | Sí | Ninguno | Esta propiedad controla si tiene lugar la validación. Los valores válidos son Ninguno, Contenido y valor, Contenido y Heredar. | validateMaster |
Acción para anomalía | Sí | No | Excepción | Esta propiedad controla qué sucede si falla la validación. Sólo puede establecer esta propiedad si establece Validar en Contenido o Contenido y valor. Los valores válidos son Rastreo de usuario, Anotaciones de error locales, Excepción y Lista de excepciones. |
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sucesos | No | No | Ninguno | Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |