Guía de iniciación a Java y AS/400: Java en cliente/servidor

(1)

Guía de iniciación a Java y AS/400:

Java en cliente/servidor

(2)

(3)

Guía de iniciación a Java y AS/400:

Java en cliente/servidor

(4)

(5)

Contenido

Capítulo 1. ¿Qué se puede realizar con

Java y AS/400?

. . . 1

Capítulo 2. Configuración de Java en

cliente/servidor

. . . 3

AS/400 Toolbox para Java - Visión general . . . . 4

Los PTF para Java y AS/400 . . . 4

Novedades de V4R5 . . . 5

Capítulo 3. Configurar el AS/400 para

Java en cliente/servidor . . . 7

Instalar los programas bajo licencia para Java en cliente/servidor . . . 7

Instalar un programa bajo licencia con el mandato Restaurar programa bajo licencia para Java en cliente/servidor . . . 8

Arrancar los servidores OS/400 . . . 8

Comprobar el perfil QUSER . . . 9

Cambiar el perfil de usuario QUSER . . . 10

Clases de acceso a nivel de registro de AS/400 Toolbox para Java . . . 11

Capítulo 4. Configurar la estación de

trabajo . . . 13

Instalar Java 2 Software Development Kit en la estación de trabajo . . . 13

Configurar el acceso a AS/400 Toolbox para Java . . 14

Correlacionar una unidad de red con el AS/400 para Java en cliente/servidor . . . 14

Bajar el archivo jt400 a la estación de trabajo . . 16

Copiar el archivo jt400.zip en la estación de trabajo utilizando FTP . . . 16

Establecer las variables de entorno PATH y CLASSPATH . . . 18

Establecer las variables de entorno PATH y CLASSPATH (Windows NT) . . . 19

Actualizar la sentencia PATH de JDK (Win NT) 20 Actualizar la sentencia CLASSPATH de AS/400 Toolbox para Java (unidad correlacionada de Win NT) . . . 21

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para Java (archivo copiado de Win NT) . 23 Establecer las variables de entorno PATH y CLASSPATH (Windows 95 ó 98) . . . 24

Abrir AUTOEXEC.BAT . . . 25

Actualizar la sentencia PATH de JDK (Win 95/98) . . . 25

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para Java (unidad correlacionada de Win 95/98) . . . 26

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para Java (Win 95/98) . . . 27

Instalar el producto IDE . . . 28

Capítulo 5. Crear una aplicación Java

31

Escribir una aplicación Java . . . 31

AS/400 Toolbox para Java - Ejemplo de CommandCall . . . 32

Denominar la aplicación Java . . . 34

Compilar la aplicación Java . . . 34

Ejecutar la aplicación Java . . . 35

Ejecutar el ejemplo CommandCallExample . . . 35

Ejemplos: interacción de la base de datos con Java 36 Ejemplo: interacción de base de datos de AS/400 mediante JDBC . . . 37

Ejemplo: interacción de GUI con la base de datos de AS/400 . . . 39

Capítulo 6. Información adicional

acerca de Java y AS/400 . . . 43

Guía de iniciación a Java y AS/400: los servlets . . 43

Más recursos de servlets . . . 44

Recursos de Java y AS/400 . . . 44

Aprendizaje de Java . . . 47

(6)

(7)

Capítulo 1. ¿Qué se puede realizar con Java y AS/400?

Java tiene capacidad para permitir a los usuarios conectarse a información de no importa qué origen. El lenguaje Java puede controlar datos que procedan de la Web, de una base de datos, de un sistema de archivos integrado o de cualquier otra entidad. Si utiliza Java junto con el AS/400, ante usted se abrirá todo un mundo de flexibilidad y manejabilidad. Podrá crear aplicaciones que se ejecuten desde casi cualquier plataforma y aún así proporcionarles acceso a sus recursos de AS/400. Podrá utilizar la Web, Java y el AS/400, todo a la vez y sin ninguna dificultad. En esta lista se resaltan únicamente algunas de las numerosas ventajas que Java y AS/400 tienen para ofrecer.

Aplicaciones Internet

v Utilizar conjuntamente la Web, Java y AS/400 con los servlets. v Establecer conexiones seguras con el AS/400.

v Crear HTML dinámico con las clases HTML de AS/400 Toolbox para Java. v Crear applets Java.

Aplicaciones AS/400

v Llamar a programas y a programas de servicio de AS/400.

v Llevar a cabo tareas administrativas con las clases de utilidades de AS/400 Toolbox para Java.

v Crear aplicaciones de base de datos de cliente/servidor con los controladores JDBC de AS/400 Toolbox para Java.

v Crear aplicaciones de base de datos AS/400 nativas con los controladores JDBC de AS/400 Developer Kit para Java.

v Acceder a datos y a aplicaciones de legado de AS/400.

v Crear código Java optimizado para operaciones de AS/400 específicas utilizando AS/400 Developer Kit para Java.

v Crear aplicaciones Java de cliente/servidor con AS/400 Toolbox para Java. v Crear con facilidad interfaces gráficas de usuario (GUI) con la Caja de

Herramientas Gráfica, que es una herramienta de edición visual. (Utiliza AS/400 Toolbox para Java).

Java en general

v Crear interfaces gráficas de usuario (GUI) para presentar datos a los usuarios y solicitarles datos.

v Disfrutar de las excelencias de la programación orientada a abjetos con Java. (Es decir, de la reutilización, herencia y abstracción del código).

v Emplear Java junto con otros lenguajes, como C++ y RPG.

v Disfrutar de las características inherentes de Java, como son la recogida de basura, la seguridad y la independencia de plataforma.

[ Página de presentación de Information Center | Escríbanos ]

[ Legal | Glosario de AS/400 ]

(8)

(9)

Capítulo 2. Configuración de Java en cliente/servidor

La programación Java en cliente/servidor con AS/400 consta de un programa Java que se ejecuta en una estación de trabajo (el cliente) que accede a los datos y a los recursos que hay en el AS/400 (el servidor). El habilitador de cliente/servidor para Java y AS/400 es AS/400 Toolbox para Java, un programa bajo licencia sin coste adicional del AS/400.

Requisitos de instalación:

v Cualquier cliente que tenga una máquina virtual Java en conformidad. AS/400 Toolbox para Java funciona con Windows 95/98/NT, OS/2, Linux, AIX, Sun Solaris y AS/400 (como cliente). Sin embargo, por cuestión de simplicidad, en la información de esta guía se da por sentado que tiene usted una estación de trabajo Win32 (un PC que ejecuta Windows 95, 98 o NT).

v TCP/IP instalado y configurado en el AS/400 y en la estación de trabajo. Encontrará más información acerca de TCP/IP en TCP/IP Configuration Fastpath y OS/400 TCP/IP Configuration and Reference.

Como iniciación a la programación Java en cliente/servidor para AS/400, siga estos pasos:

1. Configurar el AS/400.

a. Instalar los programas bajo licencia para Java. v AS/400 Toolbox para Java

v Servidores de sistema principal OS/400

b. Arrancar los servidores de sistema principal OS/400 y el servidor DDM. 2. Configurar la estación de trabajo.

3.

a. Instalar Java 2 Software DevelopmentKit (J2SDK). b. Configurar el acceso a AS/400 Toolbox para Java.

v Correlacionar una unidad de red con AS/400 Toolbox para Java o v Copiar los archivos de AS/400 Toolbox para Java en la estación de

trabajo.

c. Establecer las variables de entorno PATH y CLASSPATH. d. Instalar el producto IDE (entorno de desarrollo integrado). 4. Crear una aplicación Java.

5.

a. Escribir una aplicación Java y guardarla.

b. Compilar la aplicación Java utilizando el mandato javac. c. Ejecutar la aplicación Java utilizando el mandato java. Seguir adelante con Java y AS/400

Utilice los Javadocs para sacar el mayor partido de Java y AS/400. Al describir detalladamente cada una de las clases, los Javadocs son una buena fuente de consulta y referencia para AS/400 Toolbox para Java. En la publicación AS/400 Toolbox para Java - Guía de programación encontrará todos los recursos, consejos

(10)

