Para conectarse a una aplicación
CICS Transaction
Server for z/OS, cree un flujo de mensajes
que contenga un nodo CICSRequest.
Lleve a cabo los siguientes pasos para
desarrollar un flujo de mensajes con un nodo CICSRequest.
- Cree de un flujo de mensajes.
- Añada un nodo CICSRequest
al flujo de mensajes.
- Configure las siguientes propiedades en el nodo CICSRequest.
- Servidor CICS: La propiedad Servidor CICS se puede definir
o como nombre de servicio configurable, por ejemplo, myCICSConnection o como URL.
Puede
conectarse a CICS utilizando el modelo de conexión de dos niveles,
por ejemplo, haciendo una conexión directa de WebSphere Message Broker a CICS, o utilizando
el modelo de conexión de tres niveles, por ejemplo, conectándose a CICS mediante CICS Transaction
Gateway for Multiplatforms. Para obtener
más información acerca de la conexión de los modelos de dos niveles y de
tres niveles, consulte Visión general del CICS Transaction Server for z/OS para obtener una visión general o Conectividad de dos niveles de CICS Transaction Server for z/OS y Conectividad de tres niveles de CICS Transaction Server for z/OS para
obtener información conceptual detallada.
- Utilizando el modelo de conexión de dos niveles:
- Si está realizando una conexión directa de dos niveles de conexión de WebSphere Message Broker a CICS,
puede definir la propiedad servidor CICS o como nombre de servicio
configurable, por ejemplo, myCICSConnectiono como URL.
Para obtener más información sobre cómo definir esta propiedad como servicio
configurable, consulte Cambio de la información de conexión para el nodo CICSRequest.
Para definir
un URL, especifique el protocolo y el nombre de host y número de puerto de
CICS.
El formato de este valor es
protocolo://nombre_host:puerto.
donde:
- protocolo puede ser tcp o ssl.
- nombre_host es la dirección TCP/IP del host CICS.
- puerto es el número de puerto del escucha TCPIPSERVICE en CICS que escucha
solicitudes IPIC a través de TCP/IP o SSL.
Por ejemplo:
tcp://mycicsregion.com:12345 o
ssl://mycicsregion.com:56789.
Puede obtener los valores de
nombre_host y
puerto de la definición de IPIC TCPIPSERVICE de la región
CICS de destino.
- Utilizando el modelo de conexión de tres niveles:
- Si está realizando una conexión de tres niveles a CICS
mediante CICS Transaction
Gateway for Multiplatforms, la propiedad del nodo CICSRequest del
servidor CICS debe definirse como un nombre de servicio configurable, por ejemplo, myCICSConnection.
Para obtener más información sobre cómo definir esta propiedad como servicio
configurable, consulte Cambio de la información de conexión para el nodo CICSRequest.
Para realizar una conexión de tres
niveles a CICS mediante CICS Transaction
Gateway for Multiplatforms, debe configurar las propiedades
cicsServer y gatewayURL
del servicio configurable CICSConnection. Para obtener más información acerca de la configuración de las
propiedades cicsServer y gatewayURL del servicio configurable
CICSConnection para realizar una conexión de tres niveles, consulte Propiedades de servicios configurables.
- Nombre de programa: especifique
el nombre del programa que desea ejecutar en la región
CICS de destino.
Puede alterar temporalmente esta propiedad en el entorno local
especificando un valor en la ubicación siguiente:
$LocalEnvironment/Destination/CICS/CICSProgramName
- Estructura de datos: especifique si
desea utilizar una COMMAREA o una estructura de datos de canal. El valor predeterminado para esta propiedad
es Commarea.
La decisión depende del destino programa CICS, por ejemplo,
si el programa destino está basado en canal o no.
- Longitud del área de comunicación:
Esta
propiedad no es configurable si se ha seleccionado el valor de Canal
para la propiedad Estructura de datos .
La propiedad Longitud de commarea es el tamaño, en bytes,
del COMMAREA utilizado por el programa CICS. El valor de tamaño en
bytes se envía a CICS y, antes
de que se inicie el programa, se crea un área de memoria para que
coincida con ese número. Por ejemplo, si envía un valor
de Longitud del área de comunicación
de 100, se asignan 100 bytes.
El
programa accede a esta área como DFHCOMMAREA.
Asegúrese
de que el valor de la propiedad Longitud del
área de comunicación sea lo suficientemente grande como para contener los datos
de solicitud de entrada, o los datos de respuesta de salida, pero que no exceda el valor
máximo de 32767 bytes.
Si el valor de Longitud del área de
comunicación no es lo suficientemente grande como para utilizarlo
para los datos de respuesta, o los datos de solicitud, se produce una fuga de
memoria en CICS.
El tamaño del COMMAREA no puede ser cambiado por el programa de CICS.
Si
el tamaño de los datos de solicitud serializados es superior a la
Longitud del área de comunicación, los datos se
truncan a la Longitud del área de
comunicación.
Puede obtener el valor de la
Longitud del área de comunicación del administrador o desarrollador de CICS.
Puede
alterar temporalmente esta propiedad en el entorno local
especificando un valor en la ubicación siguiente:
$LocalEnvironment/Destination/CICS/CICSCommareaLen
- Modalidad de
transacción: Especifique si las solicitudes al nodo
CICSRequest se van a gestionar como
transaccionales o no transaccionales.
- Si selecciona Sí, el nodo CICSRequest participará en la transacción local
que inicia el nodo de entrada del flujo de mensajes.
- Si selecciona No, el nodo CICSRequest no participará en la transacción local
que inicia el nodo de entrada del flujo de mensajes.
- Si selecciona Automática, la
transaccionalidad del mensaje se hereda del valor Modalidad de transacción en el nodo de
entrada al inicio del flujo de mensajes. Por ejemplo,
si el flujo de mensajes está controlado por un nodo MQInput, el nodo
CICSRequest adopta la Modalidad de transacción
que está establecida en el nodo MQInput. De
forma predeterminada, la propiedad Modalidad de transacción del nodo
CICSRequest se establece en
Automática.
Para
obtener más información sobre la transaccionalidad, consulte Transacciones de flujo de mensajes.
- Guarde el flujo de mensajes.
- Despliegue el flujo de mensajes.
A continuación: cuando haya creado y
configurado el flujo de mensajes, cree un mensaje siguiendo los pasos descritos
en
Creación de un mensaje para el nodo CICSRequest.