WebSphere^TM Development Tools para iSeries V5.1 Notas sobre el release

Este documento proporciona información que es específica para este release del producto WebSphere Development Tools para iSeries. Este release integra componentes que anteriormente sólo estaban disponibles como productos independientes. Aquí encontrará información sobre los requisitos de hardware (memoria y espacio en disco), los requisitos de software (para el desarrollo y la ejecución), y ejemplos prácticos de migración.

El documento README contiene información sobre requisitos previos, las limitaciones del producto e información no incluida en la documentación.

El documento Notas sobre la instalación contiene todas las notas y procedimientos de la instalación. Incluye el uso de archivos de respuestas, cómo desinstalar y cómo añadir o eliminar componentes del producto.

Tabla de contenido

• Componentes
• Requisitos de la estación de trabajo
• Hardware
• Software
• Proceso de migración
• VisualAge(R) para Java(TM) Versión 3.5.3 Enterprise Toolkit para AS/400(R) RELEASE NOTES

Componentes del Release V5.1

Los cinco componentes son:

1. WebFacing Tool permite visualizar en la Web programas tradicionales que utilizan archivos de pantalla DDS. Los servlets y los beans Java JSP generados de forma personalizada sustituyen al código DDS y hacen posible el acceso a la Web.
2. WebSphere Studio para iSeries contiene asistentes para facilitar la creación de JavaBeans^TM, servlets Java, y el despliegue de aplicaciones e-business.
3. VisualAge para Java para iSeries proporciona un potente entorno para el desarrollo de Java. Opcionalmente, puede instalar ET/400, que proporciona herramientas, asistentes, beans de java y clases de AS/400 Toolbox para Java. Esto facilita el trabajo de desarrollar los programas de cliente y servidor Java que tienen como objetivo iSeries.
4. Co-Operative Development Environment (CODE), que le permite editar, compilar y depurar código RPG, COBOL, C, C++, CL, DDS y Java (incluye el Diseñador CODE, una herramienta WYSIWYG para DDS).
5. VisualAge RPG soporta aplicaciones con GUI Windows y acceso transparente a recursos del iSeries, y genera aplicaciones y applets Java.

La integración de WebSphere Studio y VisualAge para Java permite que equipos diferentes puedan comunicarse y trabajar conjuntamente para:

• Crear aplicaciones e-business nuevas
• Recibir aplicaciones e-business existentes procedentes de otros servidores
• Habilitar aplicaciones existentes para la Web

Además, la instalación de WebSphere Development Tools para iSeries es más sencilla con:

• Procedimientos de instalación gestionados mediante menús que se inician automáticamente
• Un asistente para la configuración del sistema principal y el servidor para establecer las comunicaciones entre las estaciones de trabajo y los servidores.

Requisitos de la estación de trabajo

Requisitos de hardware

• Procesador - Intel Pentium II (se recomienda un procesador compatible más rápido)
• Pantalla - SVGA 800x600 (1024x768 recomendado)
• Unidad de CD o DVD
• Ratón u otro dispositivo de puntero
• Adaptadores de comunicaciones adecuados (soportados por el sistema operativo de la estación de trabajo)
• Los requisitos de disco y memoria son:

  Componente	Memoria		Disco
  	Mínimo	Recomendado	Mínimo	Recomendado
  Herramienta WebFacing (Primera Edición)	128 MB		200 MB
  WebSphere Studio para iSeries (V3.5)	96 MB	128 MB	385 MB	500 MB
  VisualAge Java para iSeries (V3.5)	128 MB	192 MB	495 MB	550 MB
  CODE	64 MB	96 MB	235 MB
  VisualAge RPG	64 MB	96 MB	285 MB
  TOTAL para todos los productos	128 MB	256 MB	1.2 GB	1.5 GB

Los requisitos del sistema disminuyen si elige instalar únicamente las características que necesita.

Requisitos de software

Proceso de migración

VisualAge(R) para Java(TM)

Versión 3.5.3

Enterprise Toolkit para AS/400(R)

RELEASE NOTES

Tabla de contenido