y datos que necesita mientras crea aplicaciones Java. Para mantenerse al día en lo que respecta a las últimas tecnologías e innovaciones, vea Información adicional acerca de Java y AS/400.

AS/400 Toolbox para Java - Visión general

AS/400 Toolbox para Java es un conjunto de clases Java que le permiten acceder a los datos de AS/400 mediante un programa Java. Cuando se ejecutan en un cliente, las clases de AS/400 Toolbox para Java establecen conexiones TCP/IP por socket con el sistema AS/400 y acceden a los recursos que hay en el AS/400 mediante los servidores de sistema principal OS/400. Con AS/400 Toolbox para Java, una aplicación Java puede trabajar con los recursos de AS/400, entre los que podemos contar programas, mandatos, archivos en spool, datos de DB2/400, mensajes y trabajos de AS/400. La aplicación se puede ejecutar en una estación de trabajo o en la máquina virtual Java de AS/400.

AS/400 Toolbox para Java es un programa bajo licencia que se distribuye sin cargo adicional junto con cada uno de los AS/400.

Encontrará más información sobre las posibilidades de AS/400 Toolbox para Java en la documentación del producto AS/400 Toolbox para Java.

Los PTF para Java y AS/400

Las personas principiantes en la plataforma AS/400 tal vez no sepan que un PTF o arreglo temporal de programa es una solución temporal de un problema (o una forma de esquivarlo) que ha sido diagnosticado por IBM y que es consecuencia de algún defecto de un release actual y no alterado de un programa bajo licencia. Los PTF están destinados a sustituir a uno o varios objetos del producto. Por lo general, los PTF se incorporan a un release posterior del producto.

Durante el ciclo de desarrollo en el sistema AS/400, conviene enterarse bien de cuáles son los PTF necesarios para que el producto funcione de manera

satisfactoria. Los clientes también tienen que conocer esta información. Por lo tanto, le recomendamos vivamente que tenga instalados los PTF más recientes y que los aplique al sistema AS/400.

No olvide visitar estos enlaces para estar al día sobre esta información: v AS/400 Toolbox para Java - Los PTF

v WebSphere Application Server - Los PTF

Le recomendamos asimismo que aproximadamente cada dos meses solicite el PTF de grupo más reciente de los siguientes programas bajo licencia:

Release de OS/400 Producto(s) PTF de grupo

V4R2 5769-999 (SLIC)

5769-SS1 (XPF) 5769-JV1 (Java)

(11)

V4R3 5769-999 (SLIC) 5769-SS1 (XPF) 5769-JV1 (Java) SF99066 V4R4 5769-999 (SLIC) 5769-SS1 (XPF) 5769-JV1 (Java) SF99067

Novedades de V4R5

Instalar J2SDK (Java 2 Software Development Kit)

V4R5 funciona con Java 2 Software Development Kit, que incluye las clases de JDK 1.2 y de Swing 1.1.

Ejemplos nuevos

Se han añadido dos ejemplos de código que muestran cómo puede interaccionar el lenguaje Java con la base de datos de AS/400.

¿Qué se puede realizar con Java y AS/400?

Se ha añadido una nueva sección titulada ¿Qué se puede realizar con Java y AS/400?.

De qué modo puede usted averiguar la posición que tiene en nuestra información:

Los pequeños enlaces situados al principio de las páginas muestran dónde se encuentra usted en nuestra información. Estos enlaces se visualizan con el formato de estructura del directorio. Para averiguar dónde se encuentra, tan solo tiene que seguir los enlaces. Por ejemplo, si mira en la parte superior de esta página, verá: Guía de iniciación a Java y AS/400 \ Novedades de V4R5

Estos enlaces indican que está usted en la información de″Novedades de V4R5″, que a su vez está en el tema ″Guía de iniciación a Java y AS/400″.

Cómo se pueden ver las novedades y los cambios realizados:

Para ayudarle a ver dónde se han realizado cambios técnicos, hemos utilizado: v La imagen para marcar dónde empieza la información nueva o cambiada. v La imagen para marcar dónde termina la información nueva o cambiada.

(12)

(13)

Capítulo 3. Configurar el AS/400 para Java en cliente/servidor

Para acceder al sistema AS/400 con Java, instale AS/400 Toolbox para Java. AS/400 Toolbox para Java utiliza los servidores de sistema principal OS/400, por lo que tendrá que instalar los servidores y arrancarlos.

Siga estos pasos:

1. Instalar los programas bajo licencia (LP) para Java. v AS/400 Toolbox para Java

v Servidores de sistema principal OS/400

2. Arrancar los servidores de sistema principal OS/400 y el servidor DDM.

Instalar los programas bajo licencia para Java en cliente/servidor

Para la programación Java en cliente/servidor con AS/400, debe instalar AS/400 Toolbox para Java. También es necesario instalar los servidores de sistema principal OS/400, que AS/400 Toolbox para Java utiliza para acceder a los recursos de AS/400.

1. En el indicador de mandatos de AS/400, escriba: GO LICPGM

Pulse la tecla Intro.

Aparece la pantalla Trabajar con programas bajo licencia.

2. Seleccione la opción 11 del menú para instalar los programas bajo licencia. 3. Recorra la lista pulsando la tecla AvPág. Localice estos dos programas bajo

licencia y, si no están instalados, teclee un 1 (Instalar) en el espacio en blanco de la columna Opción a la altura de estos dos programas:

5769SS1 OS/400 - Host Servers 5769JC1 AS/400 Toolbox para Java

Nota:para averiguar si se ha instalado un programa bajo licencia, pulse F11 en la pantalla Instalar programas bajo licencia. Si un programa bajo licencia está instalado, se verá

*COMPATIBLEen el campo Estado instalado.

Si no aparece uno o ninguno de estos programas en el menú Instalar programas bajo licencia, tendrá que utilizar el procedimiento del mandato Restaurar programas bajo licencia (RSTLICPGM) para instalar los programas bajo licencia desde CD-ROM, disco o cinta.

4. Pulse la tecla Intro. Los programas empezarán a instalarse.

Cuando los programas bajo licencia hayan terminado de instalarse, aparecerá de nuevo la pantalla Trabajar con programas bajo licencia.

(14)

Instalar un programa bajo licencia con el mandato Restaurar programa

bajo licencia para Java en cliente/servidor

Los programas listados en la pantalla Instalar programas bajo licencia son los soportados por la instalación LICPGM cuando se adquirió el sistema.

Ocasionalmente, van apareciendo nuevos programas que no se encuentran en la lista de programas bajo licencia del sistema (por ejemplo, AS/400 Toolbox para Java para V3R2, V3R7 y V4R1). Si este es el caso del programa que desea instalar, debe utilizar para ello el mandato Restaurar programa bajo licencia (RSTLICPGM). Para instalar un programa bajo licencia con el mandato Restaurar programa bajo licencia (RSTLICPGM), siga estos pasos:

1. Ponga la cinta o el CD-ROM que contiene el programa bajo licencia en la unidad apropiada.

2. En la línea de mandatos de AS/400, escriba: RSTLICPGM

y pulse la tecla Intro.

Aparece la pantalla Restaurar programa bajo licencia (RSTLICPGM).

3. En el campo Producto, escriba el número de ID del programa bajo licencia que desea instalar.

4. En el campo Dispositivo, especifique el dispositivo de instalación.

Nota:si instala desde una unidad de cintas, el ID de dispositivo suele tener el formato

TAPXX, siendo XX un número, como 01.

5. Conserve los valores por omisión en los demás parámetros de la pantalla

Restaurar programa bajo licencia. Pulse la tecla Intro.

6. Aparecen más parámetros. Conserve también estos valores por omisión. Pulse la tecla Intro. El programa empezará a instalarse.

Cuando el programa bajo licencia haya terminado de instalarse, aparecerá de nuevo la pantalla Restaurar programa bajo licencia.

Arrancar los servidores OS/400

Para poder acceder a los datos del AS/400 con AS/400 Toolbox para Java, primero debe arrancar los servidores de sistema principal. Al arrancarlos, se inicia un daemon servidor que está a la escucha de una petición de conexión procedente de un sistema cliente (en este caso, la estación de trabajo) y la acepta. El daemon servidor de sistema principal también conecta la conexión de cliente con el trabajo servidor apropiado.

