Definición de puntos de entrada de aplicación

Si su paquete de CICS forma parte de una aplicación de CICS, declare los puntos de entrada de la aplicación adecuados en el manifiesto de paquete. Un punto de entrada de aplicación identifica un recurso en un punto de acceso a una aplicación. Los puntos de entrada de aplicación se utilizan para controlar el acceso de los usuarios a diferentes versiones de una aplicación que se despliega en una plataforma. También se pueden definir puntos de entrada de aplicación en paquetes desplegados en regiones CICS autónomas. En este caso, si los puntos de entrada de aplicación se definen junto con un ámbito de política, se pueden utilizar para restringir el ámbito de una política que defina reglas de tarea para tareas de usuario específicas.

Antes de empezar

Debe tener un proyecto de paquete de CICS en la vista Explorador de proyecto.

Acerca de esta tarea

Los recursos PROGRAM, TRANSACTION y URIMAP se pueden identificar como puntos de entrada de aplicación.

Para las aplicaciones que se despliegan en plataforma, los puntos de entrada de aplicación controlan el acceso de los usuarios a diferentes versiones de la aplicación. Los puntos de entrada de aplicación pueden definirse como disponibles o no disponibles para los usuarios. Puede instalar la aplicación y sus recursos en las regiones CICS de la plataforma en cualquier momento, y habilitar los paquetes CICS para verificar la instalación. Cuando decide proporcionar la versión de la aplicación a los usuarios, hace que los puntos de entrada de aplicación y, por lo tanto, los recursos que controlan de la aplicación, estén disponibles para los interlocutores.

Cada punto de entrada de aplicación se declara en un recurso y también nombra una operación. Por ejemplo, puede declarar puntos de entrada de aplicación para crear, leer, actualizar o eliminar operaciones de la aplicación.
  • Un recurso de una aplicación solo puede declararse una vez como punto de entrada de aplicación, denominando una operación. No puede declarar múltiples puntos de entrada de aplicación en el mismo recurso.
  • Un nombre de operación debe ser exclusivo en una aplicación.
  • Los nombres de operaciones distinguen entre mayúsculas y minúsculas, así que puede utilizar nombres de operaciones que se diferencien solo en este aspecto.

El recurso de un punto de entrada de aplicación no tiene que definirse en el mismo paquete CICS que el punto de entrada de aplicación. CICS añade la operación de aplicación al recurso especificado cuando se instala la aplicación. Cuando se definen un recurso para un punto de entrada de aplicación y el punto de entrada como parte de una aplicación, el punto de entrada controla el acceso al servicio que proporciona el recurso. Por ejemplo, si de define TRANSACTION como un punto de entrada de aplicación no se puede invocar hasta que la aplicación está disponible.

Puede declarar un punto de entrada de aplicación para un recurso que no esté definido en ningún paquete de CICS pero que ya exista en las regiones CICS donde se desplegará el paquete. También puede declarar un punto de entrada de aplicación para un recurso PROGRAM que se puede instalar de forma automática en las regiones CICS donde se va a desplegar el paquete. Cuando instala una aplicación, si el recurso de destino de un punto de entrada de aplicación no está presente y no se puede instalar automáticamente, el paquete CICS que contiene la declaración del punto de entrada de aplicación no se puede habilitar y la parte del paquete del punto de entrada permanece inhabilitado.

Los paquetes de CICS que se instalan como parte de los paquetes de plataforma o que se añaden en una plataforma en ejecución no deben contener declaraciones de puntos de entrada de aplicación en el manifiesto de paquete. Los puntos de entrada de aplicación no reciben soporte para los paquetes de CICS instalados directamente en plataformas y CICS no habilita los puntos de entrada de aplicación en esta situación, aunque se haya instalado el paquete de CICS y los recursos. Los paquetes de CICS autónomos que se instalan directamente en regiones CICS pueden contener declaraciones de puntos de entrada de aplicación para habilitar el ámbito de las políticas de nivel de región.

Los puntos de entrada de aplicación controlan el acceso de los usuarios a los recursos especificados en los puntos de entrada de aplicación. Si una aplicación incluye algún recurso público que no se ha designado como punto de entrada de aplicación, cuando se instala y habilita la aplicación, se puede acceder a estos recursos mediante otras aplicaciones instaladas en la plataforma o en la región CICS independientemente del estado de disponibilidad de la aplicación. No se puede acceder a los recursos privados de una versión de la aplicación mediante otras aplicaciones.

