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

Nodo IMSRequest

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:

Finalidad

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:

Esta imagen muestra el icono del nodo IMSRequest.

Utilización del nodo IMSRequest en un flujo de mensajes

El nodo IMSRequest envía solicitudes a IMS utilizando IMS. El nodo toma la corriente de bits del mensaje de entrada y lo envía a IMS. A continuación recibe una corriente de bits, que pasa al analizador de respuesta. La corriente de bits que se envía a IMS debe ajustarse al formato que se muestra en el siguiente diagrama:
Este diagrama muestra la corriente de bits y se describe en el texto adyacente.
El flujo de mensajes que contiene el nodo IMSRequest asegura que el mensaje que recibe el nodo IMSRequest tenga esta estructura, donde:
  • LLZZ es un campo de cuatro bytes. Los dos primeros bytes indican la longitud de la corriente de bits, y los otros dos bytes se reservan para que IMS los utilice.
  • Para segmentos de solicitud, el código de transacción debe ir a continuación. El código de transacción puede contener hasta ocho caracteres; si contiene menos de ocho caracteres, el código de transacción debe delimitarse mediante un espacio. No es necesario que los segmentos de respuesta tengan el nombre de transacción, pero un programa IMS puede añadirlo.
  • El resto de los datos incluye todo lo demás que el programa IMS necesita.
El programa IMS genera muchos mensajes. Puede recibir todos los mensajes como una sola corriente de bits de transmisión o puede recibirlos por separado. Cada mensaje puede contener varios segmentos; todos los segmentos para cada mensaje se devuelven a la vez.
El nodo IMSRequest tiene dos modalidades de operación, que se especifican seleccionando o deseleccionando el recuadro de selección Usar propiedades de conexión definidas en nodo. Si selecciona el recuadro de selección, todas las propiedades se obtienen del nodo utilizando las siguientes propiedades de la sección de detalles de la conexión del nodo:
  • Nombre de host
  • Número de puerto
  • Nombre de almacén de datos
Si no selecciona el recuadro de selección Usar propiedades de conexión definidas en el nodo , todos los detalles de conexión se recuperan de los servicios configurables. Sin embargo, si se ha establecido la propiedad Identidad de seguridad, la identidad de seguridad del servicio configurable se ignora y en su lugar se utiliza el valor de la propiedad del nodo.

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.

Consulte el ejemplo siguiente para ver cómo se debe utilizar este nodo:

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.

Terminales y propiedades

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:
  • El programa IMS no ha respondido en el momento de que caduca el tiempo de espera de la ejecución. El tiempo de espera de ejecución se configura utilizando la propiedad Tiempo de espera a la espera de que se ejecute una transacción en el nodo IMSRequest.
  • WebSphere Message Broker no ha recibido la respuesta a través de la red TCP/IP al caducar el tiempo de espera del socket. Puede configurar el tiempo de espera del socket en el servicio configurable.

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).

Las propiedades de Descripción del nodo IMSRequest están descritas en la siguiente tabla.
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.
Las propiedades básicas del nodo IMSRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Usar propiedades de conexión definidas en nodo No 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   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 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   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   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 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
Las propiedades Avanzadas del nodo IMSRequest están descritas en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Modalidad de confirmación No 1: SEND_THEN_COMMIT La modalidad de confirmación al procesar transacciones IMS. Los valores disponibles son:
  • 1: SEND_THEN_COMMIT: (el valor valor predeterminado) La transacción se procesa utilizando la modalidad de confirmación 1 en IMS. La transacción de solicitud se ejecuta y los datos se devuelven al nodo. Una vez que el nodo reconoce que ha recibido la respuesta, la transacción se ha comprometido. No puede procesar la respuesta antes de que esté comprometida. El nodo envía la respuesta después de enviar el acuse de recibo a IMS.
  • 0: COMMIT_THEN_SEND: la transacción se procesa utilizando la modalidad de confirmación 0 en IMS. La transacción de solicitud se ejecuta y compromete antes de que los datos se devuelven al nodo. El nodo espera a que se devuelvan todos los mensajes de respuesta antes de continuar el proceso.
Nivel de sincronización 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:
  • 1: CONFIRM: (el valor predeterminado) El nodo envía un acuse de recibo a IMS después de recibir las respuestas. El nodo luego enviará la respuesta después de enviar el acuse de recibo a IMS. Si establece el Nivel de sincronización en 1: CONFIRM, el programa IMS se bloquea hasta que el nodo IMSRequest reconozca la salida de transacción, que puede afectar al rendimiento.
  • 0: NONE: El nodo no envía ningún acuse de recibo. Este valor sólo se puede aplicar cuando la Modalidad de compromiso se ha establecido en 1.

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.

Las propiedades de petición del nodo IMSRequest se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Ubicación de datos 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.
Las propiedades de resultado del nodo IMSRequest se describen en la siguiente tabla.
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.
En la tabla siguiente se describen las propiedades de Análisis de mensajes de respuesta del nodo IMSRequest.
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 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 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:
  • Little Endian, con coma flotante IEEE (546)
  • Big Endian, con coma flotante IEEE (273)
  • Big Endian, con coma flotante S390 (785)
  • Determinado por el sistema de intermediario
Para obtener más información sobre la codificación, consulte Conversión de datos.
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 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 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 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 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 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 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.

Para ver una descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Validar 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 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.  
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
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.

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:54


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