IBM WebSphere Development Studio Client para
iSeries Versión 5.1.2 Guía de migración
Esta información describe cómo migrar los
proyectos de IBM WebSphere Development Studio Client para
iSeries Versión 4.0, 5.0 o 5.1.
En general, la migración es fluida y transparente. Lo único que debe hacer es utilizar el área de trabajo existente y seguir trabajando con los proyectos en la nueva versión del producto.
En algunos casos especiales relacionados con las herramientas Java, las herramientas Web y la personalización de proyectos WebFacing, puede que sea necesario utilizar una herramienta de migración o realizar tareas manuales adicionales.
Importante: si tiene actualmente Development Studio Client para iSeries Versión
4.0 o Versión 5.0 o 5.1 y desea instalar WebSphere Development
Studio Client Versión 5.1.2, el proceso de instalación
desinstalará la versión anterior del producto. Antes de desinstalar Development Studio Client para iSeries Versión 4.0, 5.1 o 5.1, es aconsejable anotar la ubicación del área de trabajo de la Versión 4.0, 5.0 o 5.1 y efectuar una copia de seguridad de ella. Si no realiza una copia de seguridad del área de trabajo, puede perder los proyectos de la Versión 4.0, 5.0 o 5.1. (Por omisión, estos proyectos no se desinstalan ni suprimen).
Para averiguar dónde se encuentra el área de trabajo de la Versión 5.0 o 5.1:
- Si aceptó la ubicación por omisión cuando instaló la Versión 5.0, el área de trabajo
estará en el directorio X:\Documents &
Settings\su_ID_usuario\Mis Documentos\IBM\wdsc\workspace, siendo X la unidad en la que ha instalado el producto.
- De lo contrario, busque un directorio denominado .metadata. Cada directorio workspace contiene un directorio metadata; en el directorio en el que aparece .metadata es generalmente el área de trabajo.
- Para buscar la ubicación de un recurso individual, como por ejemplo un proyecto (en esta guía obtendrá más información acerca de la migración de diferentes tipos de proyectos):
- En el IDE de la Versión 5.0 o 5.1, pase a la vista Navegador: pulse
Ventana > Mostrar vista > Otras. Expanda
Básico y seleccione Navegador. Pulse
Aceptar.
- Pulse el nombre del recurso con el botón derecho del ratón y
seleccione Propiedades.
- En el panel de la izquierda, pulse Información.
La ubicación del recurso aparece en el panel de la derecha.
Para averiguar dónde se encuentra el área de trabajo de la Versión 4.0:
- Si aceptó la ubicación por omisión cuando instaló la versión 4.0,
el área de trabajo estará en el directorio X:\WDSC\WSSD\workspace, siendo X la
unidad en la que ha instalado el producto.
- Si no es así, busque (desde el menú Inicio) un
directorio llamado .metadata; en cada directorio workspace hay un directorio metadata.
Una vez localizado un directorio .metadata, compruebe el directorio en el que aparece; ese directorio puede ser su área de trabajo.
- Para buscar la ubicación de un recurso individual, como por ejemplo un proyecto (en esta guía obtendrá más información acerca de la migración de diferentes tipos de proyectos):
- En el IDE de la Versión 4.0, pase a la vista Navegador: pulse
Perspectiva > Mostrar vista > Otras. Expanda
Básico y seleccione Navegador. Pulse
Aceptar.
- Pulse el nombre del recurso con el botón derecho del ratón y
seleccione Propiedades.
- En el panel de la izquierda, pulse Información.
La ubicación del recurso aparece en el panel de la derecha.
Pasos rápidos postinstalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0 o 5.1.
- Cuando se le pida que confirme que desea convertir al formato del área de trabajo nueva, pulse
Aceptar.
Esta guía contiene otra información que debe leer antes de instalar la Versión 5.1.2. Sin embargo, si ya la ha instalado, puede encontrar la guía, por ejemplo, en X:\WDSC\install\help\migrate.htm.
Si desea información específica sobre cómo puede verse afectada el área de
trabajo o los proyectos debido a la migración a la versión 5.1.2, lea los
apartados pertinentes de la guía de migración suministrada junto con el
producto base WebSphere Studio. La ubicación de la guía depende de qué edición
de Development Studio Client tenga en el sistema.
- Si tiene WebSphere Development Studio Client Advanced Edition
para iSeries Versión 5.1.2, la guía de migración es el archivo migrate.html o migrate.pdf del directorio wsad del CD 1.
- De lo contrario, la guía de migración es migrate.html o migrate.pdf del directorio wssd del CD 1.
La guía también está disponible después de la instalación, por ejemplo, en:
- C:\Program Files\IBM\WebSphere Studio\Application
Developer\v5.1\migrate.html
- C:\Program Files\IBM\WebSphere Studio\Site Developer\v5.1\migrate.html
Debido a un cambio en el JDK 1.4, debe especificar un paquete (TM) al utilizar los asistentes Páginas Web de base de datos y Páginas Web de bean Java para generar páginas que deben ejecutarse en la versión 5.1.x. Este problema se produce si se utiliza la plantilla Bean de vista para el asistente Páginas Web de bean Java o el Patrón de detalles de beans maestros Java de acceso a base de datos de IBM(R). Esto también se aplica a los proyectos que contienen páginas y archivos .java generados anteriormente con estos asistentes que no especifiquen un paquete durante la creación. Con respecto al código generado anteriormente, mueva los archivos .java a un paquete. A continuación, actualice los archivos .jsp, actualice las sentencias de importación y la información de clases. En el archivo web.xml del proyecto, actualice la entrada de clase de servlet.
Este apartado describe cómo migrar a la Versión 5.1.2 los beans de llamada a
programa creados en Development Studio Client para iSeries Versión 5.0.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0.
- Si se le solicita que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
- Elimine la vía de acceso de clases antigua cambiando la vía de
construcción Java del proyecto.
- Pulse el proyecto Java con el botón derecho del ratón y seleccione
Propiedades.
- En el panel de la izquierda, seleccione Vía de construcción Java.
- 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 de llamada a programa en todos los
archivos PCML.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0.
- Si se le solicita que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
- Utilice el asistente de migración J2EE para:
- Convertir la estructura del proyecto a la versión
5.1.2.
- Migrar, opcionalmente, del nivel 1.2 al
nivel 1.3 de J2EE.
- Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva
Web y seleccione Migrar > Proyecto de herramientas Web de iSeries.
- La ventana Confirmar Migración indica que se migrará la estructura y el
contenido del proyecto. Para seguir realizando el proceso, pulse
Aceptar.
- La migración sustituirá los archivos iwdtrt.jar y jt400.jar de la carpeta WEB-INF\lib por los archivos jar de la Versión 5.1.2.
- Vuelva a ejecutar el asistente de llamada a programa en todos los
archivos PCML.
- Vuelva a ejecutar el asistente Servicios Web en todos los beans de Servicios Web.
- Esta migración sólo se aplica a los propios beans de Servicios Web. El código generado por el asistente Servicios Web requiere migración y limpieza manuales.
Este apartado describe cómo migrar a la Versión 5.1.2 los beans de llamada a
programa creados en Development Studio Client para iSeries Versión 5.0.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0.
- Si se le solicita que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
- Elimine la vía de acceso de clases antigua cambiando la vía de
construcción Java del proyecto.
- Pulse el proyecto Java con el botón derecho del ratón y seleccione
Propiedades.
- En el panel de la izquierda, seleccione Vía de construcción Java.
- 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 de llamada a programa en todos los
archivos PCML.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0.
- Si se le solicita que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
- Utilice el asistente de migración J2EE para:
- Convertir la estructura del proyecto a la versión
5.1.2.
- Migrar, opcionalmente, del nivel 1.2 al
nivel 1.3 de J2EE.
- Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva
Web y seleccione Migrar > Proyecto de herramientas Web de iSeries.
- La ventana Confirmar Migración indica que se migrará la estructura y el
contenido del proyecto. Para seguir realizando el proceso, pulse
Aceptar.
- La migración sustituirá los archivos iwdtrt.jar y jt400.jar de la carpeta WEB-INF\lib por los archivos jar de la Versión 5.1.2.
- Vuelva a ejecutar el asistente de llamada a programa en todos los
archivos PCML.
- Vuelva a ejecutar el asistente Servicios Web en todos los beans de Servicios Web.
Este apartado describe cómo migrar a la Versión 5.1.2 los beans de llamada a
programa creados en Development Studio Client para iSeries Versión 4.0.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 4.0.
- Cuando se le pida que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
- Elimine la vía de acceso de clases antigua cambiando la vía de
construcción Java del proyecto.
- Pulse el proyecto Java con el botón derecho del ratón y seleccione
Propiedades.
- En el panel de la izquierda, seleccione Vía de construcción Java.
- 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
- 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 Llamada a programa. El código generado por el asistente Llamada a programa requiere migración y limpieza manuales.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 4.0.
- Cuando se le pida que confirme que desea convertir al formato del área de trabajo nueva, pulse
Aceptar.
- Utilice el asistente de migración J2EE para:
- Convertir la estructura del proyecto a la versión
5.1.2.
- Migrar, opcionalmente, del nivel 1.2 al
nivel 1.3 de J2EE.
- Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva
Web y seleccione Migrar > Proyecto de herramientas Web de iSeries.
- Importante: en este momento, cierre el proyecto y vuelva a abrirlo para
evitar que se produzca una excepción relacionada con la supresión de
recursos.
- La ventana Confirmar Migración indica que se migrará la estructura y el
contenido del proyecto. Para seguir realizando el proceso, pulse
Aceptar.
- El proceso de migración eliminará los archivos wdt400rt.jar
y wdt400tb.jar de la carpeta WEB-INF\lib y copiará los archivos
iwdtrt.jar y jt400.jar de la versión 5.1.2 en la carpeta.
- Vuelva a ejecutar el asistente de llamada a programa en todos los
archivos PCML.
- Vuelva a ejecutar el asistente Servicios Web en todos los beans de Servicios Web.
- En la Versión 5.0, los beans de Servicios Web podrían haberse generado en el paquete por omisión.
A partir de la Versión 5.1, los beans deben generarse en un paquete con nombre antes de invocar el asistente Servicios Web.
- Esta migración sólo se aplica a los propios beans de Servicios Web. El código generado por el asistente Servicios Web requiere migración y limpieza manuales.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 4.0.
- Cuando se le pida que confirme que desea convertir al formato del área de trabajo nueva, pulse
Aceptar.
- En el menú principal, pulse Ventana > Preferencias.
- En el panel de la izquierda, expanda Editor LPEX y
seleccione Analizadores.
- En el panel de la derecha, seleccione
ILErpg. En el campo Nombre de clase situado
en la parte inferior, cambie el nombre de la clase por
com.ibm.etools.iseries.editor.ISeriesEditorRPGILEParser.
Pulse
Establecer.
- En el panel de la derecha, seleccione rpg. En el campo Nombre de clase situado
en la parte inferior, cambie el nombre de la clase por
com.ibm.etools.iseries.editor.ISeriesEditorRPGOPMParser.
Pulse
Establecer.
- Pulse Aplicar. Pulse
Aceptar.
Si tiene proyectos existentes de la Versión 4.0, 5.0.x o 5.1.x, puede especificar el área de trabajo antigua al iniciar el entorno de trabajo 5.1.2 y los proyectos pueden ejecutarse tal cual. Sin embargo, la visualización del proyecto puede ser incompleta. Por ejemplo, los archivos JSP de registro y algunos archivos de estilo de releases anteriores no aparecen en una vista de árbol de la versión 5.1.2.
La primera vez que convierta un archivo DDS, la estructura de proyectos se actualizará para reflejar el nuevo diseño de la versión 5.1.2. Por ejemplo, se importan los nuevos archivos de plantilla y archivos jar de entorno de ejecución. Esta operación se produce de la misma forma que si se seleccionara específicamente el asistente Importar.
Si tiene proyectos WebFacing de WebSphere Development Studio Client Versión
4.0, 5.0 o 5.1, puede migrarlos a Development Studio Client
Versión 5.1.2 mediante el asistente de importación. Siga estos pasos:
Después de la instalación:
- Seleccione Archivo > Importar.
- Elija Proyectos WebFacing. Pulse
Siguiente.
- Pulse Examinar para ir a la carpeta que
contiene los proyectos WebFacing que desea migrar a la versión 5.1.2. Pulse
Siguiente.
Nota:
Cuando actualiza a la Versión 5.1.2, los proyectos WebFacing siguen
estando disponibles en el directorio workspace original.
- Si migra desde Development Studio Client 5.0 o 5.1, consulte las secciones referentes a la localización del área de trabajo contenidas en Antes de empezar.
- Los proyectos WebFacing que encuentre el
asistente figurarán en el panel Proyectos WebFacing encontrados. Seleccione los proyectos que desea importar. El asistente creará un archivo EAR
del proyecto.
Los archivos EAR son archivos de archivado de aplicación de
empresa J2EE. Por omisión, el archivo EAR utiliza el nombre del proyecto WebFacing
y añade el sufijo _EAR al nombre. Si desea utilizar un nombre distinto o si se
propone consolidar varios proyectos en un solo archivo EAR, puede cambiar el
nombre en el campo Proyecto de aplicación de empresa.
- Pulse Finalizar para migrar el proyecto al área de trabajo de la Versión 5.1.2.
- Para ver el proyecto en la perspectiva WebFacing,
seleccione Ventana > Abrir perspectiva > WebFacing.
Los archivos originales tienen nombres nuevos con el siguiente formato:
nombre-archivo +_512_bak.
Si ha personalizado el proyecto WebFacing, puede que sea necesario fusionar las personalizaciones de los archivos originales en los siguiente archivos:
- PageBuilder.jsp
- CmdKeys.jsp
- logon.jsp
- index.html
- Si el proyecto anterior estaba habilitado para Struts, deben actualizarse los archivos de configuración de Struts (struts-config.xml).
- Si el proyecto anterior utilizaba Web Site Designer, deben actualizarse los siguientes archivos:
- \WebContent\index.jsp
- \WebContent\INV1.jsp
- \WebContent\INV2.jsp
- \WebContent\theme\WFB_blue.jtpl
Para migrar proyectos Web de iSeries pueden utilizarse los siguientes métodos:
- Migrar proyectos Web de iSeries utilizando un área de trabajo existente de WebSphere Development Studio Client Versión 5.0.x o Versión 5.1
Esta migración implica la utilización del área de trabajo existente en el IDE de la Versión 5.1.2
y la ejecución de la rutina de migración de las herramientas Web de iSeries.
- Migrar proyectos Web de iSeries utilizando un área de trabajo existente de WebSphere Development Studio Client Versión 4.0
Esta migración implica la utilización del área de trabajo existente en el IDE de la Versión 5.1.2
y la ejecución de la rutina de migración de las herramientas Web de iSeries. La rutina convierte el proyecto Web al nivel más reciente de J2EE.
Esta sección describe cómo migrar proyectos Web de iSeries de Development Studio Client
para iSeries Versión 5.0.x y 5.1 a Development Studio Client para iSeries Versión 5.1.2.
Las actividades de migración constan de las siguientes etapas:
- Migrar los proyectos utilizando un área de trabajo existente en 5.0.x o 5.1
- Migrar el contenido del proyecto de de iSeries
- Resolver los errores y los avisos generados como resultado de la migración
En la Versión 5.1.2, los nombres por omisión de las carpetas de contenido Web y de código fuente Java para nuevos proyectos Web pueden configurarse por medio de una página de preferencias. Los nombres por omisión son ahora JavaResources y WebContent. Estos nombres por omisión se utilizarán sólo para nuevos proyectos Web. Los proyectos Web creados en versiones anteriores a la Versión 5.1.2
seguirán utilizando los nombres antiguos. Lo mismo ocurre en los proyectos Web estáticos.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0.x o 5.1.
- Si se le solicita que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
- Opcional: En el menú principal, pulse Ventana > Preferencias. En el panel de la izquierda, expanda Herramientas Web y
seleccione Proyecto nuevo. En el panel derecho, establezca las preferencias de los nombres de carpeta por omisión.
Puede cambiar manualmente los nombres de carpeta fuente de los proyectos 5.0.x o 5.1 en la Versión 5.1.2 pulsando el nombre de carpeta con el botón derecho del ratón en la vista Navegador y pulsando Redenominar. La acción Redenominar cambia los nombres de carpeta y arregla la vía de acceso de construcción Java de los proyectos Web 5.0.x o 5.1. Si opta por redenominar los nombres de las carpetas JavaResources y WebContent en la Versión 5.1.2, deberá actualizar manualmente los scripts de construcción automatizada con los nombres de carpeta nuevos.
Para migrar el contenido del proyecto de herramientas Web de iSeries:
- Pulse el nombre del proyecto con el botón derecho del ratón
en la vista Navegador de proyectos de la perspectiva Web y seleccione
Propiedades. Seleccione Características de proyecto Web en el panel izquierdo. En la lista Características de proyecto Web disponibles, seleccione Añadir soporte de Struts si aún no está seleccionado. Pulse
Aceptar. Pulse Finalizar en la ventana Características de proyecto Web para aceptar la versión de Struts por omisión (1.1).
Nota:
Si se salta este paso, aparecerá una ventana que solicita la adición del soporte de Struts.
- Importante: en este momento, cierre el proyecto y vuelva a abrirlo para
evitar que se produzca una excepción relacionada con la supresión de
recursos.
- Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva
Web y seleccione Migrar > Proyecto de herramientas Web de iSeries.
La ventana Confirmar migración indica que se migrará la estructura y el
contenido del proyecto.
- Para seguir realizando el proceso, pulse
Aceptar. La ventana Información de progreso muestra el progreso de la migración.
- Cuando la migración haya finalizado, un mensaje indicará el resultado.
- Si el proceso de migración se ha llevado a cabo satisfactoriamente,
no hay que hacer nada más. Si el proceso de migración se ha llevado a cabo con
errores o avisos, continúe en el Paso 3: Resolver los errores y avisos
generados como resultado de la migración.
- El proceso de migración lleva a cabo las acciones siguientes:
- Actualiza los componentes Web de iSeries, las bibliotecas de códigos y los archivos
JavaScript (actualizando todos los archivos JSP de acuerdo con ello).
- Vuelve a generar los archivos relacionados con interacciones Web basándose en la infraestructura de Struts desde los archivos .wit, y actualiza los archivos de ejecución de las interacciones Web.
- Añade soporte para la nueva función de herramientas Web de iSeries disponible en la Versión 5.1.2.
Si surgen problemas en el proceso de migración, se abre una ventana que
indica que se han producido errores o avisos y que están en el archivo de
anotaciones de migración que se llama
nombreProyecto_MigrationDetails.txt, bajo el nombre del
proyecto en la perspectiva Web.
La sección de resultados de la migración situada en la parte superior del
archivo de anotaciones de migración indica el estado global de la migración y
hace referencia a un archivo de la información en línea que describe los errores
y avisos, y proporciona la acción correctora. Consulte el apartado
Mensajes de aviso
y error para la migración de proyectos Web
Sólo para la migración de 5.0.x, además de los avisos de migración que aparecen en el archivo de anotaciones, debe tener en cuenta que el atributo de longitud máxima (maxLength) ya no está soportado para el componente Web de entrada de texto. Esto puede afectar al aspecto visual de las páginas Web.
Esta sección describe cómo migrar proyectos Web de iSeries de Development Studio Client
para iSeries Versión 4.0. a Development Studio Client para iSeries Versión 5.1.2.
Las actividades de migración constan de las siguientes etapas:
- Migrar los proyectos utilizando un área de trabajo existente en V4.0.x
- Migrar la estructura de proyectos Web y, opcionalmente, la versión J2EE del proyecto
Nota:
La migración del proyecto Web a J2EE 1.3
es una actividad opcional. Sin embargo, en J2EE 1.2 no está soportada la
arquitectura de conectores J2EE (JCA).
- Migrar el contenido del proyecto de herramientas Web de iSeries
- Resolver los errores y los avisos generados a causa de la migración
Este enfoque está parcialmente soportado y de él se deriva una migración
incompleta.
Se pierden los valores de la interfaz de usuario, los valores de
depuración y la mayoría de las preferencias.
Se conservan los nombres de los
proyectos, los archivos fuente de los proyectos y la vía de construcción Java
(vía de acceso de clases) de los proyectos, pero no hay ninguna garantía de que
se conserve lo demás. Solo debe adoptar este enfoque si no se está utilizando
ningún sistema de gestión de configuraciones de software (SCM) soportado y si
es esencial conservar la información sobre la vía de construcción de los
proyectos, que se pierde al importar a la Versión 5.1.2 los proyectos exportados desde la Versión
4.0. Puede utilizar el área de trabajo existente en la Versión
4.0.x siguiendo estos pasos:
Antes de la instalación:
- Comprometa (libere) en el depósito los cambios que estén
pendientes.
- Cierre todas las perspectivas y concluya el producto de la
Versión 4.0.
- Haga copia de seguridad del contenido de directorio_workspace,
siendo directorio_workspace el nombre totalmente calificado del
directorio que contiene el área de trabajo de la versión 4.0.x. Por omisión, el
subdirectorio workspace de la versión 4.0.x está situado en el mismo directorio
que aquel en el que está instalado el producto. Necesitará esta copia de
seguridad por si alguna vez desea volver a trabajar con el producto de la
versión 4.0.x. Una vez que haya señalado hacia un área de trabajo de la Versión
4.0.x desde un IDE de la versión 5.1.2, ya no podrá hacer marcha atrás para
utilizar esa área de trabajo en el producto de la Versión
4.0.x.
- Instale Development Studio Client para iSeries
Versión 5.1.2.
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 4.0.x.
- Cuando se le solicite que confirme que desea actualizar el área de trabajo creada con una versión anterior del producto, pulse Aceptar.
- Antes de realizar tareas de reconstrucción o de validar los proyectos que
estén en el área de trabajo, seleccione todos los proyectos existentes en la
vista Navegador, en la perspectiva Recursos, y luego seleccione
Renovar en el menú emergente.
Esto hace que todos los archivos
se sincronicen con los correspondientes metadatos.
- Abra los proyectos que estén cerrados (consulte la sección Problemas conocidos y limitaciones).
- Verifique las variables de vía de acceso de clases (consulte la sección Problemas conocidos y limitaciones).
- En esta versión se han añadido, eliminado o modificado algunos
constructores y validadores. Para asegurarse de que se muestran los errores y avisos
correctos, debe reconstruir todos los proyectos seleccionando Proyecto > Reconstruir todo y, a continuación, seleccione Ejecutar validación para cada proyecto Java.
- Puede ser que se mantengan algunas preferencias del usuario, pero hay
otras muchas que no se mantendrán.
Compruebe los valores de sus preferencias en
la versión 5.1.2 para asegurarse de que son los deseados.
Eliminación tras la migración de las referencias a vías de
acceso absolutas de los archivos EAR y de configuración de servidor
Los archivos EAR application.xml y los archivos de configuración de servidor
de la Versión 4.0 contenían referencias a vías de acceso absolutas. Después de
haberlos migrado a la versión 5.1.2, tendrá que abrirlos con el correspondiente
editor (que cambia automáticamente las antiguas referencias a vías de acceso
absolutas por nuevas referencias relativas).
- Para cada proyecto EAR, actualice el archivo application.xml.
- En una vista Navegador, pulse META-INF/application.xml con el botón derecho del ratón y seleccione Abrir con > Editor de descriptor de despliegue.
- Pulse Sí en el mensaje
El archivo de
extensiones de IBM contiene vías de acceso absolutas obsoletas. Esto puede corregirse automáticamente... ¿Desea corregirlo automáticamente?
- Guarde y luego cierre la ventana del editor.
- Para cada configuración de servidor, actualice el archivo de configuración.
- En la vista Configuración de servidor de la perspectiva Servidor, pulse el nombre de servidor con el botón derecho del ratón y seleccione Abrir.
- Se abre una ventana similar de corrección automática.
- Pulse Sí.
- Guarde y luego cierre la ventana del editor.
Problemas conocidos y limitaciones
Si intenta migrar abriendo un área de trabajo de la versión 4.0 en el
producto de la versión 5.1.2, pueden producirse los problemas que se indican a
continuación.
Valor incorrecto en la variable de vía de acceso de clases JRE_LIB
Para restablecer la variable de vía de acceso de clases JRE_LIB en una
ubicación válida, siga estos pasos. Sígalos aunque el valor parezca correcto cuando abra por primera vez
la ventana Preferencias.
- Seleccione Ventana > Preferencias > Java > JRE instalados.
- En la lista, marque el recuadro de selección de la ubicación de JRE por
omisión en la que está establecida la variable JRE_LIB.
- Elija
Editar y después pulse Aceptar para cerrar el
diálogo Editar JRE.
Si no lo hace, el valor de JRE_LIB podría ser incorrecto, lo que provocaría
muchos errores de construcción en los archivos Java.
Como comprobación general, verifique el valor de las demás variables de vía
de acceso de clases.
Para los proyectos SCM compartidos anteriormente, el menú Equipo
contiene Compartir proyecto
El soporte de equipo ha cambiado notablemente entre
Eclipse 1.0 y 2.0. También ha cambiado el método de compartir proyectos con el
depósito.
- Si selecciona la opción Equipo > Compartir proyecto,
aparecerá un asistente que le orientará en el proceso de migración. Cuando haya
terminado, su proyecto estará compartido y se abrirá la vista Sincronizar. En cada archivo aparecerán cambios conflictivos. Ello se debe a los cambios que afectan a cómo se
almacena la información de sincronización en Eclipse 1.0 y 2.0.
- Si no tiene cambios salientes (no los tendrá si los comprometió todos antes de
actualizar, según las recomendaciones anteriores), basta con que seleccione el proyecto en la
vista Sincronizar y luego seleccione Alterar temporalmente y
actualizar, lo que cargará el contenido actual desde el servidor.
- Si tiene cambios salientes, despliegue el menú del triángulo en la vista Sincronizar y seleccione
Comparar contenido de archivo. Se llevará a cabo un proceso y
después en la vista Sincronizar solo figurarán los archivos que realmente presenten
diferencias. A continuación, puede utilizar la vista Sincronizar para resolver estos conflictos.
Proyectos creados fuera del directorio workspace
Por omisión, los proyectos se crean en el directorio
workspace. Si altera temporalmente el valor por omisión para que los proyectos
se creen en otro lugar, abra ahora todos los proyectos antes de cerrar el
entorno de trabajo. Esto permite que el archivo .project de ese proyecto se
escriba en la ubicación pertinente. Si no se puede abrir un proyecto cerrado
cuyo directorio esté fuera del área de trabajo, se obtendrá un proyecto que
enmascara el proyecto real, y en él solo existirá un archivo .project.
Tenga en cuenta que el asistente Migración J2EE puede llevar a cabo dos
funciones:
- Migrar la estructura del proyecto Web o la estructura del proyecto J2EE
de la versión 4.0 a la versión 5.1.2.
- Migrar, opcionalmente, el nivel 1.2 al nivel
1.3 de J2EE.
Para migrar la estructura del proyecto J2EE:
- Si todavía no está abierto, abra el IDE de la versión 5.1.2 seleccionando
el producto en el menú Inicio > Programas.
- En el IDE, seleccione Ventana > Abrir perspectiva > Web para
abrir la perspectiva Web.
- Pulse el nombre del proyecto con el botón derecho del ratón
en la vista Navegador de proyectos de la perspectiva Web y seleccione
Migrar > Asistente de migración J2EE.
- Siga las instrucciones que figuran en las páginas del
asistente. Si se propone utilizar el soporte JCA (arquitectura de conectores
J2EE), debe marcar el recuadro de selección Migrar proyecto del nivel
de versión J2EE 1.2 a J2EE 1.3.
- Pulse Finalizar para migrar el proyecto Web
seleccionado.
El siguiente proceso de migración depende de la migración satisfactoria de
la estructura del proyecto Web a la estructura del proyecto J2EE, tal como se
ha explicado en el apartado anterior.
Para migrar el contenido del proyecto de herramientas Web de iSeries:
- Pulse el nombre del proyecto con el botón derecho del ratón
en la vista Navegador de proyectos de la perspectiva Web y seleccione
Propiedades. Seleccione Características de proyecto Web en el panel izquierdo. En la lista Características de proyecto Web disponibles, seleccione Añadir soporte de Struts si aún no está seleccionado. Pulse
Aceptar. Pulse Finalizar en la ventana Características de proyecto Web para aceptar la versión de Struts por omisión (1.1).
Nota:
Si se salta este paso, aparecerá una ventana que solicita la adición del soporte de Struts.
- Importante: en este momento, cierre el proyecto y vuelva a abrirlo para
evitar que se produzca una excepción relacionada con la supresión de
recursos.
- Pulse el nombre del proyecto con el botón derecho del ratón
en la vista Navegador de proyectos de la perspectiva Web y seleccione
Migrar > Proyecto de herramientas Web de iSeries.
- La ventana Confirmar Migración indica que se migrará la estructura y el
contenido del proyecto. Para seguir realizando el proceso, pulse
Aceptar.
- Se abre la ventana Información de progreso, que indica que se está
realizando la operación de migración y muestra cómo avanza el
proceso.
- Al finalizar el proceso de migración, aparece una ventana con un
mensaje de aviso, error o éxito que indica el resultado de la
migración.
- Si el proceso de migración se ha llevado a cabo satisfactoriamente,
no hay que hacer nada más. Si el proceso de migración se ha llevado a cabo con
errores o avisos, continúe en el Paso 4: Resolver los errores y avisos
generados como resultado de la migración.
El proceso de migración lleva a cabo las acciones siguientes:
- Convierte todos los controles de tiempo de diseño existentes en los
archivos JSP en los nuevos campos y controles de componentes Web.
- Vuelve a generar los archivos relacionados con interacciones Web basándose en la infraestructura de Struts desde los archivos .wit, y actualiza los archivos de ejecución de las interacciones Web.
Si surgen problemas en el proceso de migración, se abre una ventana que
indica que se han producido errores o avisos y que están en el archivo de
anotaciones de migración que se llama
nombreProyecto_MigrationDetails.txt, bajo el nombre del
proyecto en la perspectiva Web.
La sección de resultados de la migración situada en la parte superior del
archivo de anotaciones de migración indica el estado global de la migración y
hace referencia a un archivo de la información en línea que describe los errores
y avisos, y proporciona la acción correctora. Consulte también la ayuda en línea que figura en Development
Studio Client para iSeries > Aplicaciones Web > Desarrollo Web de iSeries > Consulta
> Detalles de errores y avisos de migración.
Consideraciones adicionales acerca de la migración
Además de los errores de migración que aparecen en el archivo de anotaciones descrito en la Etapa 4, es necesario tener en cuenta los siguientes aspectos, cuando proceda:
- Asegúrese de restaurar una versión nueva del programa de servicio de subarchivo QDTSSFL en el sistema principal iSeries. Este programa de servicio es necesario para manipular el espacio de usuarios de subarchivo con las API de subarchivo. Para obtener las instrucciones destinadas a restaurar el programa de servicio, consulte la sección "Programa de servicio de subarchivo QDTSSFL"
que se encuentra en Ayuda > Contenido de la ayuda y, a continuación, en el sistema de ayuda en Consulta > Consulta de interfaz de usuario >
Aplicaciones Web de iSeries > Componentes Web de iSeries > API de subarchivo.
- La matriz de formato de datos devuelta desde un programa de sistema principal para un componente Web de tipo recuadro combinado puede expresarse ahora en dos formatos. Como resultado, puede que sea necesario cambiar el programa a fin de obtener el resultado de formato de datos deseado en el recuadro combinado. Para obtener más información acerca de los formatos de datos, consulte la sección "Datos" de la ayuda en línea, que se encuentra en Consulta > Consulta de interfaz de usuario > Aplicaciones Web de iSeries > Componentes Web de iSeries > Componente Web de recuadro combinado.
- La matriz de formato de datos devuelta desde un programa de sistema principal para un componente Web de tipo recuadro de selección puede expresarse ahora en dos formatos. Como resultado, puede que sea necesario cambiar el programa a fin de obtener el resultado de formato de datos deseado en el recuadro de selección. Para obtener más información acerca de los formatos de datos, consulte la sección "Datos" de la ayuda en línea, que se encuentra en Consulta > Consulta de interfaz de usuario > Aplicaciones Web de iSeries > Componentes Web de iSeries > Componente Web de recuadro de selección.
Además de los avisos de migración que aparecen en el archivo de anotaciones descrito en la Etapa 4, es necesario tener en cuenta los siguientes cambios, que pueden afectar al aspecto visual de las páginas Web:
- Las siguientes propiedades de control de tiempo de diseño (DTC) de tabla ya no están soportadas en el componente Web de tabla equivalente:
- Relleno de celdas
- Espaciado de celdas
- Tamaño de borde
- Alineación
- Anchura de tabla
- Altura de tabla
- Las propiedades Color de primer plano de casilla y Color de fondo de casilla de un DTC de
tabla no se aplican individualmente a los colores de columna de un componente Web de tabla. El color utilizado para todas las columnas es el que se ha definido para la primera columna de la tabla.
- Las propiedades Anchura visible, Bloqueo de mayúsculas y Sólo lectura asociadas con una columna Campo de entrada en un DTC de tabla no están soportadas en la columna equivalente Entrada de texto de un componente Web de tabla.
- Los botones Retroceso página, Avance página y Columna de selección del DTC de subarchivo no están soportados en el componente Web de tabla equivalente.
- Los valores de nombre de campo especificados en los DTC se migran a los valores de nombre de los componentes Web equivalentes. Todos los puntos (el carácter .) se sustituyen por subrayados (el carácter _) en el valor Nombre. Asimismo, el primer carácter del nombre de campo de un DTC puede convertirse a minúsculas en el valor de nombre del componente Web equivalente.
- Ya no es posible cambiar un atributo de componente Web durante la ejecución cuando se produce una condición especificada. Si ha utilizado la pestaña de atributos de tiempo de ejecución de DTC para definir una condición que, cuando se cumple, cambia un atributo de DTC durante la ejecución (por ejemplo, un cambio del cuerpo de font), el atributo de componente Web correspondiente ya no cambia cuando se produce esta condición.
Código de error |
Descripción |
Acción |
E100 |
Se ha producido un error indeterminado durante la migración del archivo JSP. |
Resuelva todos los demás errores o avisos del archivo de anotaciones de migración y ejecute de nuevo la herramienta de migración. |
E101 |
Un componente Web de iSeries del archivo JSP contiene un error. |
Resuelva el error del componente Web de iSeries. |
E200 |
El proceso del archivo .wit ha provocado un error indeterminado. |
Efectúe una doble pulsación en el archivo .wit que ha provocado el error para invocar el asistente Interacción Web. Pase por todas las páginas del asistente y efectúe los cambios necesarios. Pulse Finalizar. |
E201 |
Uno o varios de los nombres de componente Web definidos en las páginas utilizadas en esta interacción no son válidos. |
Efectúe una doble pulsación en el archivo .wit que ha provocado el error para invocar el asistente Interacción Web. Se abrirá una ventana que indicará que los nombres de componentes Web no son válidos y le solicitará si desea cambiarlos. Pulse "Sí". Continúe en la página "Correlacionar y enlazar los parámetros de entrada con los campos de entrada" del asistente (efectuando los cambios necesarios en las páginas anteriores del asistente). Especifique las opciones "Nombre en sesión", "Guardar en sesión" y "Enlazar" de los componentes Web (Campos de entrada) cuyo nombre haya cambiado. Continúe en la página "Correlacionar y enlazar los parámetros de salida con los campos de salida" del asistente. Especifique las opciones "Nombre en sesión", "Restaurar desde sesión" y "Enlazar" de los componentes Web (Campos de salida) cuyo nombre haya cambiado. Pase por todas las páginas del asistente y efectúe los cambios necesarios. Pulse Finalizar. |
E202 |
Un parámetro de salida definido en esta interacción tiene el valor de "Indicador de mensajes" establecido en true. El manejo avanzado de mensajes ha cambiado significativamente en este release. Debe redefinir las opciones de Manejo de mensajes. |
Efectúe una doble pulsación en el archivo .wit que ha provocado el error para invocar el asistente Interacción Web. Continúe en la página "Correlacionar y enlazar los parámetros de salida con los campos de salida" del asistente. En la ventana de propiedades del parámetro de salida, con el valor de "Controlador de mensajes" establecido en "true", seleccione el valor "true". Esta acción hace visible un botón: púlselo para definir las especificaciones de control de mensajes. |
E300 |
Se ha producido un error indeterminado al procesar el DTC y/o el componente Web de iSeries resultante. |
Resuelva todos los demás errores o avisos del archivo de anotaciones de migración. Redenomine el archivo de anotaciones de migración y ejecute de nuevo la herramienta de migración. |
E301-E302 |
La propiedad de DTC de pulsador Next/Previous ya no está soportada. El atributo Button type (tipo de botón) del componente Web de botón se definirá como Submit (someter). |
Utilice el asistente Interacción Web para crear una interacción a fin de especificar la página que contenía el botón Next/Previous (Siguiente/Anterior) como página de entrada JSP y para especificar la página destino del botón Next (Siguiente) como página de salida JSP. En la versión 4.0, el botón Next/Previous se utilizaba con varias páginas de entrada. Consulte la información que figura en
Ayuda > Contenido de la ayuda y, a continuación, en el sistema de ayuda, en Consulta > Consulta de interfaz de usuario > Aplicaciones Web de iSeries > Varias páginas de entrada y salida. |
Código de aviso |
Descripción |
Acción |
W100 |
Un componente Web de iSeries de la página JSP contiene un aviso. |
Solucione el aviso del componente Web de iSeries. |
W300 |
Un recuadro de lista o un recuadro combinado contenían más de un carácter para la propiedad Delimiter. El primer carácter encontrado en la propiedad Delimiter se utilizará para el atributo delimitador del componente Web de iSeries correspondiente. |
Asegúrese de que todas las opciones del componente Web de recuadro de selección o de recuadro combinado tienen correctamente definidos los atributos Name y Value. |
W301-W302 |
Un recuadro de lista o un recuadro combinado contenían el carácter de preselección *, en una propiedad Data [key] o [value]. |
Asegúrese de que todas las opciones del componente Web de recuadro de selección o de recuadro combinado tienen correctamente definidos los atributos Name y Value. |
W303 |
Todos los DTC de botón de selección de un archivo JSP que tienen la misma propiedad Group name aparecen ahora como opción de un componente Web de grupo de botones de selección. Las propiedades definidas en las pestañas Font y Color del primer botón de selección encontrado en la página JSP se utilizarán como atributos de Color y Font del grupo de botones de selección. Es decir, las propiedades Color tab y Font tab se perderán en los botones de selección subsiguientes del mismo grupo. |
Asegúrese de que el grupo de botones de selección aparezca visualmente según lo deseado dentro de la página JSP seleccionando el archivo JSP asociado y ejecutando el archivo en el servidor. Asegúrese de que los atributos Font y Color del grupo de botones de selección aparezcan visualmente según lo deseado seleccionando el archivo JSP asociado y ejecutando el archivo en el servidor. |
W304 |
La propiedad Label de Pushbutton ya no está soportado.
La propiedad Value de Pushbutton se ha correlacionado con el atributo Label del componente Web de botón correspondiente. El texto que aparece en el componente Web de botón es diferente del del DTC de Pushbutton. |
Cambie el valor del atributo Label si el texto mostrado en el componente Web de botón no es adecuado. |
W305 |
El DTC Subfile o Table aparece ahora fuera del código HTML FORM. Un componente Web de tabla no puede aparecer dentro de un código HTML FORM. Si el tipo DTC era
Subfile, el componente Web de iSeries correspondiente es el componente Web de tabla. |
Asegúrese de que el componente Web de tabla aparezca visualmente según lo deseado en la página JSP. |
W306-W320 |
Una propiedad de evento DTC ya no está soportada. |
Si es necesario, defina la acción asociada con un evento diferente. |
W306 |
OnDblClick |
|
W307 |
OnMouseDown |
|
W308 |
OnMouseOut |
|
W309 |
OnMouseOver |
|
W310 |
OnSelect |
|
W312 |
OnChange para botones de selección |
|
W313 |
OnChange para recuadros de selección |
|
W314 |
OnMouseUp |
|
W315 |
OnKeyDown para botones de selección |
|
W316 |
OnKeyPress para botones de selección |
|
W317 |
OnKeyUp para botones de selección |
|
W318 |
OnKeyDown para pulsadores |
|
W319 |
OnKeyPress para pulsadores |
|
W320 |
OnKeyUp para pulsadores |
|
W321 |
El componente Web tenía definido un atributo que ya no está soportado
debido a que 1) el atributo CSS asociado ya no está soportado en la mayoría de navegadores
2) el atributo HTML asociado ya está obsoleto en HTML 4.0 y no está soportado en la mayoría de navegadores |
Ninguna. |
Después de la instalación:
- Cuando inicia el producto de la Versión 5.1.2 (Inicio >
Programas > IBM WebSphere Studio > Development Studio Client para iSeries), se abre una ventana de WebSphere Studio en la que debe
especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la
ubicación del directorio del área de trabajo de la Versión 5.0.
- Cuando se le solicite que confirme que desea convertir al formato de
la nueva interfaz de usuario, pulse Aceptar.
Si ha dejado abierta la vista Estado de construcción 5.0 en el entorno de trabajo 5.0, se producirá el siguiente error en 5.1.2:
No se ha podido restaurar el diseño del entorno de trabajo
Pulse Aceptar para continuar. Este error está relacionado con la sustitución de la vista Estado de construcción de la perspectiva Proyectos iSeries por la vista Estado de trabajo iSeries de la perspectiva Explorador de sistemas remotos.
Las construcciones listadas en la vista original Estado de construcción no aparecen en la vista nueva. Al reconstruir el proyecto iSeries asociado, la construcción nueva aparecerá en la vista Estado de trabajo y la función en ejecución no resultará afectada.
Después de la migración, si obtiene un indicador rojo en un proyecto iSeries, puede deberse al hecho de que la conexión del Explorador de sistemas remotos asociada con el proyecto ya no existe. Para resolverlo:
- Pulse el proyecto iSeries con el botón derecho del ratón y seleccione Propiedades > Proyecto iSeries.
- Establezca la conexión que falta y pulse Aceptar.
Antes de desinstalar Development Studio Client Versión 4.0, debe exportar el
contenido del proyecto a la máquina de sistema principal. A continuación, instale
Development Studio Client Versión 5.1.2. Tras la instalación, es posible volver a
crear los proyectos ejecutando una acción desde el Explorador de sistemas
remotos.
Antes de la instalación:
Si ya ha instalado Development Studio Client para iSeries Versión 5.1.2 y
sabe que no ha cargado los proyectos en el sistema principal remoto, pase por alto esta sección.
- En la versión 4.0, pulse el proyecto de iSeries con el botón derecho del
ratón y seleccione Enviar cambios. Esto hará que se carguen
todos los cambios de código en la biblioteca asociada de ese proyecto. (Si no
está seguro de cuáles son el sistema principal y la biblioteca destino de este
proyecto, pulse el proyecto con el botón derecho del ratón y seleccione
Propiedades > Proyecto iSeries).
- Cierre la Versión
4.0 y desinstálela.
- Continúe con el proceso de instalación de Development
Studio Client para iSeries Versión 5.1.2.
Después de la instalación:
- En la versión 5.1.2, abra la perspectiva Explorador de sistemas remotos:
pulse Ventana > Abrir perspectiva > Explorador de sistemas remotos.
- Navegue hasta la biblioteca asociada del proyecto iSeries. Esta biblioteca contiene todo el código fuente que cargó a partir del
proyecto de iSeries.
- Seleccione los archivos físicos fuente de esta
biblioteca que formaban parte del proyecto de iSeries, púlselos con el botón
derecho del ratón y seleccione Hacer disponible fuera de
línea. Esto hace que vuelva a crearse el proyecto de iSeries que se
correlaciona con esta biblioteca, y descarga localmente todos los miembros
fuente en el proyecto.
Ahora puede continuar con el proceso de desarrollo.
Nota: otra manera de volver a crear rápidamente el proyecto consiste en
seleccionar Crear proyecto iSeries desde una biblioteca del
Explorador de sistemas remotos, pero así no se descarga ningún miembro fuente
de esa biblioteca. Tan solo se crea y configura un proyecto de iSeries que se
correlaciona con esa biblioteca y ese sistema principal.
Después de la instalación:
- En el menú principal, pulse Ventana > Abrir perspectiva > Recurso. Pulse
Aceptar.
- Cree un proyecto simple pulsando Archivo > Nuevo > Otros
> Simple > Proyecto, y llámelo Temp. Este proyecto es un
contenedor para importar el proyecto de la Versión 4.0 al área de trabajo de la
Versión 5.1.2.
- Seleccione Archivo > Importar > Sistema de archivos. Pulse
Siguiente.
- Desplácese al área de trabajo antigua e importe el proyecto que desea volver a crear. (Consulte las secciones referentes a la localización del área de trabajo contenidas en Antes de empezar).
- Cree un proyecto iSeries que se correlacione con la biblioteca y el
sistema principal del proyecto de la Versión 4.0 que acaba de importar.
- Pulse el botón derecho del ratón en cualquier punto de la vista
Navegador y seleccione Nuevo > Proyecto > iSeries > Local > Proyecto iSeries.
- Si no recuerda cuál es la biblioteca y el sistema principal, hallará
esta información en un archivo XML que se llama .iseries_project_properties,
bajo el proyecto Temp.
- Vuelva a crear los archivos físicos fuente que existían en el proyecto de
la versión 4.0:
- Pulse Archivo > Nuevo > Otros > iSeries > Local > Archivo físico fuente iSeries.
- Si no está seguro de cuál era el CCSID y la longitud de registro de sus
archivos, hallará esta información en un archivo XML denominado
.iseries_srcpf_properties, situado directamente bajo cada archivo físico
fuente.
- Ahora arrastre los miembros fuente del proyecto antiguo y suéltelos en el proyecto nuevo
de la Versión 5.1.2.
- Suprima el proyecto Temp, que ya no necesita, y abra la perspectiva
Proyectos de iSeries: pulse Ventana > Abrir perspectiva > Proyectos iSeries.
Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.
Esta información se ha desarrollado para productos y servicios
ofrecidos en los EE.UU. IBM puede no ofrecer los productos, servicios
o características tratados en esta documentación en otros países. Póngase en contacto con el representante local de IBM que le
informará sobre los productos y servicios disponibles actualmente en
su área.
Las referencias hechas a productos, programas o servicios de IBM no
pretenden afirmar ni dar a entender que únicamente puedan utilizarse
dichos productos, programas o servicios de IBM. En su lugar puede
utilizarse cualquier otro producto, programa o servicio
funcionalmente equivalente que no infrinja ninguno de los derechos de
propiedad intelectual de IBM. No obstante, es responsabilidad del
usuario evaluar y verificar el funcionamiento de cualquier producto,
programa o servicio que no sea de IBM.
IBM puede tener patentes o solicitudes de patente pendientes de
aprobación que cubran alguno de los temas tratados en esta
documentación. La posesión de esta documentación no le otorga ninguna
licencia sobre dichas patentes. Puede enviar las consultas sobre
licencias, por escrito, a la siguiente dirección:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
Para consultas sobre licencias solicitando información sobre
caracteres de doble byte (DBCS), póngase en contacto con el
departamento de propiedad intelectual de IBM de su país o envíe
directamente las consultas por escrito a:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
El párrafo que sigue no se aplica al Reino Unido ni a ningún otro país en el que
tales disposiciones sean incompatibles con las leyes locales:
INTERNATIONAL BUSINESS MACHINES CORPORATION SUMINISTRA ESTA PUBLICACIÓN "TAL CUAL", SIN
GARANTÍAS DE NINGUNA CLASE, YA SEAN EXPLÍCITAS O IMPLÍCITAS, INCLUIDAS LAS GARANTÍAS O
CONDICIONES IMPLÍCITAS DE NO VULNERACIÓN, COMERCIALIZACIÓN O ADECUACIÓN A UN PROPÓSITO
DETERMINADO, PERO SIN LIMITARSE A ELLAS. Algunos estados no permiten la declaración de exención de responsabilidad con respecto a las garantías explícitas o implícitas en determinadas transacciones; por tanto, esta declaración puede no ser aplicable en su caso.
Esta documentación podría incluir inexactitudes técnicas o errores tipográficos. La información que incluye está sujeta a cambios periódicos; dichos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar mejoras y/o cambios
en los productos y/o programas descritos en esta publicación en
cualquier momento y sin previo aviso.
Las referencias hechas en esta información a sitios Web que no son
de IBM se proporciona únicamente para su comodidad y no debe considerarse en modo alguno
como promoción de dichos sitios Web. Los
materiales de estos sitios Web no forman parte de los materiales de
IBM para este producto y el uso que se haga de estos sitios Web es de
la entera responsabilidad del usuario.
IBM puede utilizar o distribuir la información que usted le
suministre del modo que IBM considere conveniente sin incurrir por
ello en ninguna obligación para con usted.
Los licenciatarios de este programa que deseen obtener información
acerca del mismo con el fin de: (i) intercambiar la información entre
programas creados independientemente y otros programas (incluyendo
éste) y (ii) utilizar mutuamente la información que se ha
intercambiado, deben ponerse en contacto con:
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7
Esta información puede estar disponible, sujeta a los términos y
condiciones adecuados, incluyendo en algunos casos el pago de una
tarifa.
IBM proporciona el programa bajo licencia descrito en esta
documentación y todo el material bajo licencia disponible bajo los
términos del contrato de cliente IBM, del contrato internacional de
programas bajo licencia IBM o cualquier contrato equivalente.
La información concerniente a productos no IBM se ha obtenido de
los distribuidores de dichos productos, de sus anuncios publicados o
de otras fuentes disponibles públicamente. IBM no ha comprobado los productos y no puede afirmar la exactitud en
cuanto a rendimiento, compatibilidad u otras características
relativas a productos no IBM.
Las preguntas relativas a las posibilidades de productos no
IBM deben dirigirse a los distribuidores de los mismos.
Esta información contiene ejemplos de datos e informes utilizados
en las operaciones comerciales diarias. Para ilustrarlas de la forma más completa posible, los ejemplos pueden incluir los nombres de personas, empresas, marcas y productos. Estos nombres son ficticios y cualquier parecido con los nombres y direcciones utilizados por empresas reales es pura coincidencia.
Esta información contiene programas de aplicación de ejemplo en lenguaje
fuente, que ilustran las técnicas de programación en diversas plataformas
operativas. Puede copiar, modificar y distribuir estos programas de ejemplo de
cualquier forma sin pagar nada a IBM, bajo el propósito de
desarrollo, uso, comercialización o distribución de programas de aplicación
de acuerdo con la interfaz de programación de la aplicación para la
plataforma operativa para la cual se han escrito los programas de
ejemplo. Los ejemplos no se han probado exhaustivamente bajo todas las
condiciones. IBM, por lo tanto, no puede garantizar ni implicar la fiabilidad,
servicio o funcionalidad de estos programas.
Puede copiar, modificar y distribuir estos programas de ejemplo de
cualquier forma sin pagar nada a IBM bajo el propósito de desarrollo,
uso, comercialización o distribución de programas de aplicación de acuerdo
con los interfaces de programación de aplicaciones de IBM.
Cada copia o cada parte de los programas de ejemplo o de los trabajos que se
deriven de ellos debe incluir un aviso de copyright como se indica a
continuación:
(C) (el nombre de su empresa) (el año). Parte de este código se
deriva de IBM Corp. Sample Programs. (C) Copyright IBM Corp. 1992, 2002. Reservados todos los derechos.
La información sobre interfaces de programación está destinada a facilitarle la
creación de software de aplicación mediante este programa.
Las interfaces de programación de utilización general le permiten
escribir software de aplicaciones que obtiene los servicios de las
herramientas de este programa.
Sin embargo, esta información también puede contener información
de diagnóstico, modificación y ajuste.
La información de diagnóstico,
modificación y ajuste se proporciona para ayudarle a depurar el
software de aplicaciones.
Aviso: No utilice esta información de
diagnóstico, modificación y ajuste como interfaz de programación
porque está sujeta a cambios.
Los términos siguientes son marcas registradas de International
Business Machines Corporation en los Estados Unidos y/o en otros países:
* AIX |
* DB2 Extenders |
* Operating System/400 |
* AIX windows |
* DB2 Universal Database |
* OS/2 |
* Application System/400 |
*
 |
* Open Class |
* AS/400 |
* IBM |
* OS/390 |
* AS/400e |
* IBMLink |
* OS/400 |
* C Set ++ |
* Integrated Language Environment |
* RPG/400 |
* COBOL/2 |
* iSeries |
* SQL/400 |
* COBOL/400 |
* Language Environment |
* VisualAge |
* DB2 |
* MQSeries |
* WebSphere |
InstallShield es una marca registrada de InstallShield Corporation.
Intel y Pentium son marcas registradas de Intel
Corporation en los Estados Unidos y/o en otros países.
Java y todas las marcas registradas y logotipos basados en Java
son marcas registradas de Sun Microsystems,
Inc., en los Estados Unidos y en otros países.
Rational es una marca registrada de International Business Machines Corporation
y Rational Software Corporation en los Estados Unidos y/o en otros países.
ActiveX, Microsoft, SourceSafe, Visual C++, Visual SourceSafe, Windows,
Windows NT, Win32, Win32s y el logotipo de Windows
son marcas registradas de Microsoft Corporation en los Estados Unidos
y/o en otros países.
UNIX es una marca registrada de The Open Group.
Los demás nombres de empresas, productos y servicios pueden ser marcas
registradas o de servicio de terceros.