[z/OS]

Invocación de las transacciones IMS existentes con adaptadores locales optimizados a través de OTMA

Las transacciones IMS sin modificar existentes que se ejecutan como programas de proceso de mensajes (MPP) o programas de vía de acceso rápida (IFP) pueden invocarse utilizando los adaptadores locales optimizados de WebSphere Application Server para z/OS a través del soporte de OTMA C/I (Interfaz invocable de acceso a gestor de transacción abierto). Este soporte se proporciona mediante un nuevo conjunto de módulos nativos introducido con los adaptadores locales optimizados que utilizan IMS OTMA C/I.

Las aplicaciones que se despliegan en WebSphere Application Server para z/OS y deben invocar las transacciones IMS existentes utilizan el archivo ola.rar para alcanzar los módulos de interfaz OTMA C/I. Existen varios atributos de fábrica de conexiones nuevos que permiten a las aplicaciones proporcionar el nombre del sistema IMS de destino y la información XCF de OTMA asociada. Además, se ha añadido un atributo que permite a la aplicación establecer el nivel de sincronización que se utiliza para el intercambio. Consulte el tema Consideraciones de fábrica de conexiones para adaptadores locales optimizados para obtener más detalles sobre estos parámetros.

Las transacciones IMS globales están soportadas en las versiones 8.5.0.2 y posteriores. Las aplicaciones que se ejecutan en una transacción global con WebSphere Application Server como coordinador de confirmación, que llama a las aplicaciones IMS existentes mediante el soporte WOLA sobre OTMA, puede incluir transacciones IMS en el mismo contexto de transacciones globales.

Consulte la sección Transacciones globales - Aplicaciones de Websphere que llaman a aplicaciones IMS para obtener más información.

Requisitos de formato de mensajes

Antes del soporte de mensajes de varios segmentos de la versión 8, los mensajes de solicitud y respuesta debían ser segmentos únicos, con un tamaño máximo de segmento de envío y recepción que no superara los 32760 bytes, incluida la cabecera del mensaje.

A continuación, se muestra el formato de mensaje esperado para las llamadas a IMS desde las aplicaciones en WebSphere Application Server:
<----------------- HEADER ---------------->   <------ DATA ------>
LL        + ZZ        + IMS Transaction Name + Message request data
(2 bytes) | (2 bytes) | (8 bytes)            | (up to 32744 bytes)

El nombre de transacción en el mensaje se utiliza para la llamada a OTMA C/I y debe ser una transacción definida y alcanzable en un IMS MPR o una región dependiente de vía de acceso rápida.

Antes de la versión 8, los datos de respuesta siempre se devolvían con el formato siguiente:
<----- HEADER ----->   <------------------ DATA ----------------->
LLLL                  + Message response data
(4 bytes)             | (up to 32756 bytes) 
El asistente de enlace de datos Java™ de CICS/IMS en Rational Application Developer se utiliza para crear clases de ayudante con los métodos de establecimiento y obtención que se pueden utilizar para manejar datos de correlación a/de objetos Java y formatos binarios. Esta correlación de datos se aplica a los mensajes enviados a IMS desde WebSphere Application Server y también a los datos de respuesta.
Atención: Antes de la versión 8, cuando sólo se daba soporte a mensajes de un solo segmento, el mensaje de respuesta siempre iba precedido de un mensaje de 4 byte de longitud, seguido por el mensaje de respuesta, que es el área correlacionada por el asistente de Enlace de datos.

Soporte para mensajes multisegmento

Los mensajes de varios segmentos IMS permiten que los mensajes de solicitud y respuesta tengan un tamaño mayor que el valor anterior de 32744 bytes para los mensajes de solicitud y 32756 bytes para los mensajes de respuesta. No obstante, un segmento no puede tener más de 32768 bytes, incluyendo la cabecera del mensaje.

Este soporte añade dos atributos de fábrica de conexiones:
  • OTMAMaxSegments

    OTMAMaxSegments representa el número máximo de segmentos soportados para enviar y recibir mensajes de IMS en la conexión actual. Si no se especifica un valor, el valor predeterminado es 1.

  • OTMAMaxRecvSize

    OTMAMaxRecvSize representa el mensaje más grande posible que se puede devolver desde IMS utilizando los adaptadores locales optimizados de WebSphere a través del soporte OTMA. Si no se especifica un valor, el valor predeterminado es 32768.

Estos dos atributos se pueden modificar dinámicamente para una conexión utilizando los métodos asociadas setOTMAMaxSegments() y setOTMAMaxRecvSize().

Transacciones globales - Aplicaciones de Websphere que llaman a aplicaciones IMS