Para arrancar los servidores, siga estos pasos: 1. Compruebe que está habilitado el perfil QUSER.

2. Ejecute el mandato Arrancar servidor de sistema principal. En la línea de mandatos de AS/400, escriba:

STRHOSTSVR *ALL Pulse la tecla Intro.

(15)

Nota:puede recibir el mensaje “Los trabajos del daemon servidor de sistema principal no

pueden comunicarse utilizando IPX”. Este mensaje significa que IPX no está configurado. El mensaje no implica que los servidores de sistema principal no se hayan arrancado.

3. Si tiene previsto utilizar las clases de acceso a nivel de registro de AS/400 Toolbox para Java, el servidor DDM (gestión de datos distribuidos) debe estar en marcha. El servidor DDM procesa las peticiones de acceder a los datos a nivel de registro.

En la línea de mandatos de AS/400, escriba: STRTCPSVR *DDM

En la parte inferior de la pantalla aparece el mensaje: “Se está arrancando el servidor DDM”.

Comprobar el perfil QUSER

Los servidores de sistema principal OS/400 se arrancan bajo el perfil de usuario QUSER. Por eso, cuando vaya a arrancar los servidores, conviene asegurarse primero de que el estado del perfil QUSER es operativo.

Para comprobar el perfil QUSER, siga estos pasos: 1. En una línea de mandatos de AS/400, escriba:

WRKUSRPRF USRPRF(QUSER) Pulse la tecla Intro.

Utilice la tecla de tabulador o la de flecha abajo para situar el cursor en el espacio en blanco Opc, junto a QUSER. Teclee un 5 para visualizar el perfil de usuario y luego pulse la tecla Intro.

Aparecerá una pantalla parecida a la siguiente:

(16)

2. El campo Estado debe indicar *ENABLED y que el campo Establecer contraseña

en caducada debe indicar *NO.

Si el perfil está inhabilitado (no es *ENABLED) y/o la contraseña ha caducado, cambie el perfil.

Cambiar el perfil de usuario QUSER

Si el perfil de usuario QUSER está inhabilitado, debe habilitarlo para arrancar los servidores de sistema principal OS/400. Además, la contraseña del perfil QUSER no puede ser″*NONE″. Si lo fuese, debe restablecerla.

Siga estos pasos para arreglar el perfil QUSER:

1. Pulse F3 o F12 para regresar a la pantalla Trabajar con perfiles de usuario. 2. Utilice la tecla de tabulador o la de flecha abajo para situar el cursor en el

espacio en blanco Opc, junto a QUSER. Escriba un 2 para cambiar el perfil de usuario y pulse la tecla Intro.

3. Cambie estos campos dándoles los siguientes valores:

Establecer contraseña en caducada *NO Estado . . . *ENABLED

4. Pulse la tecla Intro.

En la parte inferior de la pantalla aparece este mensaje: “El perfil de usuario QUSER ha cambiado”.

Ahora el perfil de usuario QUSER ya está preparado para arrancar los servidores de sistema principal OS/400.

(17)

Clases de acceso a nivel de registro de AS/400 Toolbox para

Java

Las clases de acceso a nivel de registro permiten al programa Java crear y trabajar con registros de base de datos, archivos físicos y lógicos, y miembros de archivo que residen en el AS/400.

Encontrará más información sobre el acceso a nivel de registro en la

documentación del producto AS/400 Toolbox para Java, en el tema “Acceso a nivel de registro”.

(18)

(19)

Capítulo 4. Configurar la estación de trabajo

Ahora que el AS/400 está preparado para Java, configure la estación de trabajo Win32 para ejecutar Java.

Para preparar la estación de trabajo, siga estos pasos: 1. Instalar J2SDK (Java 2 Software Development Kit).

2. Configurar el acceso al archivo jt400 de AS/400 Toolbox para Java. 3. Establecer las variables de entorno PATH y CLASSPATH.

4. Instalar el producto IDE (entorno de desarrollo integrado).

Instalar Java 2 Software Development Kit en la estación de trabajo

Necesitará un JDK (Java Development Kit) para proporcionar el entorno Java de la estación de trabajo. Para crear los programas Java, utilizará las clases de JDK y Swing junto con las de AS/400 Toolbox para Java. Swing es una biblioteca de componentes que son interfaces gráficas de usuario que dan soporte a las

interfaces gráficas de AS/400 Toolbox para Java. Tanto las clases de JDK 1.2 como las de Swing 1.1 se incluyen junto con Java 2 Software Development Kit.

1. Baje J2SDK

Nota:siga las instrucciones del sitio Web de Sun Microsystems, Inc., para bajar JDK. Lea sin falta y meticulosamente todos los acuerdos sobre licencias.

2. Cuando haya terminado de bajar J2SDK, siga las instrucciones de Para continuar, situadas más abajo del recuadro de bajada de color morado, para instalar JDK.

3. Baje la documentación de J2SDK No se olvide de seleccionar Archivo ZIP para Windows, en la ventana desplegable Seleccionar formato de bajada.

Necesita un programa de extracción de archivos ZIP para instalar los archivos de

documentación de JDK. Encontrará más información sobre los programas de extracción de ZIP en Instrucciones de instalación de documentación de JDK.

4. Después de haber bajado el archivo ZIP de documentación de JDK, siga las instrucciones de Para continuar, situadas más abajo del recuadro de bajada de color morado, para instalar la documentación.

(20)

Configurar el acceso a AS/400 Toolbox para Java

Nota:en la estación de trabajo puede utilizar uno de estos dos archivos: jt400.zip o

jt400.jar. Las instrucciones que siguen son para el archivo jt400.zip, pero son aplicables igualmente al archivo jt400.jar.

Si está familiarizado con las tareas de los Java Development Kit, ya sabrá que el archivo classes.zip contiene las clases Java núcleo de la plataforma Java. AS/400 Toolbox para Java también tiene un archivo de clases núcleo, que es el archivo jt400.zip.

Para compilar y ejecutar programas Java que contengan clases de AS/400 Toolbox para Java, es preciso que la estación de trabajo tenga acceso a AS/400 Toolbox para Java y al archivo jt400.zip. Los procedimientos que se describen a continuación permiten lograr un mismo objetivo: configurar el acceso al archivo jt400.zip. Sin embargo, cada uno de ellos tiene sus propias ventajas. Elija el procedimiento que más se ajuste a sus necesidades.

Son tres los procedimientos básicos que permiten acceder al archivo jt400.zip: 1. Recomendado si tiene AS/400 Client Access: para acceder remotamente a

jt400.zip, puede correlacionar una unidad de red con el AS/400 (utilizando AS/400 Client Access).

2. Recomendado si no tiene AS/400 Client Access:

a. Puede copiar el archivo jt400.zip en la estación de trabajo utilizando FTP b. O bien bajar el archivo jt400.zip a la estación de trabajo e instalarlo en

ella.

Nota:el inconveniente que tienen estos procedimientos es que cuando se actualiza la copia de AS/400 mediante los PTF, la copia de la estación de trabajo quedará desfasada. Sin embargo, puede utilizar la clase AS400ToolboxInstaller para escribir un programa que le permita mantener actualizada la copia de jt400.zip en la estación de trabajo.

3. Recomendado si desea instalar en el cliente la cantidad mínima de clases de AS/400 Toolbox para Java:

Consulte la página Soporte de proxy de la documentación de AS/400 Toolbox para Java.

Correlacionar una unidad de red con el AS/400 para Java en

cliente/servidor

Para realizar estos pasos, debe tener instalado AS/400 Client Access para Windows en el AS/400 y en la estación de trabajo. Encontrará más información sobre cómo puede instalar y configurar AS/400 Client Access en el taller Client Access de AS/400 Technical Studio.

Para poder correlacionar una unidad de red, primero debe tener configurada una conexión para el sistema AS/400.

(21)

a. Con el botón derecho del ratón, pulse el botón Inicio de la barra de tareas de Windows.

b. Pulse Explorar en el menú emergente.

2. Seleccione Conectar a unidad de red en el menú desplegable Herramientas.

