Déploiement de l'application exemple CICS TS Feature Pack for Dynamic Scripting V2.0

CICS TS Feature Pack for Dynamic Scripting V2.0 fournit une application exemple que vous pouvez déployer pour vérifier que votre installation est correcte et qui vous permet de comprendre comment développer et déployer des applications PHP.

Avant de commencer

Avant de déployer l'application exemple, assurez-vous que :

Pourquoi et quand exécuter cette tâche

CICS TS Feature Pack for Dynamic Scripting V2.0 se compose de deux zones fonctionnelles : le composant CICS TS Feature Pack for Dynamic Scripting V2.0 z/OS, installé dans votre système hôte à l'aide de SMP/E, et la fonction installée dans CICS Explorer SDK qui inclut la définition de plateforme cible PHP et l'assistant d'exemple PHP. Le module de fonctions fournit une application exemple que vous pouvez déployer pour vérifier que votre installation est correcte et qui vous permet de comprendre comment développer et déployer des applications PHP. L'application exemple est déployée via CICS Explorer SDK. Le composant z/OS doit être installé et configuré pour que vous puissiez déployer l'application exemple.

Procédure

  1. Suivez les instructions fournies dans Configuration de l'environnement cible CICS TS Feature Pack for Dynamic Scripting V2.0 pour définir "CICS TS Runtime with PHP" en tant que plateforme cible dans le SDK CICS Explorer.
  2. Dans CICS Explorer SDK, cliquez sur Fichier > Nouveau > Exemple.
  3. Dans la fenêtre de sélection d'un assistant, développez Exemples CICS et PHP.
  4. Sélectionnez CICS Dynamic Scripting Example(PHP) et cliquez sur Suivant. Une deuxième fenêtre présente les projets déjà créés.
  5. Cliquez sur Terminer. Trois projets sont créés :
    • Un bundle OSGi avec prise en charge Web 3.0, nommé com.ibm.cics.server.examples.php.web. Ce bundle contient les fichiers suivants pour la gestion des demandes PHP :
      • Un activateur exemple, fourni avec CICSPHPInitialiser.getInstance().activate(context) déclaré dans la méthode start(), de sorte que ce bundle peut être enregistré dans le moteur PHP.
      • Un fichier MANIFEST.MF configuré pour ajouter la dépendance sur les fichiers JAR Servlet 3.0, JCICS et PHP.
      • Un fichier web.xml configuré pour utiliser PHPServlet pour gérer les demandes PHP.
      • Le fichier par défaut php.ini. Vous pouvez le modifier selon vos besoins.
      • Le fichier index.php et l'image exemple, qui permettent à l'API JCICS de renvoyer les informations APPLID de région à HTML.
    • Un projet d'application OSGi, nommé com.ibm.cics.server.examples.php.app, qui contient le bundle OSGi avec prise en charge Web 3.0 nommé com.ibm.cics.server.examples.php.web. Ce projet peut être exporté en tant que fichier eba pour être déployé.
    • Un projet de bundle CICS, nommé com.ibm.cics.server.examples.php.bundle, qui contient une ressource EBABUNDLE faisant référence au projet com.ibm.cics.server.examples.php.app. Ce projet est déployé dans le serveur Liberty JVM exemple DFH$PHP.
    Vous pouvez voir les bundles dans le panneau Explorateur de packages.
  6. Cliquez avec le bouton droit de la souris sur le le projet de bundle CICS nommé com.ibm.cics.server.examples.php.bundle et cliquez sur Exporter le projet de bundle vers le système de fichiers UNIX z/OS UNIX pour l'exporter vers zFS.
  7. Définissez et installez une ressource BUNDLE faisant référence au projet de bundle CICS exporté à l'étape 6. Pour plus d'informations, voir la rubrique d'aide CICS Explorer SDK Déploiement de bundles OSGi dans un serveur JVM.
  8. Accédez à l'URL http://nom_hôte:port/com.ibm.cics.server.examples.php.web, où nom_hôte et port correspondent au nom d'hôte et au port définis dans votre serveur Liberty JVM.

Résultats

Un écran s'affiche dans votre navigateur et indique le message suivant : "Your CICS Dynamic Scripting Example (PHP) is now running in CICS Region APPLID", où APPLID correspond à l'APPLID de votre région CICS. Pour plus d'informations, voir Déploiement de bundles OSGi dans un serveur JVM.