Si una versión de aplicación desplegada en una plataforma no tiene el estado esperado, siga este procedimiento de resolución de problemas para realizar la acción adecuada.
Antes de empezar
Utilice la vista Explorador de nubes en la perspectiva Nube de CICS para comprobar el estado de la versión de aplicación.
Comprobación del estado de una aplicación explica cómo utilizar la vista y lista los valores posibles para el estado de una versión de aplicación y de los componentes de gestión. Una versión de aplicación está habilitada si los paquetes de CICS a los que hacen referencia los componentes de gestión para la versión de aplicación se han instalado en las regiones CICS y todos ellos están habilitados. En las regiones CICS de la versión 5.2 de CICS TS, todavía no hay disponible una versión de aplicación habilitada para los interlocutores a través de sus puntos de entrada de aplicación.
Cuando la versión de la aplicación está disponible, los puntos de entrada de la aplicación y, por tanto, los recursos que controlan la aplicación estarán disponibles para los interlocutores.
Procedimiento
- Si el estado de una versión de aplicación es FAILED, compruebe el registro de salida de CICSPlex SM (el EYULOG) para ver detalles del problema que se ha producido mientras la aplicación se estaba instalando o descartando. Es posible que el repositorio de datos CICSPlex SM para CMAS
esté completo, en cuyo caso necesita aumentar su tamaño. Para expandir el repositorio de datos, utilice la función REPRO del programa de utilidad IDCAMS.
Puede encontrar un ejemplo del JCL para hacer esto en el miembro EYUJXDRP de la biblioteca
CICSTS51.CPSM.SEYUSAMP. En ese JCL, en la sentencia RECORDS(xx,yy), especifique un valor primario (xx) y uno secundario (yy) que sean adecuados para el entorno. Los valores iniciales son 500 y 3000.
- Si el estado de la versión de una aplicación es DISABLED o SOMEDISABLED,
intente habilitar toda la aplicación.
- En la vista Explorador de nubes, pulse el botón derecho del ratón en la versión de aplicación y seleccione Habilitar. Si la versión de la aplicación está abierta en el editor de aplicaciones en línea, utilice el botón Habilitar en la pestaña Visión general. CICSPlex SM intenta habilitar todos los paquetes de CICS para la versión de la aplicación en todas las regiones CICS.
- Compruebe el nuevo estado para ver si la versión de la aplicación está habilitada. Si la versión de la aplicación no está habilitada, investigue los paquetes de CICS individuales que se nombran en cada componente de gestión. En la vista Explorador de nubes,
utilice la lista desplegable de cambio de jerarquía
para cambiar a la jerarquía de la aplicación. En la jerarquía de la aplicación,
expanda cada tipo de región que se visualiza en la aplicación para mostrar la
lista Paquetes para el tipo de región. Expanda cada lista Paquetes para visualizar los componentes de gestión para la aplicación.
- Si el estado de un componente de gestión es DISABLED o SOMEDISABLED, intente habilitar los paquetes
individuales de CICS en cada región CICS donde están instalados.
- Efectúe una doble pulsación en el componente de gestión para abrir la vista Paquetes de CICS, que muestra los paquetes de CICS instalados.
De forma alternativa, pulse el botón derecho del ratón en el componente de gestión y pulse Mostrar paquetes instalados.
- En la vista Paquetes de CICS, seleccione el registro para el paquete de CICS en la región CICS donde desea habilitarlo, pulse con el botón derecho del ratón y seleccione Habilitar.
- Si el paquete de CICS permanece inhabilitado, revise su definición para ver si tiene una dependencia en una importación para un recurso que no está presente en la región CICS.
Consejo: Si un paquete de CICS que contiene la definición de un recurso LIBRARY privado para una aplicación está inhabilitado, CICS no intenta cargar los módulos de programa desde ninguna otra concatenación de
LIBRARY privada para la aplicación ni desde ninguna concatenación de LIBRARY púbico en el orden de búsqueda global.
En su lugar, se devuelve la respuesta "no encontrado" a la tarea. Esta acción impide la posibilidad de cargar un programa equivocado y permite que la gestión de cargas de trabajo direccionen el trabajo desde la región CICS. Todos los paquetes de CICS que contengan definiciones para recursos LIBRARY deben, por tanto, estar habilitados para poder llevar a cabo cargas de programa para la aplicación.
- Si el estado de una versión de aplicación es INCOMPLETE o EMPTY, investigue los paquetes de CICS individuales que se nombran en cada componente de gestión:
- En la vista Explorador de nubes,
utilice la lista desplegable de cambio de jerarquía
para cambiar a la jerarquía de la aplicación. En la jerarquía de la aplicación,
expanda cada tipo de región que se visualiza en la aplicación para mostrar la
lista Paquetes para el tipo de región. Expanda cada lista Paquetes para visualizar los componentes de gestión para la aplicación. Para trabajar con los paquetes de CICS instalados, efectúe una doble pulsación en el componente de gestión para abrir la vista Paquetes de CICS. De forma alternativa, pulse el botón derecho del ratón en el componente de gestión y pulse Mostrar paquetes instalados.
- Si el estado de un componente de gestión es INVALIDSCOPE, compruebe la definición para el paquete de CICS para ver si el grupo de sistema
CICS de destino se ha especificado correctamente.
- Si el estado de un componente de gestión es EMPTY, compruebe si las regiones CICS donde debería haberse instalado el paquete de
CICS están activas y conectadas a CMAS. Para comprobar si las regiones CICS
están activas, utilice la lista desplegable del cambio de jerarquía
para cambiar
a la jerarquía de la plataforma en la vista Explorador de nubes. Para ver la plataforma donde está instalada la aplicación, expanda los tipos de región, después expanda la lista Regiones para cada tipo de región para mostrar las regiones CICS y sus estados. Si las regiones CICS están disponibles, compruebe la
definición del paquete de CICS para ver si hay errores.
- Si el estado de un componente de gestión es INCOMPLETE, compruebe el registro de
CICSMSG de las regiones CICS en el tipo de región del paquete afectado si desea más información sobre los motivos por los cuales no se instaló el paquete. Si el paquete de CICS no se puede encontrar, compruebe la configuración de zFS.
- Este error se puede producir cuando una plataforma se dispersa a través de distintos sistemas (LPAR) en el mismo sysplex, pero el directorio de inicio de plataforma en el sistema de archivos de zFS no se comparte a través del sysplex. Debe utilizar el FTP utilizando una conexión con el mismo zFS en el que se ejecuta CMAS, o configurar un uso compartido de nivel sysplex del directorio de inicio de la plataforma.
- Este error también se puede producir si el directorio de inicio de la plataforma está en un sysplex diferente del sysplex donde está instalada la plataforma.
Asegúrese de que el directorio de inicio de la plataforma está en el sysplex donde ha instalado la plataforma.
- Si experimenta un problema con un recurso privado que se ha instalado en una región CICS para una versión de aplicación, investigue los recursos privados individuales.
- En la vista Explorador de nubes, efectúe una doble pulsación en el nombre de la versión de aplicación instalada para abrirlo en el editor de aplicaciones en línea y seleccione la pestaña Recursos privados. Para filtrar los recursos privados según la región CICS donde se hayan instalado, seleccione la jerarquía de regiones en el panel Estructura. De forma alternativa, para filtrar los recursos privados según el paquete de CICS donde están definidos, seleccione la jerarquía de paquetes en el panel Estructura.
- Seleccione la pestaña adecuada para el tipo de recurso con el fin de ver los recursos privados instalados para la aplicación. Compruebe que cada recurso privada esperado exista en todas las regiones CICS correspondiente y compruebe la información de estado y la información detallada para el recurso privado por si hubiera anomalías. Para trabajar con un recurso privado, efectúe una doble pulsación en el nombre del recurso para abrirlo en un editor.
- Si la aplicación tiene recursos LIBRARY privados, seleccione la pestaña Nombres DS de bibliotecas para ver el nombre de DD que ha generado z/OS para cada concatenación de LIBRARY de los conjuntos de datos. Compruebe que estos conjuntos de datos se hayan creado correctamente.
- Si realiza la acción Hacer disponible para que una versión de aplicación esté disponible para los interlocutores, pero el estado de disponibilidad no se visualiza como AVAILABLE (disponible), compruebe primero que la acción era necesaria.
- Si el estado de disponibilidad de la versión de la aplicación no aparece en absoluto, es correcto para las regiones CICS que todavía se hallan en la versión 5.1. de CICS TS. La acción Hacer disponible no se aplica a las aplicaciones de estas regiones y estarán disponibles para los interlocutores tan pronto como se hallen en estado ENABLED (habilitado).
- Si el estado de disponibilidad de la versión de la aplicación se visualiza como "Sin puntos de entrada" (que es el estado NONE), la aplicación no tiene puntos de entrada de aplicación, por lo que la acción Hacer disponible no es necesaria. Los puntos de entrada de aplicación se utilizan para controlar el acceso de usuarios a las versiones de aplicaciones en un entorno de varias versiones, por lo que debería declarar puntos de entrada de aplicación para recursos PROGRAM o URIMAP en la aplicación.
- Si realiza la acción Hacer disponible para que una versión de aplicación esté disponible para los interlocutores, y la acción era necesaria, pero el estado de disponibilidad de la versión de la aplicación permanece como UNAVAILABLE o SOMEAVAIL durante un período prolongado, investigue los componentes de gestión individuales de la versión de la aplicación. En la vista Explorador de nubes, que trabaja con la jerarquía de
aplicaciones, expanda cada tipo de región que se visualiza en la aplicación para mostrar la lista Paquetes
para el tipo de región.
Expanda cada lista Paquetes para visualizar los componentes de gestión para la aplicación.
- Si el estado de disponibilidad de un componente de gestión se muestra como se visualiza como "Sin puntos de entrada" (que es el estado NONE), el paquete de CICS no contiene ninguna declaración de puntos de entrada de aplicación, por lo que no es necesario investigarlo.
- Si el estado de disponibilidad de un componente de gestión se visualiza como AVAILABLE, los puntos de entrada de la aplicación declarados en el paquete de CICS están disponibles correctamente para los interlocutores, por lo que no es necesario investigarlo.
- Si el estado de disponibilidad de un componente de gestión se visualiza como UNAVAILABLE o SOMEAVAIL, compruebe el estado del paquete de CICS individual y las partes del paquete, que representan los recursos instalados para un paquete de CICS. Para trabajar con los paquetes de CICS instalados, efectúe una doble pulsación en el componente de gestión para abrir la vista Paquetes de CICS. De forma alternativa, pulse el botón derecho del ratón en el componente de gestión y pulse Mostrar paquetes instalados. Para ver los recursos individuales de partes de paquetes que se instalaron para el paquete de CICS, pulse el botón derecho del ratón el nombre de paquete de CICS en la vista Paquetes y pulse Mostrar partes del paquete. Compruebe si se da alguna de estas situaciones:
- De ha declarado un punto de entrada de aplicación en el paquete de CICS con un nombre de operación que duplica un nombre de operación utilizado en otro lugar de la aplicación. Para evitar esta situación, asegúrese de que los nombres de las operaciones sean exclusivos de una aplicación. Los nombres de operaciones distinguen entre mayúsculas y minúsculas, por lo que puede utilizar nombres de operaciones que sólo se diferencien en el uso de mayúsculas y minúsculas, como "examinar" y "EXAMINAR".
- Un recurso URIMAP que se ha declarado en el paquete de CICS como punto de entrada de la aplicación no existe o ya está reservado como punto de entrada de la aplicación para una aplicación diferente. Para evitar estas situaciones, defina el recurso URIMAP con un nombre exclusivo en el entorno.
- Un programa que se ha declarado en el paquete de CICS como punto de entrada de la aplicación es un programa privado definido en uno de los paquetes de CICS desplegados con la versión de la aplicación. Sin embargo, ya se ha instalado un programa con ese nombre como programa público en la región CICS. Los programas declarados como punto de entrada de aplicación tienen que tener un nombre del recurso PROGRAM exclusivo en el entorno.
Para evitar esta situación, cambie el nombre del programa privado en la definición de recursos y en la declaración de punto de entrada de la aplicación para que el nombre sea único. Es posible instalar varias versiones del mismo recursos PROGRAM privado definido como punto de entrada de la aplicación para varias versiones de la misma aplicación, porque CICS gestiona la promoción de los recursos PROGRAM privados al estado público para las versiones de una aplicación.
- No se ha definido ninguna versión anterior de la aplicación declarada como punto de entrada de aplicación en uno de los paquetes de
CICS desplegados con la versión de la aplicación y ya se ha instalado como programa público. Cuando se habilitó la versión de la aplicación, CICS reservó el programa público instalado como punto de entrada de la aplicación. Sin embargo, ahora
CICS no puede gestionar automáticamente los puntos de entrada de la aplicación para versiones nuevas de la aplicación porque un programa público que se ha instalado antes de que la aplicación no puede pasar a ser un programa privado. Para actualizar la aplicación a una versión nueva, tendrá que inhabilitar y descartar la versión existente. Para evitar esta situación, puede disponer que el programa público se instala automáticamente mediante el proceso de instalación de la aplicación, en cuyo caso puede convertirse en un programa privado y permitir que se instales futuras versiones de la aplicación al mismo tiempo. También puede definir el programa en uno de los paquetes CICS desplegados con la versión de la aplicación, garantizando que tiene un nombre exclusivo, lo que lo convierte en un programa privado.
- Si no puede inhabilitar una versión de aplicación, compruebe que la acción Hacer no disponible se haya llevado a cabo para la versión de la aplicación allí donde sea necesario.
- En las regiones CICS desde la versión 5.2 de
CICS TS, si aparece el estado de disponibilidad de la versión de aplicación como
AVAILABLE, debe llevar a cabo la acción Hacer no disponible para que la versión de la aplicación no esté disponible para los interlocutores antes de inhabilitarla.
- Si la plataforma incluye regiones CICS que todavía se hallan en la versión 5.1 de CICS TS, la acción Hacer no disponible no se aplica a las aplicaciones de esas regiones. El estado de disponibilidad no se visualizará.
- Si alguna aplicación no tiene puntos de entrada de aplicación, la acción Hacer no disponible no será necesaria para esas aplicaciones. Su estado de disponibilidad se visualizará como "Sin puntos de entrada".
- Si la aplicación ha quedado no disponible donde es necesario que lo esté, y ha llevado a cabo la acción
Inhabilitar, pero la versión de la aplicación permanece en estado DISABLING, investigue los paquetes de
CICS individuales que se indican en cada componente de gestión.
- En la vista Explorador de nubes, que trabaja con la jerarquía de
aplicaciones, expanda cada tipo de región que se visualiza en la aplicación para mostrar la lista Paquetes
para el tipo de región.
Expanda cada lista Paquetes para visualizar los componentes de gestión para la aplicación. Para trabajar con los paquetes de CICS instalados, efectúe una doble pulsación en el componente de gestión para abrir la vista Paquetes de CICS. De forma alternativa, pulse el botón derecho del ratón en el componente de gestión y pulse Mostrar paquetes instalados.
- En la vista Paquetes de CICS, localice cualquier paquete de CICS que todavía no esté inhabilitado. Seleccione el registro del paquete de CICS en la región CICS donde todavía no se haya inhabilitado, pulse el botón derecho del ratón y seleccione Inhabilitar.
- Si el paquete de CICS todavía no está inhabilitado, consulte sus partes de paquete en la vista Partes de paquete para identificar y compruebe el estado de los recursos individuales que se instalaron para el paquete de CICS. Para ver las paquetes del paquete, pulse el botón derecho del ratón el nombre del paquete de CICS en la vista Paquetes y pulse Mostrar partes del paquete.
- Compruebe el estado de cualquier recurso LIBRARY o PROGRAM que se haya definido en el paquete de CICS. El recurso BUNDLEPART asociado a un recurso LIBRARY no informa del estado DISABLED hasta que la concatenación de LIBRARY del programa dinámico y todos los programas cargados desde la misma tengan un recuento de utilizaciones de cero. Para un recurso PROGRAM, aunque CICS inhabilita el programa cuando se lleva a cabo la operación de inhabilitación en el paquete de
CICS desde el que se instaló, el recurso
BUNDLEPART asociado permanece habilitado hasta que el recuento de utilizaciones del programa llegue a cero. Si el recuento de utilizaciones no llega a cero tras un intervalo de tiempo aceptable, puede que tenga que depurar el trabajo desde CICS para que pueda llevarse a cabo el proceso de inhabilitación del paquete.
- Compruebe el estado de cualquier recurso JVMSERVER o TCPIPSERVICE que se haya definido en el paquete de CICS. De forma predeterminada, estos recursos no se inhabilitan hasta que las tareas actuales han terminado de utilizarlos.
- Para un recurso JVMSERVER, si desea inhabilitar el servidor de JVM de forma inmediata y depurar las tareas que se están ejecutando en el mismo, utilice el mandato SET JVMSERVER PURGE, FORCEPURGE o KILL en el recurso generado dinámicamente en la región CICS.
Puede llevar a cabo esta acción en CICS Explorer.
- Para un recurso TCPIPSERVICE, si desea inhabilitar el servicio de inmediato y cerrar todas las conexiones, utilice el mandato
SET TCPIPSERVICE IMMCLOSE en el recurso generado dinámicamente en la región CICS. Puede llevar a cabo esta acción en CICS Explorer.
No puede utilizar estos métodos para inhabilitar el recurso a menos que ya haya realizado la acción
Inhabilitar en el paquete de CICS.
- Compruebe el estado de cualquier recurso FILE que se haya definido en el paquete de CICS, y compruebe también el registro de mensajes de CICS del mensaje DFHFC6043. CICS emite este mensaje cuando se ha intentado inhabilitar un archivo definido en un paquete de CICS, pero el archivo aún está en uso, o existe un bloqueo retenido en el archivo.
- Si el archivo se encuentra en el estado DISABLED y CICS ha emitido el mensaje DFHFC6043, para un archivo recuperable, compruebe y resuelva el bloqueo retenido. Para un archivo no recuperable, compruebe las tareas que estén utilizando el archivo, y depure las tareas o espere unos instantes a que se completen. Una vez completado el proceso, el paquete de CICS pasa al estado DISABLED.
- Si el archivo se encuentra en el estado DISABLING, puede emitir uno de los mandatos siguientes para depurar las tareas que estén utilizando el archivo, e inhabilitar el archivo:
- EXEC CICS SET FILE DISABLED FORCE
- EXEC CICS SET FILE CLOSED FORCE
- CEMT SET FILE FORCECLOSE
Una vez depuradas las tareas, el paquete de CICS pasa al estado DISABLED. Tenga en cuenta que el cierre de un archivo utilizando la opción FORCE provoca que las tareas de los usuarios actuales del archivo se detengan inmediatamente, a través del mecanismo FORCEPURGE de tarea de CICS. No se garantiza la integridad de los datos con este mecanismo. En algunos casos extremos (por ejemplo, si se produce un error durante el proceso de restitución), es posible que CICS termine de forma anómala. Por esta razón, cierre los archivos utilizando la opción FORCE solamente en circunstancias excepcionales.