3. Seleccione la unidad (por ejemplo, X:) que desea conectar al AS/400.

4. Escriba el nombre de la ruta (vía) de acceso al sistema AS/400. Por ejemplo: \\MIAS400

siendo MIAS400 el nombre del sistema AS/400.

5. Si el recuadro de selección Volver a conectar al inicio de sesión está vacío, púlselo.

6. Pulse Aceptar para terminar.

La unidad de red correlacionada (conectada) aparecerá en la sección Todas las carpetasdel Explorador de Windows.

(22)

Bajar el archivo jt400 a la estación de trabajo

Hay una copia de evaluación totalmente operativa del código de AS/400 Toolbox para Java que se puede bajar desde este sitio Web:

1. Bajar el archivo jt400.

Nota:puede ser conveniente crear un nuevo directorio para este archivo. Para crear un nuevo directorio, cuando aparezca la ventana Guardar como..., pulse el icono Carpeta

nueva. Escriba el nombre del directorio (ejemplo: jt400) y pulse″Aceptar″. Así se crea un directorio llamado jt400 y el archivo se guarda en él.

2. Descomprimir el archivo jt400.

Nota:el hecho de descomprimir este archivo tiene dos efectos: v Se extraen los archivos nuevos.

v Se crea un subdirectorio″lib″ y en él se guardan automáticamente todos los archivos nuevos extraídos.

Es importante tenerlo presente para las referencias futuras. En especial, debido a que el paso siguiente implica establecer la variable de entorno CLASSPATH del archivo jt400.zip. Ejemplo: suponiendo que ha guardado el archivo jt400All.zip en el directorio

C:\jt400, el archivo jt400.zip se guardaría en el directorio C:\jt400\lib.

Copiar el archivo jt400.zip en la estación de trabajo utilizando

FTP

En la estación de trabajo puede utilizar uno de estos dos archivos: jt400.zip o jt400.jar. Las instrucciones que siguen son para el archivo jt400.zip, pero son aplicables igualmente al archivo jt400.jar.

Para que JDK de JavaSoft tenga acceso a las clases núcleo de AS/400 Toolbox para Java, copie el archivo jt400.zip (que está en el AS/400) en la estación de trabajo utilizando FTP (protocolo de transferencia de archivos):

1. En la estación de trabajo, abra una sesión de MS-DOS. 2. Cree en la estación de trabajo un directorio para jt400.zip. 3. En el indicador del DOS, escriba:

ftpmias400

siendo mias400 el nombre de sistema principal del AS/400.

Nota:si el AS/400 no tiene ningún nombre de sistema principal, en vez del nombre utilice la dirección IP del AS/400.

Aparece un mensaje parecido a “Conectado a mias400.company.com”. 4. Le solicitarán su nombre de Usuario de AS/400. Escríbalo y pulse la tecla

Intro.

(23)

Aparecerá un mensaje parecido a “230 USUARIO conectado”, siendo

USUARIO su ID de usuario de AS/400.

6. Especifique la modalidad de transferencia binaria. En el indicador del DOS, escriba:

bin

Aparecerá el mensaje: “200 El tipo de representación es IMAGEN binaria”. 7. Navegue al directorio jt400 del AS/400. Escriba:

cd /QIBM/ProdData/HTTP/Public/jt400/lib y pulse la tecla Intro.

Nota:si ha movido el archivo jt400.zip o si ha modificado la estructura de este directorio desde que instaló AS/400 Toolbox para Java, especifique la nueva ubicación de jt400.zip.

Aparecerá el mensaje: “250 ”/QIBM/ProdData/HTTP/Public/jt400/lib“ es el directorio actual”.

8. Obtenga el archivo jt400. Escriba: mget jt400.zip

Aparecerá la solicitud “mget jt400.zip?”. Escriba y; después pulse la tecla Intro.

Aparecerán los mensajes “200 PORT petición de submandato satisfactoria” y “150 Recuperando archivo /QIBM/ProdData/HTTP/Public/jt400/lib/jt400.zip”. Al cabo de un momento, verá el mensaje “250 Transferencia de archivo completada satisfactoriamente” y luego otro parecido a “xxxxxx bytes

recibidos en 22,08 segundos (179,57 Kbytes/seg)”. Estos dos mensajes indican que FTP se ha completado satisfactoriamente.

9. Finalice la sesión de FTP. Escriba: quit

10. Finalice la sesión de MS-DOS. Escriba exit y pulse la tecla Intro.

Crear un directorio en la estación de trabajo

Para crear un directorio en la estación de trabajo, siga estos pasos.

1. Es probable que el indicador de MS-DOS indique C:\Windows>, siendo C: la unidad en la que se ha instalado Windows.

Si esta es la unidad en la que desea que esté AS/400 Toolbox para Java, escriba cd\y pulse la tecla Intro.

Si prefiere que AS/400 Toolbox para Java esté en otra unidad (si dispone de ella), escriba X:, siendo X: la letra de la unidad que desea, y pulse la tecla Intro.

2. Cree un directorio nuevo. Escriba: mkdir jt400

siendo jt400 el nombre del directorio.

(24)

Nota:para evitar confusiones, utilice jt400 como nombre de su directorio. Es el nombre del directorio AS/400 que contiene los archivos de AS/400 Toolbox para Java.

3. Cambie de directorio para que el nuevo directorio sea el actual. Escriba: cd jt400

El indicador pasa de ser X:\> a ser X:\jt400> (siendo X: la letra de la unidad de disco duro). El directorio se ha creado satisfactoriamente.

Vuelva a la página anterior y continúe en el paso 3.

Establecer las variables de entorno PATH y CLASSPATH

Para compilar una aplicación Java que incluya las clases de AS/400 Toolbox para Java y de Swing, tendrá que escribir en el indicador de MS-DOS un mandato parecido al siguiente (si utiliza JDK 1.2.2):

C:\jdk1.2.2\bin\javac -classpath .;C:\jt400\lib\jt400.zip miarchivo.java

Escribir mandatos de esta longitud puede ser tedioso y causa de que se produzcan errores. Por lo tanto, convendrá establecer las variables de entorno PATH y

CLASSPATH de la estación de trabajo para simplificar los mandatos Java. En este ejemplo, C:\jdk1.2.2\bin\javac indica al sistema dónde ha de buscar el compilador Java. Si se establece la variable PATH para que señale al directorio de los programas de utilidad de JDK, que es C:\jdk1.2.2\bin, bastaría con escribir el nombre del programa de utilidad. En este caso, se escribiría javac.

Las variables CLASSPATH indican al compilador Java y a la unidad ejecutable Java dónde han de buscar las bibliotecas de clases (que son los archivos jt400.zip o jt400.jar de AS/400 Toolbox para Java). Habiendo establecido CLASSPATH, no es preciso que utilice el parámetro -classpath en los mandatos; el compilador y la unidad ejecutable buscarán automáticamente las bibliotecas de clases.

Así que, una vez establecidas las variables PATH y CLASSPATH, aquel mandato tan largo pasaría a ser:

javac miarchivo.java

En las plataformas Win32, hay dos formas diferenciadas de establecer las variables de entorno. En Windows 95 y 98, para establecer los valores de PATH y

CLASSPATH se edita el archivo AUTOEXEC.BAT. En cambio, Windows NT ofrece una ventana de diálogo para entrar los valores.

Para establecer las variables de entorno de programación, pulse el sistema operativo de la estación de trabajo:

v Windows NT v Windows 95/98

(25)

Establecer las variables de entorno PATH y CLASSPATH

(Windows NT)

Para configurar las variables de entorno de estación de trabajo para Java, siga estos pasos:

1. Abrir los valores de entorno del sistema NT: a. Pulse dos veces el icono Mi PC del escritorio.

b. Pulse dos veces el icono Panel de control de la carpeta Mi PC. c. Pulse dos veces el icono Sistema de la carpeta Panel de control. d. Pulse la pestaña Entorno de la ventana Propiedades del sistema.

2. Actualizar la sentencia PATH de JDK.

3. Actualizar la sentencia CLASSPATH de AS/400 Toolbox para Java: v Si ha correlacionado una unidad de red con el AS/400

v Si ha copiado el archivo jt400.zip en la estación de trabajo