1.0 Introducción
2.0 Requisitos previos
3.0 Limitaciones y problemas conocidos
     3.1 SmartGuide Convert Display File
     3.2 Rendimiento de los beans AS400eList
     3.3 Generación de código en beans DFU
4.0 Consejos y sugerencias
      4.1 Archivos de soporte de ejecución
      4.2 Despliegue de una aplicación VCE que tenga beans DFU
      4.3 Depuración
5.0 Sitios Web de Java AS/400
6.0 Documentación

1.0 Introducción

Estas Notas sobre el release contienen información sobre requisitos previos para VisualAge para Java Enterprise Toolkit para AS/400. Incluyen además las limitaciones del producto e información no incluida en la documentación.

Al servidor AS/400 se le conoce ahora como IBM eServer iSeries. No obstante, en este release de VisualAge para Java, todas las referencias al servidor se harán utilizando su nombre anterior, "AS/400".

2.0 Requisitos previos

• En general, se recomienda cargar en el AS/400 los areglos acumulativos (PTF) más recientes.
• El depurador distribuido (Distributed Debugger) requiere que se apliquen los siguientes PTF al release adecuado:
  

  Release de OS/400	Número de LPP	Número de PTF
  V4R3M0	5769SS1*	SF49975*
  V4R3M0	5769999	MF19487
  V4R4M0	5769999	MF24806
  V4R4M0	5769SS1	SF54570
  V4R4M0	5769SS1	SF56682
  V4R4M0	5769SS1	SF56281
  V4R4M0	5769SS1	SF63732
  V4R5M0	5769SS1	SF63034

*Nota: Este PTF será reemplazado por otro pronto.

Para obtener información sobre los PTF más recientes para el Distributed Debugger, consulte http://www-1.ibm.com/support/search.wss?rs=715&tc=SSZND2&dc=DA400.

• Se ha mejorado el soporte de código de edición para la SmartGuide Convert Display File. Para aprovechar esta ventaja, deberá aplicar el PTF adecuado:
  

  Release de OS/400	Número de LPP	Número de PTF
  V3R1M0	5763PW100	SF47783
  V3R2M0	5763PW100	SF47784
  V3R6M0	5716PW100	SF47785
  V3R7M0	5716PW100	SF47786
  V4R2M0	5769PW100	SF47774

• La acción Ejecutar de ET/400 requiere el siguiente PTF:
  

  Release de OS/400	Número de LPP	Número de PTF
  V4R3M0	5769SS100*	SF49975*
  V4R4M0	5769SS100	SF63732
  V4R5M0	5769SS100	SF63034

*Nota: Este PTF será reemplazado por otro pronto.

• Varios de los ejemplos utilizan archivos AS/400 actualizados de la biblioteca ADTSLAB. Para poder ejecutar estos ejemplos, deberá aplicar el PTF adecuado listado a continuación para el producto "Application Development ToolSet/400":
  

  Release de OS/400	Número de LPP	Número de PTF
  V4R2M0	5769PW100	SF63545
  V4R4M0	5769PW100	SF63703

Para conocer más PTF actualizados, consulte: http://www.software.ibm.com/ad/as400/vajava/

• Para conocer los PTF de IBM(R) AS/400 Toolbox para Java(TM), consulte el siguiente sitio Web: http://www.as400.ibm.com/Toolbox
• Para poder conectarse a un servidor AS/400, debe iniciar todos los servidores principales del AS/400 (emitiendo STRHOSTSVR *ALL) y debe iniciar también TCP/IP en el servidor (emitiendo el mandato STRTCPSVR *DDM).

3.0 Limitaciones y problemas conocidos

3.1 SmartGuide Convert Display File

En los sistemas que tienen versiones anteriores de IBM Personal Communications, es posible que no pueda iniciarse una sesión de IBM Personal Communications mientras la SmartGuide Convert Display File está ejecutándose. Una vez la SmartGuide finalice su ejecución, podrá iniciarse una sesión de IBM Personal Communications.  

Un bean generado por esta Smartguide puede abrirse en el VCE y salvarse tras pasar por Construct Visuals desde Fuente. El bean resultante podría no tener el mismo aspecto ni comportamiento que el original.

