Définition de points d'entrée d'application

Si votre projet de bundle CICS fait partie d'une application CICS, déclarez des points d'entrée d'application appropriés dans le manifeste de bundle. Un point d'entrée d'application identifie une ressource représentant un point d'accès à une application. Les points d'entrée d'application sont utilisés pour contrôler l'accès des utilisateurs à différentes versions d'une application déployée sur une plateforme. Les points d'entrée d'application peuvent également être définis dans des bundles qui sont déployés dans des régions CICS autonomes. Dans ce cas, si des points d'entrée d'application sont définis conjointement avec une portée de règle, ils peuvent être utilisés pour restreindre la portée d'une politique qui définit des règles de tâche à des tâches utilisateur spécifiques.

Avant de commencer

La vue Explorateur de projet doit contenir un projet de bundle CICS.

Pourquoi et quand exécuter cette tâche

Les ressources PROGRAM, TRANSACTION et URIMAP peuvent être identifiées comme des points d'entrée d'application.

Pour les applications déployées sur une plateforme, les points d'entrée d'application contrôlent l'accès des utilisateurs aux différentes versions de l'application. Des points d'entrée d'application peuvent être définis comme étant disponibles ou indisponibles pour des utilisateurs. Vous pouvez installer l'application et ses ressources dans les régions CICS dans la plateforme au moment qui vous convient, puis activer les bundles CICS pour vérifier l'installation. Lorsque vous choisissez de fournir la version de l'application à des utilisateurs, vous rendez disponibles pour des appelants les points d'entrée d'application et donc les ressources que ceux-ci contrôlent pour l'application.

Chaque point d'entrée d'application est déclaré sur une ressource et indique également une opération. Par exemple, vous pouvez déclarer des points d'entrée d'application pour des opérations de création, de lecture, de mise à jour ou de suppression dans l'application.
  • Une ressource pour une application ne peut être déclarée qu'une fois comme point d'entrée d'application, indiquant une seule opération. Vous ne pouvez pas déclarer plusieurs points d'entrée d'application sur la même ressource.
  • Un nom d'opération doit être unique dans une application.
  • Les noms d'opération sont sensibles à la casse. Vous pouvez donc utiliser des noms d'opération différenciés uniquement par leur casse.

La ressource d'un point d'entrée d'application n'a pas besoin d'être définie dans le même bundle CICS que le point d'entrée d'application. CICS ajoute l'opération d'application à la ressource spécifiée lorsque l'application est installée. Lorsqu'une ressource de point d'entrée d'application et le point d'entrée sont tous deux définis en tant que composants de l'application, le point d'entrée contrôle l'accès au service fourni par la ressource. Par exemple, une TRANSACTION définie comme point d'entrée d'application ne peut pas être appelée tant que l'application n'a pas été rendue disponible.

Vous pouvez déclarer un point d'entrée d'application pour une ressource qui n'est définie dans aucun bundle CICS, mais qui existe déjà dans les régions CICS dans lesquelles le bundle sera déployé. Vous pouvez également déclarer un point d'entrée d'application pour une ressource PROGRAM qui peut être installée automatiquement dans les régions CICS dans lesquelles le bundle sera déployé. Lorsque vous installez une application, si la ressource ciblée par un point d'entrée d'application n'est pas présente et ne peut pas être installée automatiquement, le bundle CICS contenant la déclaration du point d'entrée d'application ne peut pas être activé et le composant du bundle de point d'entrée reste désactivé.

Les bundles CICS qui sont installés dans des bundles de plateforme ou ajoutés à une plateforme en cours d'exécution ne doivent pas contenir de déclarations de points d'entrée d'application dans le manifeste de bundle. Les points d'entrée d'application ne sont pas pris en charge pour des bundles CICS installés directement sur des plateformes et CICS n'active pas les points d'entrée d'application dans cette situation, même si le bundle CICS et ses ressources sont installés. Les bundles CICS installés directement dans des régions CICS peuvent contenir des déclarations de points d'entrée d'application pour activer la configuration de politiques au niveau des régions.

Les points d'entrée d'application contrôlent uniquement l'accès des utilisateurs aux ressources qui sont spécifiées dans ces points d'entrée d'application. Si une application inclut des ressources publiques qui ne sont pas nommées comme des points d'entrée d'application, lorsque l'application est installée et activée, ces ressources sont accessibles pour les autres applications installées sur la plateforme ou dans la région CICS, quel que soit l'état de disponibilité de l'application. Les ressources privées d'une version d'application ne sont pas accessibles pour les autres applications.