4. Cuando haya terminado de actualizar los valores de entorno del sistema, pulse el botón Aplicar. Ahora entrarán en vigor los nuevos valores.

5. Pulse el botón Aceptar para salir de la ventana Propiedades del sistema.

(26)

Actualizar la sentencia PATH de JDK (Win NT)

Añada a la sentencia PATH referencias a JDK; esta sentencia se encuentra en el panel Entorno de la ventana Propiedades del sistema:

1. En la ventana Variable del sistema, localice la variable Path y púlsela. Observe que la variable y su valor aparecen en los dos campos de texto situados en la parte inferior de la pantalla.

2. Al final del texto del campo Valor, añada: ;X:\JDK1.2.Y\BIN

donde X es la unidad en la que se ha instalado JDK e Y es el número de la versión de JDK 1.2 instalada.

Así se establece la variable PATH para que señale al directorio de los programas de utilidad Java. Cuando ejecute un mandato Java (por ejemplo, java o javac) desde un indicador de MS-DOS, el sistema localizará

automáticamente el programa de utilidad invocado por el mandato.

En el ejemplo que figura más abajo, JDK 1.2.2 se ha instalado en la unidad C:. El texto de color marrón muestra lo que se ha añadido al valor de Path.

(27)

Pulse el botón Establecer. Los campos de texto Variable y Valor se borran, y el valor nuevo se añade a las variables del sistema.

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para

Java (unidad correlacionada de Win NT)

Añada a la sentencia CLASSPATH referencias a AS/400 Toolbox para Java; esta sentencia se encuentra en el panel Entorno de la ventana Propiedades del sistema. En la estación de trabajo puede utilizar uno de estos dos archivos: jt400.zip o jt400.jar. Las instrucciones que siguen son para el archivo jt400.zip, pero son aplicables igualmente al archivo jt400.jar.

1. Vea si en el campo de texto Variable pone ClassPath (vía de acceso de clases). Si no es así, pulse ClassPath en la ventana Variable del sistema.

2. Al final del campo Valor, escriba:

;X:\QIBM\ProdData\HTTP\Public\jt400\lib\jt400.zip

siendo X: el nombre de la unidad correlacionada con el AS/400. Así la variable CLASSPATH de la estación de trabajo se establece en la biblioteca de clases de AS/400 Toolbox para Java, que es jt400.zip. Cuando

(28)

compile o ejecute una aplicación Java que contenga clases de AS/400 Toolbox para Java, el sistema localizará automáticamente el archivo jt400.zip.

En el ejemplo que figura más abajo, la unidad X: se ha correlacionado con un AS/400. El texto de color marrón muestra lo que se ha añadido al campo Valor de CLASSPATH.

Si no puede localizar un valor de ClassPath, añádalo. a. En el campo Variable, escriba:

ClassPath

b. En el campo Valor, escriba:

.;X:\QIBM\ProdData\HTTP\Public\jt400\lib\jt400.zip siendo X el nombre de la unidad correlacionada con el AS/400.

3. Pulse el botón Establecer. Los campos Variable y Valor se borran, y los valores nuevos aparecen en la ventana Variable del sistema.

(29)

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para

Java (archivo copiado de Win NT)

Añada a la sentencia CLASSPATH referencias a AS/400 Toolbox para Java; esta sentencia se encuentra en el panel Entorno de la ventana Propiedades del sistema. En la estación de trabajo puede utilizar uno de estos dos archivos: jt400.zip o jt400.jar. Las instrucciones que siguen son para el archivo jt400.zip, pero son aplicables igualmente al archivo jt400.jar.

Nota:la variable de entorno CLASSPATH se debe establecer de tal manera que refleje dónde se ha copiado el archivo jt400.zip. Si no está seguro de la ubicación, haga una búsqueda. Pulse el botón Inicio de la barra de tareas de Windows NT. Vaya a Buscar y después a Archivos o carpetas...; escriba: jt400.zip y pulse Intro. Establezca la variable CLASSPATH según la ubicación del archivo, siguiendo las instrucciones que figuran más abajo y que le servirán de guía.

1. Vea si en el campo de texto Variable pone ClassPath (vía de acceso de clases). Si no es así, pulse ClassPath en la ventana Variable del sistema.

2. Al final del campo Valor, escriba: ;X:\jt400\jt400.zip

donde X: es la unidad en la que ha copiado el archivo jt400.zip y jt400 es el nombre del directorio en el que ha guardado la copia de jt400.zip.

Así la variable CLASSPATH de la estación de trabajo se establece en la biblioteca de clases de AS/400 Toolbox para Java, que es jt400.zip. Cuando compile o ejecute una aplicación Java que contenga clases de AS/400 Toolbox para Java, el sistema localizará automáticamente el archivo jt400.zip.

En el ejemplo que figura más abajo, se ha copiado el archivo jt400.zip en un directorio (JT400) de la unidad C:. El texto de color marrón muestra lo que se ha añadido al campo Valor de CLASSPATH.

(30)

Si no puede localizar un valor de ClassPath, añádalo. a. En el campo Variable, escriba:

ClassPath

b. En el campo Valor, escriba: .;X:\jt400\jt400.zip

donde X es la unidad en la que ha copiado el archivo jt400.zip y jt400 es el nombre del directorio en el que ha guardado la copia de jt400.zip.

3. Pulse el botón Establecer. Los campos Variable y Valor se borran, y los valores nuevos aparecen en la ventana Variable del sistema.

Establecer las variables de entorno PATH y CLASSPATH (Windows 95

ó 98)

Para configurar las variables de entorno de estación de trabajo para Java, siga estos pasos:

1. Abrir el archivo AUTOEXEC.BAT para editarlo. AUTOEXEC.BAT contiene los valores de las variables de entorno de la estación de trabajo.

(31)

2. Actualizar la sentencia PATH de JDK.

3. Actualizar la sentencia CLASSPATH de AS/400 Toolbox para Java: v Si ha correlacionado una unidad de red con el AS/400

v Si ha copiado el archivo jt400.zip en la estación de trabajo

4. El archivo AUTOEXEC.BAT establece las variables de entorno en el momento del inicio. Puede utilizar uno de los distintos procedimientos que hay para restablecer las variables de entorno durante una sesión. Conviene rearrancar la estación de trabajo.

Abrir AUTOEXEC.BAT

El archivo AUTOEXEC.BAT de la estación de trabajo contiene las variables de entorno de programación. Al arrancar la estación de trabajo, el archivo AUTOEXEC.BAT establece el entorno de la estación de trabajo.

Para abrir el archivo AUTOEXEC.BAT de la estación de trabajo, siga estos pasos: 1. Pulse el botón Inicio situado en el ángulo inferior izquierdo del escritorio. 2. Sitúe el ratón sobre Buscar... Seleccione Archivos o carpetas en el menú Buscar. 3. En el campo Nombre, teclee autoexec.bat. En el campo Buscar en, seleccione la

unidad en la que se encuentra Windows 95. Pulse el botón Buscar ahora. 4. En la ventana inferior, pulse Autoexec.bat con el botón derecho del ratón.

Nota:puede ser que encuentre más de un archivo Autoexec.bat. Es muy probable que la primera instancia sea la adecuada. Haga caso omiso de las apariciones que se encuentren en la estructura del directorio de copia de seguridad.

5. Seleccione Editar en el menú emergente. Si le piden que elija un programa, seleccione Bloc de notas.

Actualizar la sentencia PATH de JDK (Win 95/98)

Para añadir los programas de utilidad de JDK al entorno de programación de la estación de trabajo, siga estos pasos:

1. En una nueva línea del archivo AUTOEXEC.BAT, cerca del principio del archivo, escriba:

SET JDK=X:\JDK1.2.Y

donde X: es el nombre de la unidad en la que está instalado JDK e Y es la versión instalada de JDK.

Así se establece la variable JDK con la vía de acceso al directorio de JDK. Si más adelante instala otro JDK, tan solo necesita cambiar esta línea para cambiar las variables PATH y CLASSPATH del nuevo JDK.

2. Al final de la línea SET PATH, escriba: ;%JDK%\BIN

