Despliegue de la aplicación de ejemplo de CICS TS Feature Pack for Dynamic Scripting V2.0

CICS TS Feature Pack for Dynamic Scripting V2.0 proporciona una aplicación de ejemplo que puede desplegar para comprobar si la instalación se ha realizado correctamente y para ayudarle a saber cómo puede empezar a desarrollar y desplegar aplicaciones PHP.

Antes de empezar

Para poder desplegar la aplicación de ejemplo, deben cumplirse las condiciones siguientes:

Acerca de esta tarea

CICS TS Feature Pack for Dynamic Scripting V2.0 consta de dos áreas funcionales: el componente CICS TS Feature Pack for Dynamic Scripting V2.0 para z/OS, que se instala en el sistema host utilizando SMP/E y la función que se instala en el CICS Explorer SDK que incluye la definición de plataforma de destino PHP y el asistente de ejemplo de PHP. El paquete de características proporciona una aplicación de ejemplo que puede desplegar para verificar que la instalación es correcta y ayudarle a conocer cómo puede empezar a desarrollar y desplegar aplicaciones PHP. La aplicación de ejemplo se despliega utilizando el CICS Explorer SDK. El componente z/OS debe estar completamente instalado y configurado antes de desplegar la misma aplicación.

Procedimiento

  1. Siga las instrucciones de Configuración del entorno de destino de CICS TS Feature Pack for Dynamic Scripting V2.0 para establecer "CICS TS Runtime con PHP" como la plataforma de destino en el SDK de CICS Explorer.
  2. En el CICS Explorer SDK, pulse Archivo > Nuevo > Ejemplo.
  3. En la ventana "Seleccionar un asistente", expanda Ejemplos de CICS y PHP.
  4. Seleccione Ejemplo de CICS Dynamic Scripting (PHP) y pulse Siguiente. Se muestra una segunda ventana que muestra los proyectos que se crean.
  5. Pulse Finalizar. Se crean tres proyectos:
    • Un paquete de OSGi con soporte de Web 3.0, denominado com.ibm.cics.server.examples.php.web. Este paquete contiene los siguientes archivos para gestionar las solicitudes de PHP:
      • Se proporciona un activador con CICSPHPInitialiser.getInstance().activate(context) declarado en el método start(), de modo que este paquete se puede registrar en el motor PHP.
      • Un MANIFEST.MF configurado para añadir la dependencia en el jar de Servlet 3.0, el jar de JCICS y el jar de PHP.
      • Un web.xml configurado para utilizar PHPServlet para gestionar las solicitudes PHP.
      • El php.ini predeterminado. Puede actualizarlo según sus requisitos.
      • El index.php de ejemplo y la imagen, que permiten que la API de JCICS repita la información de APPLID de región en HTML.
    • Un proyecto de aplicación OSGi, denominado com.ibm.cics.server.examples.php.app, que contiene el paquete de OSGi con soporte de Web 3.0 denominado com.ibm.cics.server.examples.php.web. Este proyecto se puede exportar como un archivo eba para desplegarlo.
    • Un proyecto de paquete de CICS, denominado com.ibm.cics.server.examples.php.bundle, que contiene un recurso EBABUNDLE, que hace referencia a com.ibm.cics.server.examples.php.app project. Este proyecto se despliega en el servidor de JVM de Liberty de ejemplo DFH$PHP.
    Puede ver los paquetes en el panel Explorador de paquetes.
  6. Pulse con el botón derecho del ratón en el proyecto de paquete de CICS denominado com.ibm.cics.server.examples.php.bundle y pulse Exportar proyecto de paquete a sistema de archivos UNIX de z/OS para exportarlo a zFS.
  7. Defina e instale un recurso BUNDLE que haga referencia al proyecto de paquete de CICS que se exporta en el paso 6. Para obtener más detalles, consulte el tema de ayuda Despliegue de paquetes de OSGi en un servidor de JVM del CICS Explorer SDK.
  8. Vaya al URL http://nombre_host:puerto/com.ibm.cics.server.examples.php.web, donde nombre_host y puerto son el nombre de host y el puerto definidos en el servidor de JVM de Liberty.

Resultados

Se muestra una pantalla en el navegador, que contiene el texto "El ejemplo de CICS Dynamic Scripting (PHP) ahora se ejecuta en la región CICS APPLID", donde APPLID es el APPLID de la región de CICS. Para obtener más información, consulte Despliegue de paquetes de OSGi en un servidor de JVM.