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.

Avant de commencer

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

Pourquoi et quand exécuter cette tâche

Des ressources PROGRAM 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 ê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 le même ressource.
  • Une 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. Pour les ressources PROGRAM qui sont déclarées comme points d'entrée d'application, le point d'entrée d'application contrôle l'accès des utilisateurs au programme, quel que soit l'emplacement de la ressource PROGRAM. Par contre, pour les ressources URIMAP qui sont déclarées comme points d'entrée d'application, le point d'entrée d'application ne contrôle l'accès des utilisateurs à la ressource URIMAP que s'il est déclaré dans le même bundle CICS que celui où la ressource URIMAP est définie.

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 s'installe pas et est marqué avec un avertissement.

Les bundles CICS qui sont installés dans des bundles de plateformes 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 peut donc 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. Plusieurs versions du même programme défini comme point d'entrée d'application peuvent être chargées pour plusieurs versions de la même application.

Lorsque vous définissez une ressource URIMAP dans un bundle 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. Pour cette fonction, déclarez le point d'entrée d'application et définissez la ressource URIMAP dans le même bundle CICS. Dans ce cas, lorsque vous installez et activez l'application, le service fourni par la ressource URIMAP n'est pas encore disponible pour les appelants. Lorsque vous choisissez de fournir le service à des utilisateurs, vous rendez disponibles aux utilisateurs le bundle CICS contenant le point d'entrée d'application et la ressource URIMAP à l'aide de CICS Explorer ou de la commande EXEC CICS SET BUNDLE. Cette action rend le point d'entrée d'application et donc le service fourni par la ressource URIMAP disponibles pour les appelants.

Si vous ne souhaitez pas que le point d'entrée d'application contrôle l'accès au service fourni par la ressource URIMAP, déclarez le point d'entrée d'application et définissez la ressource URIMAP dans des bundles CICS différents. Vous pouvez également déclarer comme point d'entrée d'application une ressource URIMAP qui est définie en dehors de l'application et déclarée en tant que dépendance, ou importation, pour l'application. Dans ces deux cas, le service devient disponible pour les utilisateurs dès que vous installez et activez la ressource URIMAP.

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 règles. 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 plusieurs tâches.
  • Le contexte d'application initial est utilisé pour appliquer une règle 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 rapidement identifier et diagnostiquer les problèmes liés à l'application.