Así se establece la variable PATH para que señale al directorio de los programas de utilidad Java. Cuando ejecute un mandato Java (por ejemplo,

(32)

java o javac) desde un indicador de MS-DOS, el sistema localizará automáticamente el programa de utilidad invocado por el mandato. El ejemplo que figura más abajo muestra, en color marrón, un archivo AUTOEXEC.BAT modificado que ahora incluye un JDK en las variables de entorno. El texto de color negro muestra qué decía el archivo AUTOEXEC.BAT original. En el ejemplo, JDK 1.2.2 se ha instalado en la unidad C:. La

configuración de la estación de trabajo puede variar en función de la versión de JDK y de la unidad en la que se haya instalado.

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para

Java (unidad correlacionada de Win 95/98)

Para añadir el archivo de clase de AS/400 Toolbox para Java al entorno de programación de la estación de trabajo, siga estos pasos:

1. En una línea del archivo AUTOEXEC.BAT, escriba: SET JT400=X:\QIBM\ProdData\HTTP\Public\jt400

siendo X: el nombre de la unidad correlacionada con el AS/400.

Así se establece la variable JT400 con la vía de acceso al directorio de AS/400 Toolbox para Java. Debido a que el nombre de vía del directorio jt400 es bastante largo, la variable JT400 actuará a modo de procedimiento taquigráfico para escribir la vía.

2. En una nueva línea, escriba:

SET CLASSPATH=.;%JT400%\lib\jt400.zip

Nota:el punto (.) de la sentencia CLASSPATH especifica el directorio actual. Con este valor, no es necesario que especifique el nombre completo de la vía (que consta de la unidad y de la estructura del directorio) de la aplicación Java para compilarla o ejecutarla.

(33)

El ejemplo que figura más abajo muestra, en color marrón, un archivo

AUTOEXEC.BAT modificado que ahora incluye AS/400 Toolbox para Java (que reside en el AS/400) en las variables de entorno. La unidad X: se ha correlacionado con el sistema AS/400.

Actualizar la sentencia CLASSPATH de AS/400 Toolbox para

Java (Win 95/98)

Para añadir el archivo de clase de AS/400 Toolbox para Java al entorno de programación de la estación de trabajo, siga estos pasos:

1. En una nueva línea del archivo AUTOEXEC.BAT, debajo de la línea SET JDK, escriba:

SET JT400=X:\jt400

donde X: es la unidad y jt400 es el directorio en el que reside el archivo jt400.zip de AS/400 Toolbox para Java.

Así se establece la variable JT400 con la vía de acceso al directorio de AS/400 Toolbox para Java. Si más adelante decide mover el archivo jt400.zip o

correlacionar una unidad de red con la copia de jt400.zip del AS/400, tan solo tendrá que cambiar esta línea cuando vaya a cambiar las variables CLASSPATH de AS/400 Toolbox para Java.

2. En una nueva línea, escriba:

SET CLASSPATH=.;%JT400%\jt400.zip

(34)

Nota:el punto (.) de la sentencia CLASSPATH especifica el directorio actual. Con este valor, no es necesario que especifique el nombre completo de la vía (que consta de la unidad y de la estructura del directorio) de la aplicación Java para compilarla o ejecutarla.

El ejemplo que figura más abajo muestra, en color marrón, un archivo

AUTOEXEC.BAT modificado que ahora incluye AS/400 Toolbox para Java en las variables de entorno. En este ejemplo, AS/400 Toolbox para Java se ha instalado en la unidad C:.

Instalar el producto IDE

Si no ha programado con un IDE, sería conveniente que probase uno. Los IDE son aplicaciones de PC que tienen incorporado un sofisticado entorno de programación que, en general, incluye programas de utilidad de compilación y depuración. Muchos IDE permiten generar gráficamente el código; es decir, unas pocas pulsaciones del ratón son suficientes para generar código fuente con rapidez. Puede adquirir cualquiera de los diversos IDE específicos de Java, que ya suelen llevar integrado en el producto un JDK (Java Development Kit). Estos enlaces le permiten ir a algunos IDE conocidos y disponibles en este momento:

v IBM Visual Age para Java para AS/400. v Borland JBuilder 3

v Sybase PowerJ v Symantec Visual Café v NetBeans Developer

(35)

v Metrowerks CodeWarrior Professional .

Si ha pensado que va a utilizar un entorno de desarrollo integrado (IDE), ha llegado el momento de instalarlo. En las instrucciones suministradas junto con el producto encontrará información sobre la configuración. Sin embargo, si no tiene los recursos necesarios para un IDE, siempre podrá programar con un editor basado en texto y el indicador del DOS.

(36)

(37)

Capítulo 5. Crear una aplicación Java

Utilice uno de los diversos procedimientos que hay para crear una aplicación Java en la estación de trabajo. Puede elegir el método que prefiera, siempre y cuando se ejecute el código.

Este ejemplo muestra uno de los procedimientos más básicos para crear una aplicación Java; consiste en utilizar el Bloc de notas de Windows, la herramienta JDK, el indicador de MS-DOS y AS/400 Toolbox para Java. Aunque tenga previsto desarrollar el código Java de forma más sofisticada, conviene que siga el desarrollo de este ejemplo para apreciar algunas de las reglas generales de la creación de aplicaciones Java.

Nota:si está utilizando una aplicación de programación integrada (como VisualAge para Java de IBM o JBuilder de Borland), siga las instrucciones suministradas junto con el producto para crear una aplicación Java.

Para crear una aplicación Java, siga estos pasos: 1. Escribir una aplicación Java.

2. Compilar la aplicación. 3. Ejecutar la aplicación.

Ejemplos de cliente/servidor e interfaces gráficas

Acceder a los datos mediante una interfaz gráfica tiene su importancia. Si desea ver algunos de los procedimientos de Java para lograrlo, siga los enlaces que figuran a continuación.

Ejemplo de aplicaciones de base de datos

Crear interfaces gráficas de usuario (GUI). La Caja de Herramientas Gráfica, que es una herramienta de edición visual, utiliza AS/400 Toolbox para Java.

AS/400 Toolbox para Java - Clases de GUI. AS/400 Toolbox para Java proporciona un conjunto de clases que son interfaces gráficas de usuario (GUI).

Escribir una aplicación Java

Para escribir una aplicación Java para la estación de trabajo, siga estos pasos: 1. Abra una sesión de MS-DOS.

2. En el indicador del DOS, escriba: notepad

y pulse la tecla Intro. Así se abrirá una sesión de Bloc de notas. 3. Teclee la aplicación Java en la ventana Bloc de notas.

(38)

Nota:al denominar las aplicaciones Java, recuerde sin falta que el nombre del archivo debe coincidir con el nombre de la clase. También debe haber coherencia entre las mayúsculas y las minúsculas. Java es sensible a las mayúsculas y minúsculas. Si, por el contrario, desea utilizar un ejemplo de código Java, consulte el ejemplo de llamada a mandato

(CommandCallExample) de AS/400 Toolbox para Java. Copie la aplicación CommandCallExample en la ventana Bloc de notas.

4. Para guardar la aplicación, pulse el menú Archivo y luego Guardar como... En la pantalla Guardar como..., navegue al directorio en el que desea guardar la aplicación Java. Escriba el nombre de la aplicación Java en el espacio en blanco que hay junto a Nombre de archivo:. En la ventana Guardar como tipo: debe verse la opción Todos los archivos (*.*).

5. Pulse el botón Guardar.

AS/400 Toolbox para Java - Ejemplo de CommandCall

////////////////////////////////////////////////////////////////////////////////// //

// Ejemplo de llamada a programa. Este programa solicita al usuario // el nombre del AS/400 y el mandato que se ha de ejecutar. A // continuación, imprime el resultado del mandato.

//

////////////////////////////////////////////////////////////////////////////////// //

// Este código fuente es un ejemplo de “CommandCall” de AS/400 Toolbox para Java. // IBM le concede una licencia no exclusiva de uso de este fuente como ejemplo // a partir del cual puede generar funciones similares adaptadas a sus propias // necesidades particulares.

//

