Si desea ejecutar la aplicación Java en un sistema principal que no tiene una interfaz gráfica de usuario (GUI), como por ejemplo un sistema AS/400, puede utilizar Abstract Window Toolkit (AWT) remoto o Class Broker para Java (CBJ).
AWT remoto se utiliza con las interfaces de instalación y administración de las aplicaciones de servidor. Estas interfaces suelen tener un mínimo de gráficos complejos y un contenido altamente interactivo. AWT remoto distribuye los procesos AWT entre el AS/400 y una estación de trabajo. Así pues, el nivel de respuesta de las operaciones con muchos gráficos y un alto grado de interacción no es tan rápido como en las implementaciones de AWT en plataformas con
terminales gráficos conectados localmente. Para utilizar AWT remoto, consulte el apartado Configuración de AWT remoto.
Puede utilizar CBJ para servicios de GUI de alto rendimiento. Puesto que el AWT remoto no es aconsejable para operaciones con gráficos complejos o alta
interacción, puede utilizar CBJ en su lugar, diseñado para estos entornos. Para utilizar CBJ, consulte el apartado Configuración de CBJ.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Configurar AWT remoto para Java en una pantalla remota
Con AWT remoto se pueden ejecutar programas gráficos AWT Java en AS/400 sin efectuar cambios en AS/400 y visualizar los gráficos de forma remota. Para utilizar el AWT remoto debe tener el protocolo TCP/IP configurado y el JDK 1.1.x o Java 2 SDK (J2SDK), Standard Edition, versión 1.2. de Sun Microsystems, Inc. instalado en el AS/400 y en la pantalla remota.
Como pantalla remota de AWT remoto se puede utilizar cualquier dispositivo de hardware con funciones gráficas, incluido IBM Network Station, que cumpla los requisitos siguientes:
v El sistema operativo que utiliza es Windows 95, Windows NT 4.0, IBM Operating System/2 (OS/2), Sun Solaris o AIX
v Está configurado para acceder al AS/400 con TCP/IP
v Java Development Kit 1.1.x (es aconsejable JDK 1.1.7 o posterior) o J2SDK, versión 1.2.
Para configurar AWT remoto, realice las tareas siguientes:
1. Ponga los archivos de clase de AWT remoto a disposición de la pantalla remota; para ello, copie los archivos en la pantalla remota o correlacione la vía de acceso con una unidad de red de la pantalla remota.
2. Añada RAWTGui.zip o RAWTGui.jar a la CLASSPATH de la pantalla remotaPara JDK 1.1.x, añada el archivo RAWTGui.zip a la CLASSPATH de la pantalla remota estableciendo la variable de entorno CLASSPATH o utilizando
el parámetro -classpath del mandato java. Para J2SDK, versión 1.2, el archivo RAWTGui.jar se añade automáticamente a CLASSPATH al utilizar el parámetro -jardel mandato java.
3. Inicie AWT remoto en la pantalla remota.
Si desea obtener información más detallada y sugerencias sobre la utilización de AWT remoto, consulte los temas indicados a continuación:
v En el apartado Ejecutar un programa Java con AWT remoto se dan instrucciones para ejecutar un programa Java con AS/400 utilizando varios JSK y Netscape. v En Imprimir con AWT remoto se explica cómo imprimir, tarea que se realiza
igual que en el AWT Java estándar. También se enseña a imprimir en AS/400. v En el apartado Propiedades de AWT remoto se muestra cómo ejecutar una
aplicación de AWT remoto utilizando la propiedad os400.class.path.rawt. v En Restricciones de SecurityManager de AWT remoto se facilita información
sobre las restricciones en vigor cuando se ejecutan aplicaciones Java con AWT remoto bajo el control de SecurityManager.
Si desea obtener más información sobre la configuración de TCP/IP, consulte el capítulo “How do I set up TCP/IP” de la publicación 0S/400 TCP/IP
Configuration and Reference, SC41-5420.
En Ejemplo: configurar AWT remoto para Java en una pantalla remota hallará un ejemplo de la manera de configurar AWT remoto.
Si desea obtener más información sobre AWT, le remitimos a Abstract Window Toolkit de Sun Microsystems, Inc.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Ejemplo: configurar AWT remoto para Java en una pantalla
remota Windows
Este ejemplo muestra una manera de configurar AWT remoto en una pantalla remota Windows. Existen otras formas de hacerlo, en función de lo que prefiera. Puede utilizar un proceso parecido en otros sistemas operativos de pantalla remota. El proceso de configuración e inicio están automatizados por medio de un archivo “.bat” Windows o de cualquier otro recurso de programación que
proporcione el sistema operativo de la pantalla remota.
Para configurar AWT remoto para Java en una pantalla remota Windows, realice las tareas siguientes:
v Ponga los archivos de clase de AWT remoto a disposición de la pantalla remota. Copie los archivos de clase de AWT remoto en la pantalla remota. Copie
/QIBM/ProdData/Java400/jdk117/RAWTGui.zip en c:\rawt\RAWTGui.zip o /QIBM/ProdData/Java400/jdk12/RAWTGui.jar en c:\rawt2\RAWTGui.jar
v Inicie AWT remoto en la pantalla remota entrando lo siguiente en la línea de mandatos:
java -classpath c:\jdk1.1.7\lib\classes.zip;c:\rawt\RAWTGui.zip java com.ibm.rawt.server.RAWTPCServer
o
java -jar c:\rawt2\RAWTGui.jar
En Configurar AWT remoto para Java en una pantalla remota hallará más información.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Poner los archivos de clase de AWT remoto para Java a
disposición de la pantalla remota
Para poner los archivos de clase de AWT remoto a disposición de la pantalla remota, siga estos pasos para Java Development Kit (JDK) 1.1. x o para Java 2 SDK (J2SDK), Standard Edition, versión 1.2.
Si utiliza JDK 1.1.x, puede:
v Copiar los archivos de clase de AWT remoto en la pantalla remota.
Los archivos de AWT remoto se instalan con AS/400 Developer Kit para Java en dos archivos ZIP: /QIBM/ProdData/Java400/jdk1.1.x/RAWTApplHost.zip y /QIBM/ProdData/Java400/jdk1.1.x/RAWTGui.zip.
El archivo RAWTApplHost.zip contiene las clases de AWT remoto para AS/400. El archivo RAWTGui.zip contiene las clases de AWT remoto para la pantalla remota.
Copiar RAWTGui.zip desde /QIBM/ProdData/Java400/jdk1.1.x en la pantalla remota.
v Correlacionar la vía de acceso,
/QIBM/ProdData/Java400/jdk1.1.x/RAWTGui.zip, con una unidad de red de la pantalla remota.
Si utiliza J2SDK, versión 1.2, puede:
v Copiar los archivos de clase de AWT remoto en la pantalla remota.
Los archivos de AWT remoto se instalan con AS/400 Developer Kit para Java en dos archivos JAR: /QIBM/ProdData/Java400/jdk1.2/RAWTAHost.jar y
/QIBM/ProdData/Java400/jdk1.2/RAWTGui.jar
El archivo RAWTAHost.jar contiene las clases de AWT remoto para AS/400. El archivo RAWTGui.jar contiene las clases de AWT remoto para la pantalla remota.
Copiar RAWTGui.jar desde /QIBM/ProdData/Java400/jdk1.2 en una unidad de red de la pantalla remota.
v Correlacionar la vía de acceso, /QIBM/ProdData/Java400/jdk1.2/RAWTGui.jar, con una unidad de red de la pantalla remota.
[ Página de presentación de Information Center | Comentarios ]
Adición de RAWTGui.zip o RAWTGui.jar a la vía de acceso de
clases de la pantalla remota
Establecer la vía de acceso de clases permite que la máquina virtual Java de la pantalla remota encuentre las clases de AWT remoto. Para añadir el archivo RAWTGui.zip a la vía de acceso de clases de la pantalla remota, realice cualquiera de estos pasos:
v Establezca la variable de entorno CLASSPATH. Consulte la información de Java Development Kit (JDK) correspondiente a la pantalla remota para obtener detalles.
Añada la vía de acceso en la que se encuentra situado el archivo RAWTGui.zip a la variable de entorno CLASSPATH.
v Utilice el parámetro -classpath del mandato java.
Cuando se utiliza el mandato java para iniciar AWT remoto, se puede utilizar el parámetro -classpath para especificar una vía de acceso de clases. El parámetro CLASSPATH incluye la vía de acceso donde se encuentra el archivo
RAWTGui.zip.
Por ejemplo, en Windows, el parámetro de vía de acceso de clases puede ser así:
-classpath c:\jdk1.1.7\lib\classes.zip;c:\rawt\RAWTGui.zip
El soporte JAR de J2SDK, versión 1.2 establece la vía de acceso de clases, de modo que no es necesario establecer explícitamente el parámetro CLASSPATH. Para establecer la vía de acceso de clases e iniciar AWT remoto en una pantalla remota, especifique este mandato:
java -jar <VÍA_DE_ACCESO>RAWTGui.jar
donde <VÍA_DE_ACCESO> es la unidad y el directorio totalmente calificados donde se encuentra el archivo RAWTGui.jar. Por ejemplo, java -jar
c:\rawt2\RAWTGui.jar.
[ Página de presentación de Information Center | Comentarios ]
[Legal | Glosario de AS/400]
Iniciar AWT remoto para Java en un pantalla remota
Es necesario iniciar el daemon servidor en la pantalla remota una sola vez y permanecerá activo hasta que lo finalice. Los programas Java que salen a AS/400 no finalizan el servidor.
Nota:el diálogo Bienvenido permanece activo al iniciar el daemon servidor. Cuando se cierra el diálogo Bienvenido, finaliza el daemon servidor. Puede minimizar la pantalla del diálogo Bienvenido mientras el daemon servidor está activo y utilizar la pantalla para finalizarlo.
Para iniciar el daemon servidor de Abstract Window Toolkit (AWT) remoto para JDK 1.1.x, especifique lo siguiente en la línea de mandatos:
java com.ibm.rawt.server.RAWTPCServer
Para iniciar el daemon servidor de AWT remoto para J2SDK, versión 1.2, especifique lo siguiente en la línea de mandatos:
donde “VIA_DE_ACCESO” es la unidad y el directorio totalmente calificados donde se encuentra el archivo RAWTGui.jar. Por ejemplo, java -jar
c:\rawt2\RAWTGui.jar .
El daemon servidor selecciona el primer puerto libre por encima del 2000 cuando la aplicación Java se conecta mediante AWT remoto. La aplicación Java utilizará ese puerto hasta finalizar. Las aplicaciones Java adicionales se conectarán a los siguientes puertos por encima del 2000 que estén libres. El rango de puertos disponibles llega hasta el 9999.
Si desea obtener más información sobre la configuración de TCP/IP, consulte el capítulo “How do I set up TCP/IP” de la publicación OS/400 TCP/IP
Configuration and Reference, SC41-5420.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Ejecutar un programa Java con AWT remoto
Para ejecutar Java con AWT remoto:
1. Inicie AWT remoto en la pantalla remota.
2. Inicie el programa Java en AS/400.
a. Entre el mandato Ejecutar Java (RUNJVA) en la línea de mandatos.
Nota:debe definir la vía de acceso de clases Java del programa Java.
b. Pulse F4 (Solicitud).
c. Entre el nombre de clase del programa Java en la línea de parámetro de clase.
d. Pulse F10 (Parámetros adicionales).
e. Pulse la tecla Av Pág.
f. Entre RmtAwtServer en la siguiente línea de parámetro de nombre de propiedad.
g. Entre la dirección TCP/IP (por ejemplo, 1.1.11.11) de la pantalla remota en la siguiente línea de parámetro de valor de propiedad.
h. Entre os400.class.path.rawt en la línea de parámetro de nombre de propiedad.
i. Entre 1 en la línea de parámetro de valor de propiedad.
j. Especifique + para entrar más propiedades.
k. Especifique java.version en la línea de parámetro de nombre de propiedad.
l. Especifique 1.2 en la línea de parámetro de valor de propiedad. La línea de mandatos será así:
java class (classname) prop((RmtAwtServer '1.1.11.11') (os400.class.path.rawt 1)(java versio
m. Pulse Intro.
Para ejecutar un programa Java, se puede utilizar también el AWT remoto con Netscape.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Ejecutar un programa Java utilizando AWT remoto con Netscape
A la hora de ejecutar aplicaciones Java con Netscape, esto puede hacerse de dos maneras.
Una opción es iniciar el servidor de AWT remoto dentro de la máquina virtual Java de Netscape abriendo un archivo HTML que contenga
com.ibm.rawt.server.StartRAWT.class. Por ejemplo, vea el el archivo RAWT.html que figura más abajo. Una vez se haya iniciado, ya puede iniciar una aplicación Java en el AS/400.
Otra posibilidad es iniciar el servidor de AWT remoto dentro de la máquina virtual Java de Netscape abriendo un archivo HTML que contenga
com.ibm.rawt.server.StartRAWT400.class y las clases de AS/400 Toolbox para Java. Por ejemplo, vea el archivo RAWT400.html que se muestra más abajo. Una vez se haya iniciado, ya puede iniciar la sesión en el AS/400 en el que reside la aplicación Java e iniciar dicha aplicación.
Ejecutar el servidor de AWT remoto dentro de la máquina virtual Java de Netscape:
Para ejecutar el servidor de AWT remoto dentro de la máquina virtual Java de Netscape, siga estos pasos:
1. Edite este archivo .html de ejemplo de acuerdo con la información específica de la instalación de RAWTGui.zip. Este archivo, RAWT.html, inicia AWT remoto dentro de la máquina virtual Java de Netscape.
<HTML>
<BODY TEXT=“#000000” LINK=“#0000EE” VLINK=“#551A8B” ALINK=“#FF0000”> <CENTER> <APPLET CODE=“com.ibm.rawt.server.StartRAWT.class” codebase=“file://C|remote_awt\jdk1.1.7\lib\RAWTGui.zip” WIDTH=600 HEIGHT=50> </APPLET> </CENTER> </BODY> </HTML>
2. Abra la página RAWT.html con Netscape 4.05 o posterior. Después de otorgar todos los privilegios solicitados, Netscape inicia el servidor de AWT remoto y lo ejecuta dentro de su máquina virtual Java.
3. Inicie una aplicación Java en el AS/400 utilizando AWT remoto.
4. Una vez haya salido de la aplicación, pulse en el botón Recargar mientras mantiene pulsada la tecla Mayús para iniciar de nuevo el servidor de AWT remoto.
Ejecutar el servidor de AWT remoto dentro de la máquina virtual Java de Netscape e iniciar la sesión en el AS/400:
Para ejecutar el servidor de AWT remoto dentro de la máquina virtual Java de Netscape e iniciar la sesión en el AS/400, siga estos pasos:
1. Edite este archivo .html de ejemplo de acuerdo con la información específica de la instalación de jt400.zip y RAWTGui.zip. Este archivo, RAWT400.html, inicia AWT remoto y utiliza AS/400 Toolbox para Java para iniciar la sesión en AS/400.
<HTML>
<BODY TEXT=“#000000” LINK=“#0000EE” VLINK=“#551A8B” ALINK=“#FF0000”> <CENTER> <APPLET ARCHIVE=“file://C\jt400\lib\jt400.zip” code=“com.ibm.rawt.server.StartRAWT400.class” codebase=“file://C|remote_awt\jdk1.1.1\lib\RAWTGui.zip” WIDTH=600 HEIGHT=50> </APPLET> </CENTER> </BODY> </HTML>
2. Abra esta página RAWT400.html con Netscape 4.05. Después de otorgar todos los privilegios solicitados, Netscape inicia el applet de AWT remoto que
visualiza un panel en el que puede elegir cualquiera de las opciones siguientes: v Iniciar la sesión en el AS/400 con AWT remoto utilizando AS/400 Toolbox
para Java para acceder al AS/400.
v Entrar el nombre de aplicación Java y los argumentos con las propiedades de AWT remoto.
v Pulsar el botón Iniciar aplicación para iniciar la aplicación Java especificada con AWT remoto.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Imprimir con AWT remoto
Imprimir con AWT remoto es una tarea que se realiza igual que en el AWT Java estándar. La pantalla remota de AWT remoto procesa la salida de impresión y la dirige a cualquier impresora que el sistema operativo de la pantalla remota conozca. Puede tratarse de una impresora que esté conectada directamente a la pantalla remota o bien de una impresora de red que el sistema operativo de la pantalla remota conozca.
Puede optar por imprimir en la pantalla remota o en un AS/400. Cuando una aplicación emite una petición de impresión, se abre un diálogo de imprimir nuevo. La petición de impresión permite seleccionar una impresora de la pantalla remota o una de OS/400. Si selecciona una impresora de OS/400, aparecerá una pantalla de inicio de sesión. Una vez iniciada la sesión, aparecerá una pantalla con el diálogo de imprimir. Puede especificar el título de la página de cabecera y el archivo, el archivo de impresión y la cola de impresión de OS/400. También puede seleccionar el tamaño del papel, la orientación y el número de copias.
Para utilizar la impresión remota, debe instalar AS/400 Toolbox para Java (5763-JC1) y añadir lo siguiente a la vía de acceso de clases del AS/400:
QIBM/ProdData/HTTP/Public/jt400/lib/jt400.zip
La vía de acceso de clases puede actualizarse añadiendo la variable de entorno CLASSPATH o bien utilizando el parámetro de vía de acceso de clases.
Nota:si aparece el mensaje siguiente mientras imprime en AS/400, significa que AS/400 Toolbox para Java no está instalado o bien que las clases de AS/400 Toolbox para Java no se encuentran en la vía de acceso de clases.
Error en carga de archivo de clase: com/ibm/as400/access/PrintObjectList.class Se ha producido una excepción durante la asignación de eventos:
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Propiedades de AWT remoto
Cuando se ejecuta una aplicación de AWT remoto Java en el sistema AS/400, se debe utilizar la propiedad os400.class.path.rawt con el valor 1. Existe un número de propiedades por omisión que son necesarias al utilizar AWT remoto. Estas propiedades por omisión, junto con la versión adecuada de AWT remoto y la CLASSPATH, se establecen al utilizar la propiedad os400.class.path.rawt. La versión de AWT remoto se establece de acuerdo con la versión de JDK, que es la versión por omisión, si no se especifica, o la versión especificada con la propiedad java.version.
Estas son las propiedades por omisión que son necesarias para AWT remoto.
Para JDK 1.1.x: v awt.toolkit=com.ibm.rawt.CToolkit Para J2SDK, versión 1.2: v awt.toolkit=com.ibm.rawt2.ahost.java.awt.AHToolkit v java.awt.graphicsenv=com.ibm.rawt2.ahost.java.awt.AHGraphicsEnvironment v java.awt.printerjob=com.ibm.rawt2.ahost.java.awt.print.AHPrinterjob
Propiedades de AWT remoto para la pantalla remota:
Si el daemon servidor o la aplicación Java finaliza de forma anormal con el mensaje siguiente, compruebe la versión de Java de la pantalla remota.
La versión de JDK del sistema principal de la aplicación/de la estación del usuario es incompatible con la versión de AWT remoto...
Para comprobar el nivel de versión, entre java -version en la línea de mandatos. Esta propiedad nueva puede utilizarse en una pantalla remota si hay algún problema con la versión de JDK. Esta propiedad no es procedente en AS/400. Si la versión no está al nivel 1.1.x, debe instalar el nivel pertinente. Si está al nivel 1.1.x, puede ejecutar el servidor de AWT remoto y/o la aplicación con la propiedad siguiente, que indica la versión de Java: -DJdkVersion=1.1.x.
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Restricciones de SecurityManager de AWT remoto
Las aplicaciones Java que utilizan AWT remoto bajo el control de SecurityManager tienen algunas restricciones. Las clases de AWT remoto inician métodos, que llaman a métodos de comprobación SecurityManager en aquellos casos en que está establecido SecurityManager. En tales casos, es posible que una aplicación Java que se ejecute con AWT remoto se encuentre con una excepción SecurityException. Los métodos de comprobación a los que se llama como resultado de la ejecución con AWT remoto son:
v SecurityManager.checkAccess(..)
v SecurityManager.checkMemberAccess(..) v SecurityManager.checkExit(..)
v SecurityManager.checkRead(String file) v SecurityManager.checkConnect(...) v SecurityManager.checkListen(...) v SecurityManager.checkAccept(...)
v SecurityManager.checkPropertiesAccess(..)
[ Página de presentación de Information Center | Comentarios ]
[ Legal | Glosario de AS/400 ]
Establecimiento de Class Broker para Java en una pantalla remota
Con Class Broker para Java (CBJ), puede ejecutar programas gráficos Java habilitados para Class Broker para Java en AS/400 y visualizar los gráficos