A partir de la Versión 8.5.0.2, cuando una aplicación WebSphere se ejecuta en una transacción global, dicha aplicación puede llamar a programas IMS existentes utilizando el soporte de WOLA sobre OTMA y hacer que las actualizaciones realizadas por el programa IMS sean coordinadas por la misma transacción global en la que la aplicación WebSphere participa. Si desea utilizar esta funcionalidad, debe asegurarse de lo siguiente:
  • La aplicación debe utilizar una conexión configurada para usar OTMA, y el atributo de fábrica de conexiones gestionadas RRSTransactional debe establecerse en True (o 1). Establecer el atributo RRSTransactional en True (o 1) habilita las transacciones RRS para las conexiones.
  • El servidor WebSphere Application Server para z/OS se ejecuta con la variable de entorno ola_rrs_context_propagate_otma instalada y establecida en True (o 1).
  • El entorno IMS se ejecuta con RRS=YES configurado.

Si necesita implementar cualquiera de estos valores de configuración, debe reiniciar el servidor WebSphere Application Server para z/OS y el entorno IMS para que las aplicaciones que se ejecutan en una transacción global con WebSphere Application Server puedan coordinar el contexto de las transacciones con las aplicaciones que se ejecutan en IMS.

Requisitos de formato de los mensajes multisegmento.

Para los mensajes de varios segmentos, el valor predeterminado es LLZZ para las solicitudes desde los adaptadores locales optimizados de WebSphere hacia IMS. Los datos de LLLL+mensajes predeterminados para las respuestas desde IMS hacia WebSphere Application Server no varían.

En este soporte se proporcionan métodos que permiten cambiar estos valores predeterminados. Los métodos setOTMARequestLLZZ() y setOTMARequestLLLL() permiten establecer el estilo del prefijo de longitud de las solicitudes de mensajes desde WebSphere Application Server a IMS. Los métodos, setOTMAResponseLLZZ() y setOTMAResponseLLLL(), proporcionan la capacidad de definir el estilo de prefijo de longitud a LLZZ o LLLL para las respuestas de mensaje. En el ejemplo siguiente, se muestra el formato de mensaje esperado para las llamadas a IMS desde las aplicaciones en WebSphere Application Server.

Solicitudes LLZZ (setOTMARequestLLZZ(1) y setOTMARequestLLLL(0)):
<----------------- HEADER ------------------>   
LL        + ZZ        + IMS Transaction Name + 
(2 bytes) | (2 bytes) | (8 bytes)            
<-------------------------- DATA SEGMENT 1 ---------------------->
Message segment 1 data  
(up to 32756 bytes)    
<-------------------------- DATA SEGMENT 2 ---------------------->
+ LL        + ZZ      + Message segment 1 data 
(2 bytes) | (2 bytes) | (up to 32764 bytes)
…
<-------------------------- DATA SEGMENT N ---------------------->
+ LL        + ZZ      + Message segment N data 
(2 bytes) | (2 bytes) | (up to 32764 bytes)
Solicitudes LLLL (setOTMARequestLLLL(1) y setOTMARequestLLZZ(0)):
<----------------- HEADER ------------------>   
LLLLZZ    + IMS Transaction Name + 
(6 bytes) | (8 bytes)            
<-------------------------- DATA SEGMENT 1 ---------------------->
Message segment 1 data  
(up to 32754 bytes)    
<-------------------------- DATA SEGMENT 2 ---------------------->
+ LLLLZZ  + Message segment 1 data 
(6 bytes) | (up to 32762 bytes)
…
<-------------------------- DATA SEGMENT N ---------------------->
+ LLLLZZ  + Message segment 1 data 
(6 bytes) | (up to 32762 bytes)
Respuestas LLZZ (setOTMAResponseLLZZ(1) y setOTMAResponseLLLL(0)):
<----- HEADER ----->   <----------- DATA SEGMENY 1 ------------>
+ LL        + ZZ      + Message segment 1 data 
(2 bytes) | (2 bytes) | (up to 32764 bytes)
<-------------------------- DATA SEGMENT 2 ---------------------->
+ LL        + ZZ      + Message segment 2 data 
(2 bytes) | (2 bytes) | (up to 32764 bytes)
…
<-------------------------- DATA SEGMENT N ---------------------->
+ LL        + ZZ      + Message segment N data 
(2 bytes) | (2 bytes) | (up to 32764 bytes)
Respuestas LLLL (setOTMAResponseLLLL(1) y setOTMAResponseLLZZ(0)):
-- HEADER -->   <----------- DATA SEGMENT 1 ------------>
+ LLLLZZ        + Message segment 1 data 
(6 bytes)       | (up to 32762 bytes)
<-------------------------- DATA SEGMENT 2 ---------------------->
+ LLLLZZ   + Message segment 2 data 
(6 bytes)  | (up to 32762 bytes)
…
<-------------------------- DATA SEGMENT N ---------------------->
+ LLLLZZ  + Message segment N data 
(6 bytes) | (up to 32762 bytes)

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cdat_callexisttrans
File name: cdat_callexisttrans.html