Los programas que se definen como punto de entrada de aplicación tienen que tener un nombre del recurso PROGRAM exclusivo en el entorno. Estos programas tienen que ser recursos públicos para poder ser llamados desde fuera de la aplicación. Cuando se habilita una aplicación que contiene un punto de entrada de aplicación para un recurso PROGRAM privado, el recurso PROGRAM que se denomina como punto de entrada de aplicación cambia de un recurso privado a un recurso público. Por lo tanto, el recurso PROGRAM no puede tener el mismo nombre que un programa público que esté instalado en la región CICS, o que un programa público que otra aplicación instalada haya definido como punto de entrada de aplicación. Sin embargo, se pueden instalar varias versiones del mismo recurso PROGRAM definido como punto de entrada de aplicación para varias versiones de la misma aplicación.

Cuando define un recurso URIMAP o TRANSACTION en un paquete de aplicación CICS, puede utilizar una declaración de punto de entrada de aplicación para controlar el acceso de usuarios al servicio que proporciona el recurso URIMAP o TRANSACTION. En esta situación, si instala y habilita la aplicación, el servicio que ofrece el recurso URIMAP aún no estará disponible para los interlocutores. Cuando opta por proporcionar el servicio a los usuarios, puede hacer que el paquete de CICS que contiene el punto de entrada de aplicación y el recurso URIMAP o TRANSACTION estén disponibles utilizando la vista Paquetes en CICS Explorer o el mandato EXEC CICS SET BUNDLE. Esta acción hace que esté disponible el punto de entrada de la aplicación, y por lo tanto el servicio ofrecido por el recurso URIMAP o TRANSACTION, para los interlocutores.

También puede declarar como punto de entrada de aplicación un recurso URIMAP o TRANSACTION definido fuera de la aplicación y definido como dependencia, o importación, de la aplicación. En esta situación, el servicio pasa a estar disponible para los usuarios en cuanto se instala y habilita el recurso URIMAP.

Procedimiento

  1. Expanda el proyecto de paquete de CICS y la carpeta META-INF.
  2. Abra el archivo cics.xml para ver el editor de manifiesto de paquete de CICS.
  3. Pulse la pestaña de Puntos de entrada para abrir la lista de puntos de entrada de aplicación del paquete.
  4. Pulse Añadir para definir un punto de entrada de aplicación para la aplicación. Se visualiza el diálogo Crear punto de entrada de aplicación.
    1. Especifique el nombre de la operación de la aplicación. El nombre de la operación es sensible a mayúsculas y minúsculas. Puede contener los caracteres de la a a la z, de la A a la Z, del 0 al 9, ._#@-y tiene una longitud máxima de 64 caracteres. Asegúrese de que el nombre de la operación sea exclusivo en la aplicación. Si una aplicación contiene nombres de operación duplicados, no se puede convertir en disponible.
    2. Seleccione el tipo de recurso.
    3. Especifique el nombre del recurso de CICS.
  5. Pulse Aceptar para guardar el punto de entrada de aplicación.

Resultados

Así como el control de acceso de usuarios a las distintas versiones de una aplicación, los puntos de entrada de aplicación se utilizan para crear un contexto de aplicación para las tareas. Cuando la aplicación se despliega, el nombre de operación se añade al recurso especificado y se generan datos de contexto de aplicación para tareas que utilizan el recurso.

Cuando una tarea llama a un recurso que no tiene punto de entrada de aplicación, CICS crea un contexto de aplicación que se convierte en el contexto de aplicación inicial que se asociado a la tarea, y a los programas posteriores que a los que llama así como a las tareas que inicia. El contexto de aplicación identifica la plataforma, aplicación, versión de la aplicación y operación. Si una tarea ya tiene un contexto de aplicación, se convierte en el contexto de aplicación actual aunque el contexto de aplicación de la tarea de invocación se pueda utilizar para supervisar y acotar el ámbito de políticas. Puede utilizar los datos de contexto de la aplicación para los fines siguientes:
  • Se utiliza el contexto de aplicación inicial para supervisar y calcular la cantidad de recursos que utiliza una aplicación o una operación específica en las regiones CICS y en varias tareas.
  • El contexto de aplicación inicial se utiliza para aplicar una política a las tareas que forman parte de una aplicación para definir condiciones de umbral para gestionar el comportamiento de las tareas.
  • El contexto de aplicación actual o inicial se puede utilizar con la función de rastreo de transacciones en CICS Explorer para identificar y diagnosticar rápidamente problemas relacionados con la aplicación.