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.

Antes de empezar

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

Acerca de esta tarea

Los recursos PROGRAM 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 tiene que ser exclusivo dentro de la 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. En el caso de recursos PROGRAM declarados como puntos de entrada de aplicación, el punto de entrada de aplicación controla el acceso de los usuarios al programa independientemente de la ubicación del recurso PROGRAM. Sin embargo, en el caso de los recursos URIMAP declarados como puntos de entrada de aplicación, el punto de entrada de aplicación solo controla el acceso al recurso URIMAP si se ha declarado en el mismo paquete CICS en el que se ha definido el recurso URIMAP.

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 se 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 de forma automática, el paquete de CICS que contiene la declaración de punto de entrada de aplicación no se instala y se marca con un aviso.

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 puede tener el mismo nombre que un programa público que esté instalado en la región CICS o el mismo nombre que un programa público que otra aplicación instalada define como punto de entrada de aplicación. Es posible cargar varias versiones del mismo programa que está definido como punto de entrada de aplicación para varias versiones de la misma aplicación.

Cuando define un recurso URIMAP en un paquete CICS, puede utilizar una declaración de punto de entrada de aplicación para controlar el acceso de los usuarios al servicio ofrecido por el recurso URIMAP. Para esta función, declare el punto de entrada de aplicación y defina el recurso URIMAP en el mismo paquete CICS. En este caso, al instalar y habilitar la aplicación, el servicio ofrecido por el recurso URIMAP aún no estará disponible para los interlocutores. Cuando opta por proporcionar el servicio a los usuarios, hace que el paquete de CICS que contiene el punto de entrada de aplicación y el recurso URIMAP estén disponibles utilizando 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, para los interlocutores.

Si no quiere que el punto de entrada de la aplicación controle el acceso al servicio ofrecido por el recurso URIMAP, declare el punto de entrada de la aplicación y defina el recurso URIMAP en paquetes CICS distintos. También puede declarar como punto de entrada de aplicación un recurso URIMAP definido fuera de la aplicación y definido como dependencia, o importación, de la aplicación. En cualquier caso, el servicio para a estar disponible para los usuarios tan pronto como instale y habilite 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 único 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 cuántos recursos está utilizando una aplicación u operación particular de una aplicación en las regiones CICS y diversas tareas.
  • El contexto de aplicación inicial se utiliza para aplicar una política a tareas que forman parte de una aplicación para definir condiciones de límite para gestionar el comportamiento de las tareas.
  • El contexto de aplicación actual o inicial puede utilizarse con la capacidad de rastreo de la aplicación en CICS Explorer para identificar y diagnosticar rápidamente los problemas relacionados con la aplicación.