Utilice el nodo JMSInput para recibir mensajes de destinos JMS. A los destinos JMS se accede mediante una conexión a un proveedor JMS.
El nodo JMSInput actúa como consumidor de mensajes JMS y puede recibir los seis tipos de mensajes definidos en Especificación Java Message Service, versión 1.1. Los mensajes se reciben utilizando llamadas de método, que se describen en la especificación JMS.
El nodo JMSInput se encuentra en la bandeja JMS de la paleta y está representado en el entorno de trabajo mediante el siguiente icono:
Los flujos de mensajes que manejan los mensajes que se reciben de las conexiones a proveedores JMS, deben empezar siempre con un nodo JMSInput. Si incluye un nodo de salida en un flujo de mensajes que empiece con un nodo JMSInput, éste podrá ser cualquiera de los nodos de salida soportados (incluidos los nodos de salida definidos por el usuario); no es necesario incluir un nodo JMSOutput. No obstante, si no incluye un nodo JMSOutput, deberá incluir el nodo JMSMQTransform para transformar el mensaje al formato que espera el nodo de salida.
Si está propagando mensajes JMS y creando un flujo de mensajes para utilizarlo como un subflujo, no puede utilizar un nodo de entrada estándar; deberá utilizar una instancia del nodo JMSInput como primer nodo a fin de crear un terminal de entrada para el subflujo.
export MQSI_LIBPATH32=$MQSI_LIBPATH32:/usr/mqm/lib:/usr/mqm/java/lib
Los servicios configurables están definidos para varios proveedores de JMS. Puede elegir uno de los servicios predefinidos, o bien puede crear un servicio nuevo para un nuevo proveedor, o para uno de los proveedores existentes.
mqsireportproperties nombreIntermediario -c AllTypes -o AllReportableEntityNames -r
Utilice el mandato mqsireportproperties para ver las propiedades del proveedor y el mandato mqsichangeproperties para establecer o modificar las propiedades.
Para cada mensaje que se recibe satisfactoriamente, el nodo JMSInput direcciona el mensaje al terminal Out (de salida). Si esta acción falla, se reintenta el mensaje. Si se alcanza el umbral de reintentos, estando definido el umbral por la propiedad Umbral de reintentos del nodo, el mensaje se direcciona al terminal de anomalías. Puede conectar nodos al terminal de anomalías para manejar esta condición.
Si se produce una excepción en la vía de acceso de anomalías, se vuelve a intentar la vía de acceso hasta que el número de intentos duplique el Umbral de restituciones. Si se sobrepasa este límite, el mensaje se transfiere al Destino de restitución.
Si no ha conectado nodos al terminal de anomalías, el mensaje se escribe en el Destino de restitución. Si no ha especificado un Destino de restitución, el nodo emite un mensaje de errorBIP4669 y deja de procesar entradas.
Si el nodo JMSInput capta el mensaje después de que se haya generado una excepción en cualquier otro lugar del flujo de mensajes, el mensaje se direcciona al terminal Catch (de captación). Si no ha conectado nodos al terminal de captación, el nodo restituye los mensajes para reentregarlos hasta que se resuelva el problema o se alcance el Umbral de restituciones. Si no define un Destino de restitución, el nodo emitirá un mensaje de error BIP4669 y dejará de procesar entradas.
Cuando se incluye un nodo JMSInput en un flujo de mensajes, el valor que se establece para la Modalidad de transacción indica si los mensajes se reciben bajo punto de sincronismo.
dir_instalación/bin/ JMSSwitch.dll XAOpenString=Contexto inicial,ubicación JNDI,parámetros_opcionales ThreadOfControl=THREAD
dir_instalación/bin/ JMSSwitch.dll XAOpenString=Contexto inicial,ubicación JNDI,parámetros_opcionales ThreadOfControl=THREAD
XAResourceManager: Name=Nombre_Proveedor_Jms SwitchFile=/dir_instalación/bin/ JMSSwitch.so XAOpenString=Contexto inicial,ubicación JNDI,parámetros_opcionales ThreadOfControl=THREADdonde:
Los parámetros opcionales están separados por coma y son posicionales. Por consiguiente, los parámetros que faltan deben representarse con una coma.
dir_instalación/classes/xarecovery.jar
dir_instalación/bin
Para obtener más información, consulte el manual System Administration Guide del Centro de información en línea de WebSphere MQ Versión 6 o el manual de la Versión 5.3 en página web de la biblioteca de WebSphere MQ.
Para utilizar el mismo gestor de colas para el intermediario y el proveedor JMS, asegúrese de que la instalación de WebSphere MQ está en el nivel mínimo requerido: Versión 5.3 CSD12 o Versión 6.0 Fixpack 1.
Para utilizar el mismo gestor de colas para el intermediario y el proveedor de JMS, asegúrese de que la instalación WebSphere MQ está en el nivel mínimo requerido: WebSphere MQ Versión 6.0 Fix Pack 1 o superior para XA si se desea utilizar el mismo gestor de colas para el intermediario y el proveedor.
El control de punto de sincronismo para el proveedor JMS se gestiona con la coordinación de puntos de sincronismo RRS del gestor de colas del intermediario. No necesita modificar el archivo .ini .
Cuando haya colocado una instancia del nodo JMSInput en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Para visualizar las propiedades del nodo en el diálogo Propiedades, efectúe una doble pulsación en el nodo o pulse con el botón derecho del ratón sobre el nodo y pulse Propiedades. Todas las propiedades obligatorias que no tienen un valor predeterminado aparecen con un asterisco.
Terminal | Descripción |
---|---|
Failure (de anomalías) | El terminal de salida al que se direcciona el mensaje si se produce un error. Aunque esté establecida la propiedad Validación, los mensajes propagados a este terminal no se validan. |
Out (de salida) | El terminal de salida al que se direcciona el mensaje si se recupera satisfactoriamente. |
Catch (de captación) | El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta. |
Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica 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 por omisión | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | El tipo de nodo, JMSInput | 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 por omisión | Descripción |
---|---|---|---|---|
Fábrica de contexto inicial | Sí | Sí | com.sun.jndi.fscontext. RefFSContextFactory | Punto de partida para un espacio de nombres
JNDI.
Entre un valor de Fábrica de contexto inicial. Una aplicación JMS utiliza el contexto inicial para obtener y buscar los objetos JNDI administrados para el proveedor JMS. El valor predeterminado es com.sun.jndi.fscontext.RefFSContextFactory, que define la Fábrica de contexto inicial para el proveedor JMS de WebSphere MQ. Para identificar el nombre de la Fábrica de contexto inicial para el proveedor JMS, consulte la documentación del proveedor JMS. |
Enlaces JNDI de ubicación | Sí | Sí | Vía de acceso de sistema o ubicación LDAP para el archivo de enlaces. El archivo de enlaces contiene definiciones
para los objetos JNDI administrados utilizados por el nodo
JMSInput. Cuando entre un valor para
Enlaces
JNDI de ubicación, asegúrese de que satisface las indicaciones siguientes:
Para obtener más información sobre cómo construir el archivo de enlaces de objetos JNDI administrados, consulte la documentación del proveedor JMS. |
|
Nombre de fábrica de conexión | Sí | Sí | El nombre de la fábrica de conexión que utiliza el nodo JMSInput para crear una conexión con el proveedor JMS. Este nombre ya debe existir en el archivo de enlaces. | |
Destino de restitución | No | Sí | El nodo JMSInput envía mensajes de entrada a este destino cuando los errores impiden que el flujo de mensajes procese el mensaje y el mensaje se debe eliminar del destino de entrada. El nombre del destino de restitución debe existir en el archivo de enlaces. | |
Umbral de restituciones | No | Sí | 0 | Valor que controla cuándo un mensaje que se ha vuelto a entregar se pone en el destino de restitución. Por ejemplo, si el valor es 3, el proveedor JMS intenta entregar el mensaje al destino de entrada tres veces. Tras el tercer intento de entrega, el mensaje se elimina del destino de entrada y se envía al Destino de restitución. |
Propiedad | O | C | Valor por omisión | Descripción |
---|---|---|---|---|
Modalidad de transacción | Sí | No | ninguno | Esta propiedad controla si el mensaje de entrada se recibe bajo punto de sincronismo externo,
punto de sincronismo local o fuera de punto de sincronismo.
|