Creación de un proyecto de plug-in

Puede crear su aplicación Java™ de CICS como un proyecto de plug-in de Eclipse que cumpla la especificación OSGi. La plataforma de servicio de OSGi proporciona un mecanismo para desarrollar aplicaciones utilizando un modelo de componente y desplegar esas aplicaciones en una infraestructura en forma de paquetes de OSGi. El proyecto de plug-in es un paquete de OSGi y contiene todos los archivos y artefactos necesarios para la aplicación Java de CICS, incluida la biblioteca de clases JCICS para acceder a recursos de CICS e interactuar con programas grabados en otros lenguajes. La aplicación completada se añade entonces a un proyecto de paquete de CICS antes de exportarla al sistema host.

Acerca de esta tarea

Con esta tarea se crea un nuevo proyecto de plug-in. Puede dejar los valores predeterminados a menos que se indique lo contrario. Al crear el proyecto, puede editar el manifiesto y añadir las dependencias de API JCICS.

Procedimiento

  1. En la barra de menús de Eclipse, pulse Archivo > Nuevo > Proyecto para abrir el asistente de nuevo proyecto.
  2. Seleccione Proyecto de plug-in en la lista que se proporciona y, a continuación, pulse Siguiente para abrir el asistente de nuevo proyecto de plug-in.
  3. En el campo Nombre de proyecto, especifique un nombre para el proyecto y, en la sección de plataforma de destino, seleccione una infraestructura de OSGi y seleccione Estándar en el menú.
    Captura de pantalla del asistente para nuevo plug-in
    Pulse Siguiente.
    Se visualiza el panel de contenido.
  4. En el campo Versión, elimine "calificador" del final del número de versión. El calificador no se admite actualmente.
  5. En el campo Entorno de ejecución, seleccione el nivel de Java que coincida con el entorno de ejecución en su plataforma de tiempo de ejecución CICS de destino.
    Captura de pantalla del campo Entorno de ejecución con el menú seleccionado, donde se muestra una lista de las opciones disponibles para su selección.
  6. Deseleccione el recuadro de selección Generar un activador y pulse Finalizar. El nuevo proyecto de plug-in se crea en la vista del explorador de paquetes.
  7. Necesario: Requisito: Debe editar ahora el archivo de manifiesto de plug-in y añadir las dependencias de API JCICS. Si no realiza estos pasos, podrá exportar e instalar el paquete, pero no se ejecutará.
    1. En la vista del explorador de paquetes, pulse con el botón derecho del ratón en el nombre de proyecto y pulse Herramientas de PDE> Abrir manifiesto. El archivo de manifiesto se abre en el editor de manifiestos.
    2. Seleccione la pestaña Dependencias y, en la sección de paquetes importados, pulse Añadir. Se abre el diálogo de selección de paquete.
    3. Seleccione el paquete com.ibm.cics.server y pulse Aceptar. El paquete se visualiza en la lista de paquetes importados.
    4. Opcional: Opcional: repita el paso anterior para instalar el paquete siguiente, si así lo requiere su aplicación:
      Tabla 1.
      Paquete Descripción
      com.ibm.record La API Java para programas heredados que utilizan IByteBuffer de Java Record Framework que se entregaba con VisualAge. Anteriormente se encontraba en el archivo dfjcics.jar.
      com.ibm.cics.samples Ejemplos para redirigir System.out y System.err. Sustituye el archivo dfjoutput.jar.
    5. Pulse Ctrl+S para guardar el archivo de manifiesto.

Resultados

Se crea el nuevo proyecto de plug-in con las dependencias de API JCICS.

Qué hacer a continuación

Ahora puede crear su aplicación Java de CICS. Si no está familiarizado con el desarrollo de aplicaciones Java para CICS, puede utilizar los ejemplos de JCICS que se proporcionan con el SDK CICS Explorer como ayuda para iniciarse.

Nota: Cuando haya desarrollado la aplicación, debe añadir una declaración CICS-MainClass al archivo de manifiesto y declarar las clases utilizadas en la aplicación. Consulte el enlace relacionado para obtener más información.

Para obtener más información sobre el desarrollo de plug-in, consulte la sección "Guía del desarrollador de plug-ins de la plataforma" en la documentación de ayuda de Eclipse.

Cuando la aplicación Java finalice, debe desplegarla en un paquete de CICS en zFS. Los paquetes de CICS pueden contener uno o varios plug-in y son la unidad de despliegue de su aplicación en CICS.