Interfaces de comunicación y recuperación de recursos de la AEA

Esta sección describe la implementación CICS® de los elementos de Comunicaciones y Recuperación de Recursos de la Interfaz de Programación Común de la Arquitectura de Aplicaciones de Sistemas® (también conocidas como las interfaces de Comunicaciones SAA y Recuperación de Recursos SAA, respectivamente). Se trata de interfaces de programación de aplicaciones basadas en llamadas que son comunes a todos los lenguajes de programación y a todos los sistemas de hardware. El componente de interfaz de programación común (CPI) de CICS, también conocido a veces como componente CP, proporciona interfaces de programación de aplicaciones que se ajustan a las especificaciones de SAA para las interfaces de Comunicaciones y Recuperación de Recursos. El componente CPI forma parte del dominio AP, y se distribuye sólo como código objeto (OCO).

Nota: Este componente CICS no maneja actualmente ningún otro elemento de interfaz SAA.

interfaz de comunicaciones de SAA

La interfaz SAA Communications permite a las aplicaciones CICS comunicarse mediante enlaces APPC LU6.2 ) con aplicaciones asociadas en cualquier sistema que cumpla las normas SAA. Esta interfaz consiste en un conjunto de verbos definidos como llamadas al programa que se adaptan al lenguaje utilizado. Para más información sobre la API general basada en llamadas, véase z/VM : Guía del Usuario de Comunicaciones CPI.

La interfaz SAA Communications de CICS ofrece una alternativa a la interfaz de aplicación existente para el procesamiento de transacciones distribuidas (véase Procesamiento de transacciones distribuidas ). Una única transacción puede utilizar comandos EXEC CICS para una conversación mientras utiliza llamadas de SAA Communications para otra conversación (independiente). Además, un extremo de una conversación puede utilizar comandos CICS EXEC mientras que el otro extremo utiliza llamadas de SAA Communications. Sin embargo, no es posible utilizar una mezcla de comandos EXEC CICS y llamadas de SAA Communications en el mismo extremo de una conversación.

interfaz de recuperación de recursos de SAA

La interfaz de recuperación de recursos de SAA proporciona una interfaz de programación de aplicaciones de SAA para la confirmación (SRRCMIT ) y la retirada (SRRBACK ) de recursos recuperables. Para más información, consulte Referencia de recuperación de recursos de la interfaz de programación común de la arquitectura de aplicaciones de sistemas.

La interfaz de recuperación de recursos SAA en CICS proporciona una alternativa al uso de los comandos EXEC CICS SYNCPOINT y EXEC CICS SYNCPOINT ROLLBACK. La llamada SRRCMIT equivale al comando EXEC CICS SYNCPOINT, y la llamada SRRBACK equivale al comando EXEC CICS SYNCPOINT ROLLBACK. Una misma aplicación puede utilizar llamadas de recuperación de recursos SAA, comandos EXEC CICS o una mezcla de ambos.

Vista general del diseño de la interfaz SAA Communications

Cuando una aplicación emite una llamada a SAA Communications, el control pasa a través del stub de enlace-edición de aplicaciones DFHCPLC al programa de interfaz de programación común (DFHCPI), que a su vez pasa la solicitud al módulo de carga de programas DFHCPIC. DFHCPIC verifica los parámetros, comprueba el estado de la conversación y (si es necesario) emite una macro llamada DFHLUC para invocar el módulo lógico de solicitud de aplicación LU6.2 (DFHZARL). Para más detalles sobre DFHZARL, véase Procesamiento de transacciones distribuidas.

La figura 1 muestra cómo el soporte de la interfaz SAA Communications se relaciona con la comunicación intersistema (ISC) CICS utilizando z/OS® Communications Server LU6.2. Los números de la figura remiten a las notas que la siguen. CMxxxx representa una llamada de programa definida en la interfaz de comunicaciones SAA.

Cuando una aplicación hace una solicitud EXEC CICS utilizando el procesamiento de transacciones distribuidas (DTP), es manejado por el componente de interfaz EXEC (que implica DFHEIP, DFHEGL, DFHETC y DFHETL). Cuando una aplicación hace una solicitud de aplicación CMxxxx, es manejada por el módulo de carga DFHCPIC dentro del componente CP. Tanto el componente de interfaz EXEC como el componente CP convierten las peticiones de la aplicación en macro peticiones DFHLUC, que llaman a DFHZARL (para un enlace intersistema LU6.2 ). La interfaz SAA Communications también utiliza un objeto RDO denominado PARTNER, encapsulado por el componente PR. — Figura 1. Tramitación de las solicitudes de comunicación de la AEA

Nota:

El procesamiento de transacciones distribuidas (DTP) permite que una transacción que utiliza comandos EXEC CICS se comunique con una transacción que se ejecuta en otro sistema. De ello se encargan DFHEIP y los módulos procesadores de interfaz EXEC relacionados. Para un enlace entre sistemas z/OS Communications Server LU6.2 2, cada petición se convierte en peticiones de macro DFHLUC que llaman a DFHZARL.
La interfaz de Comunicaciones SAA es implementada por el módulo de carga DFHCPIC dentro del componente CP (o CPI). DFHCPIC mapea las peticiones de la aplicación CMxxxx en llamadas a macros DFHLUC.
Para iniciar una conversación, la interfaz de SAA Communications requiere información específica (información lateral) sobre el programa asociado, incluido su nombre y los detalles del sistema. Esto se implementa dentro de CICS como un objeto RDO llamado PARTNER, que está encapsulado por el componente gestor de recursos de interlocutor (PR).

Cuando se utiliza la interfaz de comunicaciones SAA en conversaciones recuperables (es decir, conversaciones con el nivel de sincronización establecido en CM_SYNC_POINT), las solicitudes de punto de sincronización DFHLUC se enrutan a DFHZARL a través del gestor de solicitudes de punto de sincronización de la interfaz de comunicaciones SAA (DFHCPSRH) en el módulo de carga DFHCPIC. Esto permite seguir el estado de la conversación.

Para las conversaciones equivalentes de EXEC CICS synclevel 2, las peticiones de syncpoint DFHLUC pasan directamente a DFHZARL.

Visión general del diseño de la interfaz de recuperación de recursos de la AEA

Cuando una aplicación emite una llamada de recuperación de recursos SAA, el control pasa a través del stub de enlace-edición de aplicaciones DFHCPLRR al programa de interfaz de programación común (DFHCPI), que a su vez pasa la solicitud al módulo de carga de programas DFHCPIRR. DFHCPIRR verifica los parámetros y (si es necesario) emite una llamada a la macro DFHSP apropiada: DFHSP TYPE=USER para SRRCMIT, o DFHSP TYPE=ROLLBACK para SRRBACK.

La figura 2 muestra cómo se relaciona el soporte de la interfaz de recuperación de recursos SAA con el procesamiento de los comandos EXEC CICS SYNCPOINT. El número de la figura remite a la nota adjunta. SRRxxxx representa una llamada de programa definida en la interfaz de recuperación de recursos SAA, a saber, SRRBACK o SRRCMIT.

Los comandos EXEC CICS SYNCPOINT son manejados por el componente de interfaz EXEC (DFHEIP y DFHESP), que los convierte en peticiones DFHSP. Las peticiones de aplicación SRRxxxx son gestionadas por el módulo de carga DFHCPIRR en el componente CP, que también produce peticiones DFHSP. Las solicitudes DFHSP son gestionadas por el dominio del gestor de recuperación. — Figura 2. Tramitación de la solicitud de recuperación de recursos de la AEA

Funciones del componente CPI

La tabla 1 resume las interfaces de subrutinas externas proporcionadas por el componente CPI. Muestra los formatos de llamada a subrutina, los ID de punto de rastreo de nivel 1 de los módulos que proporcionan las funciones para estos formatos y las funciones proporcionadas.

Tabla| 1. Interfaces de subrutinas del componente CPI
Formato	rastreo	Función
CPIN	AP 0C01 AP 0C02	INICIO_INICIAL INICIO_COMPLETO
CPSP	AP 0CD0 AP 0CD1	SOLICITUD_DE_PUNTO_DE_SINCRONIZACIÓN

Módulos

Módulo	Función
DFHAPTRF	Intérprete de trazas para las interfaces de comunicaciones y recuperación de recursos de la AEA
DFHCPARH	SAA Communications application request handler (procesador de entrada para todas las llamadas de aplicación al módulo de carga DFHCPIC, dirigiéndolas al módulo DFHCPCxx apropiado)
DFHCPCxx	Componentes del módulo de carga DFHCPIC, cada módulo objeto gestiona normalmente una solicitud de aplicación CMxxxx diferente
DFHCPDUF	Formateador de volcado del sistema fuera de línea para la palabra clave CP
Índice de Precios al Consumidor Descentralizado	Programa de interfaz de programación común (enlazado con DFHEIP y DFHAICBP para formar el módulo de carga DFHAIP)
DFHCPIN1	Programa de gestión de la inicialización de las interfaces de comunicaciones y recuperación de recursos de la AEA
DFHCPIN2	Se ejecuta como una tarea CICS para realizar la inicialización de las interfaces SAA Communications y Resource Recovery
DFHCPIR	Procesador de entrada de recuperación de recursos SAA, que gestiona todas las llamadas al módulo de carga DFHCPIRR
DFHCPLC	Link-edit stub para aplicaciones que utilizan la interfaz SAA Communications
DFHCPLRR	Link-edit stub para aplicaciones que utilizan la interfaz de recuperación de recursos SAA
DFHCPSRH	SAA Communications syncpoint request handler (parte del módulo de carga DFHCPIC)

Salidas

No se proporcionan puntos de salida de usuario globales para este componente.

rastreo

Para este componente se proporciona el siguiente identificador de punto:

AP 0Cxx, cuyos niveles de traza son CP 1, CP 2 y Exc.