Salida de dominio de mensajes XMEOUT

Puede utilizar la salida XMEOUT para suprimir o redireccionar mensajes CICS® y CICSPlex ® SM que utilizan el dominio de mensajes CICS .

El programa de salida tiene las restricciones siguientes:
  • Puede suprimir o redireccionar sólo los mensajes enviados a la consola del sistema o a colas de datos transitorios. No puede suprimir ni redireccionar los mensajes enviados a los operadores de terminal. No se invoca XMEOUT para los mensajes enviados a los operadores de terminal.
  • Puede suprimir o redireccionar sólo los mensajes que utilizan el dominio de mensajes. Puede determinar a qué mensajes CICS se aplica esto a partir de los mensajesCICS. La descripción de cada mensaje que puede invocar XMEOUT contiene una lista titulada Parámetros XMEOUT/Inserciones de mensajes; si no se listan parámetros XMEOUT para un mensaje, el mensaje no puede invocar la salida. Por ejemplo, el mensaje DFHDX8320 puede invocar XMEOUT, pero el mensaje DFHDU0205 no lo hace.
    Para CICSPlex SM, XMEOUT sólo se invoca para los mensajes que tienen un destino de EYULOG, porque estos son los mensajes que utilizan el dominio de mensajes. Puede determinar a qué mensajes se aplica esto desde Mensajes SM CICSPlex.
    Nota: Los mensajes de CICSPlex SM que invocan la salida XMEOUT solo se pueden redireccionar o suprimir desde el registro de trabajo o la consola, no desde EYULOG.
  • No puede redireccionar o suprimir mensajes de la interfaz de usuario web de CICSPlex SM.
  • No puede cambiar el texto de un mensaje o cambiar las inserciones del mensaje. Si intenta hacerlo, CICS ignora los cambios.
  • No puede suprimir ni redireccionar los mensajes emitidos durante las primeras etapas de la inicialización de CICS (porque la salida no se puede habilitar entonces).
  • No puede redireccionar un mensaje a colas de datos transitorios (TD) durante la conclusión de CICS , a menos que el destino de mensaje original incluyera una o más colas de datos transitorios. Si intenta hacerlo, el mensaje se direcciona a su destino original y el mensaje DFHME0120I se emite a la consola. El programa de salida de usuario no puede redireccionar el mensaje DFHME0120I, pero puede suprimir este mensaje.

    Esta restricción es necesaria porque el dominio de mensajes debe manejar mensajes durante la conclusión de CICS incluso después de que haya finalizado la función de cola de datos transitorios.

    Para descubrir si se ha iniciado la conclusión de CICS , el programa de salida puede comprobar la primera instancia del mensaje DFHME0120. Puede detener el redireccionamiento de mensajes a colas TD después de que se haya emitido DFHME0120 .

Nota: Si un mensaje se está redireccionando a una cola de datos transitorios y la solicitud de datos transitorios falla, el mensaje se pierde. Se escribe el ID de punto de rastreo de excepción MEME X'0328 '. La serie de interpretación de esta entrada de rastreo explica por qué ha fallado la solicitud de datos transitorios.

Importante

Debido al peligro de recurrencia, el programa de salida XMEOUT no debe intentar redireccionar los mensajes siguientes:
  • Cualquier mensaje DFHTDxxxx, que genera el programa de datos transitorios.
  • Los mensajes de dominio de usuario en el rango de DFHUS0002 aDFHUS0006, más el mensaje DFHUS0150.
  • Mensajes del gestor de transacciones DFHXM0212, DFHXM0213, DFHXM0304y DFHXM0308.
  • Mensajes de aplicación DFHAP0001, DFHAP0002, DFHAP0004, DFHAP0601, DFHAP0602y DFHAP0603.
  • Cualquier mensaje de dominio de usuario (DFHUSxxxx) a una cola intrapartición definida con un valor TRIGLEV que no sea cero, si los mensajes se producen mientras el dominio de usuario está realizando el proceso de recuperación de errores.

La plantilla de definición de mensajes contiene un indicador denominado noreroute. Este indicador se activa si el programa de salida XMEOUT no puede redireccionar el mensaje que se está emitiendo a una cola de datos transitoria. La dirección del indicador se pasa a XMEOUT en el parámetro específico de salida UEPNRTE. El programa de salida puede comprobar el valor del indicador antes de decidir si redireccionar un mensaje determinado.

Nota: Si el programa de salida intenta redireccionar un mensaje no elegible, el dominio de mensajes inhibe el redireccionamiento y emite el mensaje a la consola en su lugar, junto con el mensaje DFHME0137.

Cada mensaje afectado por esta restricción se identifica mediante una nota en CICS.

Es posible pasar APPLID (el identificador de aplicación) como parámetro opcional en un mensaje. Sin embargo, es posible que el APPLID que se inserta en un mensaje no sea el APPLID del sistema CICS actual. Por ejemplo, cuando un mensaje MAS de CICSPlex SM se direcciona a un CMAS, es posible que se pase el APPLID del sistema MAS , por lo que el mensaje contiene el APPLID del sistema MAS y no el sistema actual (el CMAS).

El programa de salida puede suprimir o redireccionar mensajes alterando los valores contenidos en las direcciones a las que apuntan los campos siguientes de la lista de parámetros. El programa no puede cambiar ningún otro conjunto de valores.
  • UEPMROU (códigos de ruta)
  • UEPMNRC (número de códigos de ruta)
  • UEPMTDQ (nombres de cola de datos transitorios)
  • UEPMNTD (número de TDQs)

Utilización de XMEOUT para supervisar el mensaje DFHAP1900

El mensaje DFHAP1900 se emite cuando se realiza un cambio en la configuración del sistema CICS mediante determinados mandatos de interfaz de programación del sistema. Estos mandatos son SET, PERFORM, ENABLE, DISABLEo RESYNC. Los mandatos se graban en la cola de datos transitorios CADS. Los mensajes DFHAP1900 pueden proporcionar auditoría de cambios de configuración dinámicos y también ayudar a la determinación de problemas. Para obtener más información, consulte Mandatos SPI que se pueden auditar.

Nota: No emita mandatos SPI en la salida que den como resultado un mensaje DFHAP1900 , porque se puede producir una recurrencia en la salida.