3.2 Rendimiento de beans AS400eList

Al extraer listas de un servidor AS/400, la conversión de datos puede tardar más tiempo en completarse si la lista es de gran tamaño o si se seleccionan campos binarios o de fecha. Para conseguir el mejor rendimiento posible, siga estas recomendaciones:

1. Utilice los formatos OBJL0100 ó OBJL0200, que permiten la conversión de datos en un solo paso.
2. Si se selecciona el formato OBJL0300 o un formato superior, intente evitar seleccionar los campos binarios o de fecha listados más abajo, a menos que sea necesario. Si se selecciona un campo binario o un campo de fecha, la conversión de los atributos de campo debe realizarse individualmente para cada elemento. Esto ralentiza el proceso global, especialmente en las listas de gran tamaño.

Campos binarios
getInclude0300AuxiliaryStoragePool()
getInclude0500SaveSize()
getInclude0500SaveSizeMultiplier()
getInclude0500SaveSequenceNumber()
getInclude0600DaysUsedCount()
getInclude0700Size()
getInclude0700SizeMultiplier()

Campos de fecha
getInclude0300CreateDateTime()
getInclude0300ChangeDateTime()
getInclude0500SavedDateTime()
getInclude0500RestoredDateTime()
getInclude0500SaveActiveDateTime()
getInclude0600LastUsedDateTime()
getInclude0600ResetDateTime() 

3.3 Generación de código en beans DFU

Cuando los beans FormManager, ListManager o RecordIOManager generan código, el indicador de progreso puede aparecer varias veces, dependiendo del número de métodos que se generen para la clase de condición. 

No intente cerrar la ventana Propiedad del bean durante la generación de código, ya que esto provocará que se cuelgue el Editor de composición visual. Para FormManager o ListManager, el valor de la propiedad recordIOManager cambiará de la forma correspondiente cuando se complete la generación de código, momento en que podrá cerrarse la ventana Propiedad.

4.0 Consejos y sugerencias

4.1 Archivos de soporte de ejecución

Los siguientes archivos .jar y .zip están disponibles para ejecutar ejemplos y aplicaciones fuera de VisualAge para Java. Estos archivos están disponibles en el directorio 'eab\runtime30':

• JT400.JAR (AS/400 Toolbox para Java)
• JT400MRI.ZIP (texto traducido para las clases de AS/400 Toolbox para Java)
• AS400UT.JAR (clases proporcionadas en el paquete com.ibm.ivj.et400.util y
  com.ibm.ivj.et400.util.awt)

Estos archivos .jar de Toolbox también pueden encontrarse en el directorio 'eab\runtime30':

• DATA400.JAR
• JT400PROXY.JAR
• JT400SERVLET.JAR
• JUI400.JAR
• UITOOLS.JAR
• UTIL400.JAR
• X4J400.JAR
• JT400ACCESS.ZIP
• UTILITIES.ZIP

Consulte las preguntas formuladas frecuentemente para saber cómo utilizar AS/400 Toolbox para Java en OS/400, en esta dirección http://www-1.ibm.com/servers/eserver/iseries/toolbox/faq.htm.

4.2 Despliegue de una aplicación VCE que tenga beans DFU

4.3 Depuración

Distributed Debugger se instala por separado de VisualAge para Java. Para instalarlo, vuelva a ejecutar el programa de configuración de VisualAge para Java y selecciona instalar Distributed Debugger.

5.0 Sitios Web de Java AS/400

Para conocer más sobre IBM AS/400 Toolbox para Java, visite el siguiente sitio web:
http://www-1.ibm.com/servers/eserver/iseries/toolbox/index.html

6.0 Documentación