// IBM suministra este código fuente solo a efectos ilustrativos. // Estos ejemplos no se han comprobado de forma exhaustiva en todas las // condiciones. Por lo tanto, IBM no puede garantizar ni dar por sentada // la fiabilidad, la utilidad ni el funcionamiento de estos programas. //

(39)

// las garantías implícitas de ser apto para el comercio y adecuado // para un fin particular.

//

// AS/400 Toolbox para Java // (C) Copyright IBM Corp. 1997 // Se reservan todos los derechos.

// Derechos restringidos de los usuarios del Gobierno de Estados Unidos -// El uso, la duplicación o la divulgación están sujetos a las restricciones // establecidas en el GSA ADP Schedule Contract con IBM Corp.

//

////////////////////////////////////////////////////////////////////////////////// import java.io.*;

import java.util.*;

import com.ibm.as400.access.*;

public class CommandCallExample extends Object {

public static void main(String[] parmeters) {

// Se ha creado un lector para obtener entrada del usuario.

BufferedReader inputStream = new BufferedReader(new InputStreamReader(System.in),1); // Declare variables para contener el nombre del sistema y el mandato

// que se ha de ejecutar. String systemString = null; String commandString = null;

System.out.println( “ ” );

// Obtenga del usuario el nombre del sistema y el mandato que se ha de ejecutar. try

{

System.out.print(“Nombre del sistema: ”); systemString = inputStream.readLine(); System.out.print(“Mandato: ”); commandString = inputStream.readLine(); } catch (Exception e) {}; System.out.println( “ ” );

// Cree un objeto AS400. Representa el sistema al que enviamos el mandato. AS400 as400 = new AS400(systemString);

// Cree un objeto llamada a mandato que especifique el sistema AS/400 // que recibirá el mandato.

CommandCall command = new CommandCall( as400 ); try

{

// Ejecute el mandato.

if (command.run(commandString))

System.out.print( “El mandato ha sido satisfactorio” ); else

System.out.print( “El mandato ha fallado” ); // Si el mandato ha producido mensajes, imprímalos. AS400Message[] messagelist = command.getMessageList(); if (messagelist.length > 0)

{

System.out.println( “, mensajes del mandato:” ); System.out.println( “ ” );

}

for (int i=0; i < messagelist.length; i++) { System.out.print ( messagelist[i].getID() ); System.out.print ( “: ” ); System.out.println( messagelist[i].getText() ); } } catch (Exception e) {

System.out.println( “El mandato ” + command.getCommand() + “ no se ha ejecutado” );

(40)

}

System.exit(0); }

}

Denominar la aplicación Java

Cuando vaya a dar un nombre a la aplicación Java, no olvide utilizar el convenio de denominación adecuado: dé a la aplicación el mismo nombre que el de la clase que está creando.

Por ejemplo, la aplicación Java que figura más abajo crea la clase CommandCallExample.

Fíjese en la barra de título del ejemplo y verá que tiene el nombre CommandCallExample.java.

Compilar la aplicación Java

Para compilar la aplicación Java que ha escrito, siga estos pasos: 1. Abra un indicador de MS-DOS.

2. Navegue al directorio en el que ha guardado la aplicación Java. 3. En el indicador, escriba:

javacMiClase.java

siendo MiClase el nombre de la clase.

Nota:para compilar el ejemplo de código llamado CommandCallExample, escriba javac

CommandCallExample.java

Java es sensible a las mayúsculas y minúsculas. Aunque Windows no lo sea, el mandato

javacno puede compilar el código a menos que haya coherencia entre las mayúsculas y las minúsculas.

La barra de título de la ventana MS-DOS cambia, pasando de ser Indicador de MS-DOSa ser JAVAC.

4. Cuando la barra de título vuelva a ser Indicador de MS-DOS y aparezca un indicador, es que la aplicación Java se habrá compilado sin problemas.

(41)

Nota:la aplicación Java compilada se guarda en el mismo directorio que el archivo de código fuente. Si el archivo de código fuente se llama MiClase.java, la aplicación compilada se llamará MiClase.class.

Ejecutar la aplicación Java

Para ejecutar la aplicación Java que ha escrito y compilado, siga estos pasos: 1. Abra un indicador de MS-DOS.

2. Navegue al directorio en el que ha guardado la aplicación Java compilada. 3. En el indicador, escriba:

javaMiClase

siendo MiClase el nombre de la clase compilada. Pulse la tecla Intro.

Nota:si ha compilado el ejemplo de código llamado CommandCallExample y desea ejecutarlo, escriba java CommandCallExample. En Ejecutar el ejemplo

CommandCallExample encontrará más información sobre cómo puede ejecutar esta aplicación Java.

La barra de título de la ventana MS-DOS cambia, pasando de ser Indicador de MS-DOSa ser JAVA.

La aplicación Java se ejecutará.

4. Una vez terminada la aplicación Java, aparece un indicador de MS-DOS, y la barra de título de la ventana MS-DOS vuelve a ser Indicador de MS-DOS.

Ejecutar el ejemplo CommandCallExample

Para ejecutar el ejemplo de llamada a mandato (CommandCallExample) compilado, siga estos pasos:

1. Abra un indicador de MS-DOS.

2. Navegue al directorio que contiene CommandCallExample.class.

Nota:es el directorio en el que ha guardado el archivo CommandCallExample.java.

3. En el indicador, escriba: java CommandCallExample y pulse la tecla Intro.

Observe que la barra de título de la ventana del indicador de MS-DOS pasa a ser JAVA.

4. Le pedirán que entre el nombre del sistema AS/400. Escriba el nombre del sistema y pulse la tecla Intro.

(42)

5. Le pedirán que entre un mandato CL que deba ejecutarse en el sistema AS/400. Escriba cualquier mandato; por ejemplo, CHGCURLIB CURLIB(QSYS). Este mandato hará que la biblioteca actual del sistema AS/400 pase a ser la biblioteca QSYS.

6. Aparece la ventana Inicio de sesión AS/400. Escriba el nombre de perfil de usuario de AS/400 en el espacio en blanco que hay junto a ID usuario. Escriba la contraseña del perfil en el espacio en blanco que hay junto a Contraseña. Pulse Aceptar.

La ventana de inicio de sesión desaparecerá.

7. Después de ejecutarse el mandato, el programa Java visualiza un mensaje sobre el resultado del mandato. Por ejemplo, cuando ejecutamos CHGCURLIB CURLIB(QSYS), obtuvimos el siguiente mensaje:

Mandato satisfactorio, mensajes del mandato: CPC2198: Biblioteca actual cambiada por QSYS.

8. Una vez ejecutado satisfactoriamente el programa, aparece el indicador de MS-DOS y la barra de título de la ventana pasa a ser Indicador de MS-DOS.

Ejemplos: interacción de la base de datos con Java

Los siguientes ejemplos muestran cómo el lenguaje Java se puede utilizar en casi todas partes. Copie, compile y ejecute el código para constatar qué fácil es

interaccionar con el AS/400.

Ejemplo: Consultar una tabla de ejemplo y enviar su contenido a la salida (sin GUI).

Ejemplo: Consultar una tabla de ejemplo mediante una interfaz gráfica de usuario (GUI).

(43)

Podrá aprender más cosas sobre las aplicaciones de base de datos de

cliente/servidor y Java en la documentación de AS/400 Toolbox para Java - JDBC.

Ejemplo: interacción de base de datos de AS/400 mediante

JDBC

////////////////////////////////////////////////////////////////////////////////// //

// Ejemplo JDBCQuery. Este programa utiliza el controlador JDBC de AS/400 para // consultar una tabla y enviar su contenido a la salida.

//

// Sintaxis del mandato:

// JDBCQuery system collectionName tableName //

// Por ejemplo:

// JDBCQuery MiSistema qiws qcustcdt //

////////////////////////////////////////////////////////////////////////////////// //

// Este fuente es un ejemplo del controlador JDBC de AS/400 Toolbox para Java. // IBM le concede una licencia no exclusiva de uso de este fuente como ejemplo // a partir del cual puede generar funciones similares adaptadas a sus propias // necesidades particulares.

//

// IBM suministra este código fuente solo a efectos ilustrativos. // Estos ejemplos no se han comprobado de forma exhaustiva en todas las // condiciones. Por lo tanto, IBM no puede garantizar ni dar por sentada // la fiabilidad, la utilidad ni el funcionamiento de estos programas. //