Les programmes définis en tant que point d'entrée d'application doivent disposer d'un nom de ressource PROGRAM unique dans votre environnement. Pour permettre à ces programmes d'être appelés en dehors de l'application, ceux-ci doivent être des ressources publiques. Lorsque vous activez une application qui contient un point d'entrée d'application pour une ressource PROGRAM privée, la ressource PROGRAM qui est nommée comme point d'entrée d'application devient une ressource publique. La ressource PROGRAM ne peut donc pas avoir le même nom qu'un programme public installé dans la région CICS ou le même nom qu'un programme public défini comme point d'entrée d'application par une autre application installée. Toutefois, il est possible d'installer plusieurs versions de la même ressource PROGRAM définie comme point d'entrée d'application pour plusieurs versions de la même application.

Lorsque vous définissez une ressource URIMAP ou TRANSACTION dans un bundle d'applications CICS, vous pouvez utiliser une déclaration de point d'entrée d'application pour contrôler l'accès des utilisateurs au service fourni par la ressource URIMAP ou TRANSACTION. Dans ce cas, lorsque vous installez et activez l'application, le service fourni par la ressource URIMAP ou TRANSACTION n'est pas encore disponible pour les appelants. Lorsque vous choisissez de fournir le service à des utilisateurs, vous mettez à disposition le bundle CICS contenant le point d'entrée d'application et la ressource URIMAP ou TRANSACTION en utilisant la vue Bundles dans CICS Explorer ou la commande EXEC CICS SET BUNDLE. Cette action rend le point d'entrée d'application et par conséquent le service fourni par la ressource URIMAP ou TRANSACTION disponibles pour les appelants.

Vous pouvez également déclarer comme point d'entrée d'application une ressource URIMAP ou TRANSACTION définie en dehors de l'application. Dans ce cas, le service devient disponible pour les utilisateurs dès que vous installez et activez la ressource URIMAP ou TRANSACTION.

Procédure

  1. Développez le projet de bundle CICS et le dossier META-INF.
  2. Ouvrez le fichier cics.xml pour afficher l'éditeur de manifeste de bundle CICS.
  3. Cliquez sur l'onglet Points d'entrée pour ouvrir la liste des points d'entrée d'application pour le bundle.
  4. Cliquez sur Ajouter pour définir un point d'entrée d'application pour l'application. La boîte de dialogue Créer un point d'entrée d'application s'affiche.
    1. Entrez le nom de l'opération d'application. Le nom d'opération est sensible à la casse. Il peut inclure les caractères a-z, A-Z, 0-9._#@- et a une longueur maximale de 64 caractères. Veillez à ce que le nom d'opération soit unique dans votre application. Si une application contient des noms d'opération en double, elle ne peut pas être rendue disponible.
    2. Sélectionnez le type de ressource.
    3. Entrez le nom de la ressource CICS.
  5. Cliquez sur OK pour enregistrer le pont d'entrée d'application.

Résultats

Outre le contrôle de l'accès des utilisateurs aux différentes versions d'une application, les points d'entrée d'application sont utilisés pour créer un contexte d'application pour les tâches. Une fois l'application déployée, le nom de l'opération est ajouté à la ressource spécifiée et des données de contexte d'application sont produites pour les tâches utilisant la ressource.

Lorsqu'une tâche appelle une ressource ayant un point d'entrée d'application, CICS crée un contexte d'application qui devient le contexte d'application initial associé à la tâche, ainsi qu'à tous les programmes suivants qu'il appelle et à toutes les tâches qu'il démarre. Le contexte d'application identifie la plateforme, l'application, la version de l'application et l'opération. Si une tâche dispose déjà d'un contexte d'application, celui-ci devient le contexte d'application en cours, même si le contexte d'application de la tâche appelante peut être utilisé pour la surveillance et la configuration de politiques. Vous pouvez utiliser les données du contexte d'application aux fins suivantes :
  • Le contexte d'application initial est utilisé pour surveiller et mesurer le nombre de ressources qu'une application ou une opération d'application spécifique utilise dans les régions CICS et dans plusieurs tâches.
  • Le contexte d'application initial est utilisé pour appliquer une politique aux tâches faisant partie d'une application afin de définir des conditions de seuil pour gérer le comportement des tâches.
  • Le contexte d'application initial ou en cours peut être utilisé avec la fonction de suivi des transactions de CICS Explorer pour identifier et diagnostiquer les problèmes liés à l'application.