1. La mayor parte de la ayuda de Enterprise Toolkit para AS/400 (ET/400) ha cambiado desde la última traducción. Consulte la ayuda en Inglés para obtener la versión más reciente.
2. Las características de ET/400 que solamente están documentadas en Inglés incluyen:
   • Los beans DFU: FormManager, ListManager y RecordIOManager. Los beans DFU son un conjunto de clases que amplían el soporte de código para acceder a uno o más archivos de base de datos del AS/400. Estos beans le permite correlacionar tablas, listas y formularios GUI con bases de datos AS/400 y manipular (recuperar, añadir, actualizar y suprimir) registros de base de datos.
   • Los beans de Lista de objetos: ET400List y AS400eList. Los beans de Lista de objetos proporcionan un método para acceder a nombres de objetos AS/400. Estos beans le permiten establecer propiedades de listado para seleccionar el tipo de lista de objetos deseado. Los tipos de listas de objetos incluyen una lista de bibliotecas, una lista de archivos dentro de una biblioteca, o una lista de ID de usuario en el sistema. Los valores de propiedad pueden utilizarse para acceder a muchos tipos distintos de listas de objetos.
   • Nuevos beans JFormatted (además de los beans JFormatted ya existentes): JFormattedTable, JFormattedTableColumn, JFormattedTextFieldCellEditor,
     JFormattedComboBoxCellEditor y JFormattedLabelCellRenderer.
   • Un nuevo diálogo de inicio de sesión (Logon).
   • Nuevas opciones en los diálogos Compile y Run.
   • El daemos ET/400, que puede iniciarse para evitar tener que iniciar la sesión en el mismo AS/400 más de una vez mientras se accede a SmartGuides, diálogos de acciones o diálogos de propiedad.
3. Se han añadido los siguientes conceptos desde la última traducción de la ayuda de ET/400:
   • "Beans DFU (Data File Utility)"
   • "Beans de Lista de objetos"
4. Se han añadido las siguientes tareas:
   • "Iniciar y detener el daemon ET/400"
   • "Lanzar el Visor OLT para depuración"
5. Se han añadido las siguientes referencias:
   • "Bean FormManager"
   • "Bean ListManager"
   • "Bean RecordIOManager"
   • "Propiedades de RecordIOManager"
   • "Consideraciones sobre llamada de programa"
   • "Bean JFormattedTable"
   • "Bean JFormattedTableColumn"
   • "Bean JFormattedTextFieldCellEditor"
   • "Bean JFormattedComboBoxCellEditor"
   • "Bean JFormattedLabelCellRenderer"
   • "Bean ET400List"
   • "Bean AS400eList"
6. Se han añadido los ejemplos pertenecientes a los nuevos beans DFU, Lista de objetos y JFormatted.
7. Los siguientes conceptos han cambiado:
   • En "beans JFormatted", se ha añadido información sobre los beans JFormattedTable, JFormattedTableColumn, JFormattedTextFieldCellEditor, JFormattedComboBoxCellEditor, y JFormattedLabelCellRenderer.
8. Las siguientes referencias han cambiado:
   • "Consideraciones sobre archivos de pantalla"
   • "Palabras clave de archivos de pantalla"
9. Desde la última traducción de la ayuda de ET/400 se ha eliminado la siguiente característica:
   • Ya no existe una SmartGuide Create Subfile y se han eliminado todas las referencias sobre crear subarchivos o sobre el uso de la SmartGuide Create Subfile.
10. Desde la última traducción de la ayuda de ET/400 se han eliminado las siguientes tareas:
    • "Creación de una clase de subarchivo"
11. Desde la última traducción de la ayuda de ET/400 se han eliminado las siguientes referencias:
    • "Registrar consideraciones de E/S para subarchivos"
12. Desde la última traducción de la ayuda de ET/400 se han eliminado los siguientes ejemplos:
    • "Crear una aplicación cliente/servidor de Java"
    • "Visualizar una lista de nombres y números de teléfono"
    • "Obtener y visualizar datos de un subarchivo"
    • "Poblar un subarchivo"
    • "Ocultar una columna de un subarchivo"
    • "Obtener un registro de un subarchivo"
    • "Obtener nombres de campos y descripciones para un archivo de base de datos"
    • "Establecer presentación de subarchivo"
    • "Añadir, eliminar e insertar registros de subarchivo"
    • "Establecer la modalidad de selección de subarchivo"
    • "AS/400 Toolbox para Java (demo)"