Migrar beans de llamada a programa

Migrar beans de llamada a programa de proyectos Java y Web de iSeries desde la Versión 5.1 a Versión 6.0.1

Esta sección describe cómo migrar a Versión 6.0.1 beans de llamada a programa creados en Development Studio Client para iSeries Versión 5.1 o 5.1.2.

En Versión 6.0.1, el asistente Llamada a programa coloca el archivo PCML de un bean de llamada a programa en el paquete de beans. Esto representa un cambio con respecto a las versiones anteriores. Si vuelve a crear un bean de llamada a programa a partir de un archivo PCML existente que no se encuentra en el paquete de beans, puede suprimir este archivo PCML una vez que el asistente haya finalizado la recreación del bean de llamada a programa.

Nota:
En la versión 6.0.1, puede crear un servicio Web de programa iSeries fuera del código fuente ILE RPG o COBOL o de los archivos PCML utilizando directamente el asistente Servicio Web. No es necesario ejecutar el asistente Llamada a programa y el asistente Servicio Web.

Migrar beans de llamada a programa de un proyecto Java

  1. Cuando inicia el producto Versión 6.0.1 ( Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abre una ventana de Workspace Launcher en la que debe especificar el directorio que hay que utilizar para la sesión. Especifique la ubicación del directorio del área de trabajo de la versión 5.x.
  2. Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. Elimine los archivos .jar de tiempo de ejecución cambiando la vía de construcción Java del proyecto:
    1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
    2. En el panel de la izquierda, seleccione Vía de construcción Java.
    3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
      j2ee.jar
    4. Vuelva a ejecutar el asistente Llamada a programa en todos los archivos PCML. Si está utilizando un paquete por omisión, debe especificar un nombre de paquete en la versión 6.0.1. Los beans Java y el archivo PCML que acaba de generar se encontrarán en el paquete especificado; puede suprimir los beans Java y el archivo PCML antiguos del paquete por omisión.

Migrar beans de llamada a programa de un proyecto Web

Si usted es usuario de un bean de servicio de llamada a programa, debe saber que en Versión 6.0.1 el asistente Llamada a programa siempre genera un archivo .config. Puede tratarse de un archivo especificado por usuario o del archivo por omisión, defaultPCW.config. Debe dejar de utilizar el asistente Configuración de entorno de ejecución. Para los proyectos Web anteriores a la Versión 6.0.1, el paso de migración de proyectos de herramientas Web indicado más delante obtendrá información del archivo web.xml del proyecto y creará automáticamente un archivo defaultPCW.config si aún no existe. A partir de ese punto, la configuración de entorno de ejecución de la llamada a programa se basará en los datos del archivo .config, en lugar de en el archivo web.xml.

  1. Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá una ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 5.1 o 5.1.2.
  2. Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. (Paso opcional: utilice el asistente Migración J2EE para migrar desde el nivel de J2EE 1.2 a un nivel superior de J2EE).
  4. Suprima iwdtrt.jar y jt400.jar de la carpeta WEB-INF\lib.
  5. Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML. El bean de servicio nuevo y los archivos PCML se crearán en el paquete especificado. Suprima los archivos PCML antiguos del proyecto Web.
  6. Vuelva a ejecutar el asistente Servicio Web en el bean de servicio.

El código generado por el asistente Servicios Web requiere migración y limpieza manuales. Esta migración sólo se aplica a los propios beans de servicio Web. Consulte las secciones de servicios Web de la guía de migración suministrada con el producto base Rational Software Developer Platform (consulte Buscar otra información importante para obtener enlaces a esta guía) para obtener información acerca de la migración de los servicios Web.

Migrar beans de llamada a programa de proyectos Java y Web de iSeries de la Versión 5.0 a Versión 6.0.1

Esta sección describe cómo migrar a Versión 6.0.1 beans de llamada a programa creados en Development Studio Client para iSeries Versión 5.0.

Nota:
En la versión 6.0.1, puede crear un servicio Web de programa iSeries fuera del código fuente ILE RPG o COBOL o de los archivos PCML utilizando directamente el asistente Servicio Web. No es necesario ejecutar el asistente Llamada a programa y el asistente Servicio Web.

Migrar beans de llamada a programa de un proyecto Java

  1. Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá una ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 5.0.
  2. Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. Elimine los archivos .jar de tiempo de ejecución cambiando la vía de construcción Java del proyecto:
    1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
    2. En el panel de la izquierda, seleccione Vía de construcción Java.
    3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:

      WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
      WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
      WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
      j2ee.jar
    4. Vuelva a ejecutar el asistente Llamada a programa en todos los archivos PCML. En la página Configurar autenticación del asistente, deseleccione la opción Generar archivo de configuración.

Migrar beans de llamada a programa de un proyecto Web

Las secciones que siguen describen cómo migrar el contenido de la carpeta de contenido Web, el código fuente Java y las carpetas del proyecto Web.

Para migrar el contenido de la carpeta de contenido Web:

  1. Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. Utilice la ubicación por omisión como área de trabajo.
  2. Pase a la perspectiva Recursos.
  3. Cree un proyecto Web dinámico con el mismo nombre y versión de servlet que el proyecto Web 5.0 existente. Para encontrar la versión de servlet, busque en el archivo .websettings del proyecto 5.0 existente y busque el código jsp-level. Si el nivel de jsp es 1.2, establezca la versión de servlet en 2.3; de lo contrario, establézcala en 2.2. Pulse Finalizar. No cambie a la perspectiva Web cuando se le solicite.
  4. Seleccione la carpeta de contenido Web del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
  5. Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de contenido Web (nombre por omisión Web Content) del proyecto Web 5.0 existente. Pulse Aceptar.
  6. Seleccione la carpeta de contenido Web, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de contenido Web, pero no la carpeta de contenido Web en sí.
  7. Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de contenido Web del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de contenido Web 5.0.

Para migrar el contenido de la carpeta de código fuente Java:

  1. Seleccione la carpeta de código fuente Java del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
  2. Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de código fuente Java (nombre por omisión: Java Source) del proyecto Web 5.0 existente. Pulse Aceptar.
  3. Seleccione la carpeta de código fuente Java, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de código fuente Java, pero no la carpeta de código fuente Java en sí.
  4. Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de código fuente Java del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de código fuente Java 5.0.

Para migrar el contenido de la carpeta de proyecto Web:

  1. Ahora seleccione el proyecto recién creado, púlselo con el botón derecho del ratón y seleccione Importar en el menú de contexto.
  2. Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione el proyecto Web 5.0 existente.
  3. Seleccione la carpeta de proyecto en el panel izquierdo y pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. En el panel izquierdo, deseleccione las carpetas de contenido Web y de código fuente Java. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de proyecto Web, excepto las carpetas de contenido Web y de código fuente Java y la carpeta de proyecto Web en sí.
  4. En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:

    Estos archivos contienen información acerca del proyecto, que es necesaria durante el diseño. La información no puede migrarse a la Versión 6.0.1, por lo que los archivos volverán a crearse cuando sea necesario.

  5. Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de proyecto Web recién creada debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de proyecto Web 5.0.

  1. (Paso opcional: utilice el asistente Migración J2EE para migrar desde el nivel de J2EE 1.2 a un nivel superior de J2EE).
  2. Suprima iwdtrt.jar y jt400.jar de la carpeta WEB-INF\lib.
  3. Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML.

Esta migración sólo se aplica a los propios beans de servicio. Consulte las secciones de servicios Web de la guía de migración suministrada con el producto base Rational Software Developer Platform (consulte Buscar otra información importante para obtener enlaces a esta guía) para obtener información acerca de la migración de los servicios Web.

Migrar beans de llamada a programa de proyectos Java y Web de iSeries de la Versión 4.0 a Versión 6.0.1

Esta sección describe cómo migrar a Versión 6.0.1 beans de llamada a programa creados en Development Studio Client para iSeries Versión 4.0.

Nota:
En la versión 6.0.1, puede crear un servicio Web de programa iSeries fuera del código fuente ILE RPG o COBOL o de los archivos PCML utilizando directamente el asistente Servicio Web. No es necesario ejecutar el asistente Llamada a programa y el asistente Servicio Web.

Migrar beans de llamada a programa de un proyecto Java

  1. Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá una ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 4.0.
  2. Cuando se le solicite que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
  3. Elimine los archivos .jar de tiempo de ejecución cambiando la vía de construcción Java del proyecto:
    1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
    2. En el panel de la izquierda, seleccione Vía de construcción Java.
    3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:

         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
         ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
  4. Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML. En la página Configurar autenticación del asistente, deseleccione la opción Generar archivo de configuración.

Esta migración sólo se aplica a los propios beans de llamada a programa. El código generado por el asistente Llamada a programa requiere migración y limpieza manuales.

Migrar beans de llamada a programa de un proyecto Web

Para migrar el contenido de la carpeta de contenido Web:

  1. Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. Utilice la ubicación por omisión como área de trabajo.
  2. Pase a la perspectiva Recursos.
  3. Cree un proyecto Web dinámico con el mismo nombre y versión de servlet que el proyecto Web 4.0 existente. Para encontrar la versión de servlet, busque en el archivo .websettings del proyecto 4.0 existente y busque el código jsp-level. Si el nivel de jsp es 1.2, establezca la versión de servlet en 2.3; de lo contrario, establézcala en 2.2. Pulse Finalizar. No cambie a la perspectiva Web cuando se le solicite.
  4. Seleccione la carpeta de contenido Web del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
  5. Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de contenido Web (nombre por omisión webApplication) del proyecto Web 4.0 existente. Pulse Aceptar.
  6. Seleccione la carpeta de contenido Web, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de contenido Web, pero no la carpeta de contenido Web en sí.
  7. Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de contenido Web del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de contenido Web 4. 0.

Para migrar el contenido de la carpeta de código fuente Java:

  1. Seleccione la carpeta de código fuente Java del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
  2. Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de código fuente Java (nombre por omisión: source) del proyecto Web 4.0 existente. Pulse Aceptar.
  3. Seleccione la carpeta de código fuente Java, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de código fuente Java, pero no la carpeta de código fuente Java en sí.
  4. Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de código fuente Java del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de código fuente Java 4.0.

Para migrar el contenido de la carpeta de proyecto Web:

  1. Ahora seleccione el proyecto recién creado, púlselo con el botón derecho del ratón y seleccione Importar en el menú de contexto.
  2. Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione el proyecto Web 4.0 existente.
  3. Seleccione la carpeta de proyecto en el panel izquierdo y pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. En el panel izquierdo, deseleccione las carpetas de contenido Web y de código fuente Java. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de proyecto Web, excepto las carpetas de contenido Web y de código fuente Java y la carpeta de proyecto Web en sí.
  4. En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:

    Estos archivos contienen información acerca del proyecto, que es necesaria durante el diseño. La información no puede migrarse a la Versión 6.0.1, por lo que los archivos volverán a crearse cuando sea necesario.

  5. Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de proyecto Web recién creada debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de proyecto Web 4.0.
  1. (Paso opcional: utilice el asistente Migración J2EE para migrar desde el nivel de J2EE 1.2 a un nivel superior de J2EE).
  2. Suprima wdt400rt.jar y wdt400tb.jar de la carpeta WEB-INF\lib.
  3. Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML.
  4. Esta migración sólo se aplica a los propios beans de servicio.

A partir de la Versión 5.1, los beans deben generarse en un paquete con nombre antes de invocar el asistente Servicios Web. El código generado por el asistente Servicios Web requiere migración y limpieza manuales.

Esta migración sólo se aplica a los propios beans de servicio Web. Consulte las secciones de servicios Web de la guía de migración suministrada con el producto base Rational Software Developer Platform (consulte Buscar otra información importante para obtener enlaces a esta guía) para obtener información acerca de la migración de los servicios Web.