// Todos los programas contenidos aquí se proporcionan "TAL CUAL" // sin garantía de ninguna clase. Se renuncia explícitamente a todas // las garantías implícitas de ser apto para el comercio y adecuado // para un fin particular.

//

// AS/400 Toolbox para Java // (C) Copyright IBM Corp. 1997 // Se reservan todos los derechos.

// Derechos restringidos de los usuarios del Gobierno de Estados Unidos -// El uso, la duplicación o la divulgación están sujetos a las restricciones // establecidas en el GSA ADP Schedule Contract con IBM Corp.

//

////////////////////////////////////////////////////////////////////////////////// import java.sql.*;

public class JDBCQuery {

// Dé formato a una serie (String) para que tenga la anchura especificada. private static String format (String s, int width)

{

String formattedString;

// La serie es más corta que la anchura especificada, // por lo que tenemos que rellenarla con blancos. if (s.length() < width) {

StringBuffer buffer = new StringBuffer (s); for (int i = s.length(); i < width; ++i)

buffer.append (" ");

formattedString = buffer.toString(); }

// En el caso contrario, tendremos que truncar la serie. else

formattedString = s.substring (0, width);

(44)

return formattedString; }

public static void main (String[] parameters) {

// Compruebe los parámetros de entrada. if (parameters.length != 3) {

System.out.println("");

System.out.println("Utilización:"); System.out.println("");

System.out.println(" JDBCQuery system collectionName tableName"); System.out.println("");

System.out.println("Por ejemplo:"); System.out.println("");

System.out.println(" JDBCQuery miSistema qiws qcustcdt"); System.out.println("");

return; }

String system = parameters[0]; String collectionName = parameters[1]; String tableName = parameters[2]; Connection connection = null;

try {

// Cargue el controlador JDBC de AS/400 Toolbox para Java.

DriverManager.registerDriver(new com.ibm.as400.access.AS400JDBCDriver()); // Obtenga una conexión con la base de datos. Debido a que no

// proporcionamos un ID de usuario ni una contraseña, aparecerá una solicitud. connection = DriverManager.getConnection ("jdbc:as400://" + system);

DatabaseMetaData dmd = connection.getMetaData (); // Ejecute la consulta.

Statement select = connection.createStatement (); ResultSet rs = select.executeQuery ("SELECT * FROM "

+ collectionName + dmd.getCatalogSeparator() + tableName);

// Obtenga información sobre el conjunto de resultados. Establezca que la anchura // de la columna sea la longitud mayor de las dos: la longitud de la etiqueta // o la longitud de los datos.

ResultSetMetaData rsmd = rs.getMetaData (); int columnCount = rsmd.getColumnCount (); String[] columnLabels = new String[columnCount]; int[] columnWidths = new int[columnCount]; for (int i = 1; i <= columnCount; ++i) {

columnLabels[i-1] = rsmd.getColumnLabel (i);

columnWidths[i-1] = Math.max (columnLabels[i-1].length(), rsmd.getColumnDisplaySize (i));

}

// Envíe a la salida las cabeceras de columna. for (int i = 1; i <= columnCount; ++i) {

System.out.print (format (rsmd.getColumnLabel(i), columnWidths[i-1])); System.out.print (" ");

}

System.out.println ();

// Envíe a la salida una línea de guiones. StringBuffer dashedLine;

for (int i = 1; i <= columnCount; ++i) {

for (int j = 1; j <= columnWidths[i-1]; ++j) System.out.print ("-");

System.out.print (" "); }

System.out.println ();

// Itere a través de las filas del conjunto de resultados y envíe a la // salida las columnas que hay en cada fila.

while (rs.next ()) {

for (int i = 1; i <= columnCount; ++i) { String value = rs.getString (i); if (rs.wasNull ())

(45)

System.out.print (format (value, columnWidths[i-1])); System.out.print (" "); } System.out.println (); } } catch (Exception e) { System.out.println ();

System.out.println ("ERROR: " + e.getMessage()); } finally { // Borre. try { if (connection != null) connection.close (); } catch (SQLException e) { // Hacer caso omiso. }

}

System.exit(0); }

}

Ejemplo: interacción de GUI con la base de datos de AS/400

Este ejemplo crea una GUI simple, que permite recoger datos de entrada, y una tabla de base de datos para presentar los datos de salida. La entrada (que es un apellido) se compara con el esquema ″LSTNAM″ (es decir, el APELLIDO) de la tabla de ejemplo llamada″qcustcdt″. Las coincidencias (es decir, las tuplas coincidentes) que se hallen se envían a la salida.

Para ejecutar este programa, siga estos pasos:

1. Copie el código que figura más abajo y guarde el archivo como GUIData.java. 2. Compile el código; escriba: javac GUIData.java.

3. Ejecute el programa; escriba: java GUIData misistema, siendo misistema el nombre del AS/400.

4. Debido a que la tabla es muy pequeña, escriba″Jones″ o ″Stevens″ (dos nombres de la tabla) cuando se lo indiquen.

Para este programa se necesita Java 2 (JDK 1.2 y Swing 1.1). Para entrar en materia, lea sin falta la guía Configuración de Java en cliente/servidor.

////////////////////////////////////////////////////////////////////////////////// //

// Este programa utiliza el controlador JDBC de AS/400 para // consultar una tabla y enviar su contenido a la salida. Se // emplean las clases de Swing para crear los componentes de GUI. //

// Sintaxis del mandato: // GUIData system //

// Este programa utiliza "qiws" como nombre de colección (collectionName) // y "qcustcdt" como nombre de tabla (tableName).

//

////////////////////////////////////////////////////////////////////////////////// //

// IBM suministra este código fuente solo a efectos ilustrativos. // Estos ejemplos no se han comprobado de forma exhaustiva en todas las

(46)

// condiciones. Por lo tanto, IBM no puede garantizar ni dar por sentada // la fiabilidad, la utilidad ni el funcionamiento de estos programas. //

// Todos los programas contenidos aquí se proporcionan "TAL CUAL" // sin garantía de ninguna clase. Se renuncia explícitamente a todas // las garantías implícitas de ser apto para el comercio y adecuado // para un fin particular.

// ////////////////////////////////////////////////////////////////////////////////// import com.ibm.as400.access.*; import com.ibm.as400.vaccess.*; import javax.swing.*; import java.awt.*; import java.awt.event.*; import java.sql.*; public class GUIData {

public static void main (String[] parameters) {

if (parameters.length != 1) {

System.out.println("Utilización: GUIData system"); return;

} try {

DriverManager.registerDriver (new AS400JDBCDriver ());

final SQLConnection connection = new SQLConnection ("jdbc:as400://" + parameters[0]); final SQLResultSetTablePane tablePane = new SQLResultSetTablePane();

tablePane.setConnection(connection);

final JFrame g = new JFrame("Ejemplo de JDBC cliente/servidor");

JTextField instructions = new JTextField ("Teclee un apellido (Ejemplo: 'Jones' o 'Stevens') y instructions.setEditable(false);

final JTextField text_field = new JTextField(20); text_field.addActionListener(new ActionListener()

{

public void actionPerformed(ActionEvent event) {

try {

String query = text_field.getText();

String lname = "SELECT * FROM QIWS.QCUSTCDT WHERE LSTNAM= ( tablePane.setQuery(lname); tablePane.load(); } catch(Exception e) { System.out.println("Error: "+e.getMessage()); } } }); JPanel top = new JPanel();

top.setLayout(new GridLayout(2, 1)); top.add(instructions); top.add(text_field); g.getContentPane().setLayout(new BorderLayout()); g.getContentPane().add("North", top); g.getContentPane().add("Center", tablePane); tablePane.addErrorListener(new ErrorDialogAdapter(g)); g.addWindowListener (new WindowAdapter ()

{

public void windowClosing (WindowEvent event) {

try {

(47)

} catch(Exception e) {} System.exit(0); } }); g.pack(); g.show(); } catch (Exception e) {

System.out.println ("Error: " + e.getMessage ()); System.exit(0);

} } }

(48)