Configuring NAWT environment variables

Any time that you run Java™ with NAWT, you must set environment variables that tell Java the system name, the display number, and where to find each X server and the associated .Xauthority file.

Note: Starting the Virtual Network Computing (VNC) server determines the location of the .Xauthority file and the values for the system name and display number. You need to use these values to successfully configure the NAWT environment variables. For more information, see Starting the Virtual Network Computing server.

Configuring DISPLAY

In the session where you want to run Java programs, set the DISPLAY environment variable to your system name and display number. To configure the DISPLAY environment variable, at an i5/OS™ command line, type the following control language (CL) command and press ENTER:

     ADDENVVAR ENVVAR(DISPLAY) VALUE('systemname:n')

where systemname is the host name or IP address of your iSeries™ system and n is the display number of the VNC server.

Configuring XAUTHORITY

Also, set the XAUTHORITY environment variable to /home/VNCprofile/.Xauthority, where VNCprofile is the profile that started the VNC server.

For example, at the iSeries command prompt, type the following commands:

     ADDENVVAR ENVVAR(DISPLAY) VALUE('systemname:n')
     ADDENVVAR ENVVAR(XAUTHORITY) VALUE('/home/VNCprofile/.Xauthority')

Where:

systemname is the host name or IP address of your iSeries system.
n is the display number of the VNC server.

Notes:

You need to set these environment variables only in the environment where you will run the Java virtual machine (JVM).
When you cannot run the VNC server and the Java virtual machine under the same user profile, you can configure XAUTHORITY to point to the appropriate .Xauthority file. You must ensure that the other profiles under which the JVM runs can access the .Xauthority file. For more information, see The .Xauthority file.
The XAUTHORITY security mechanism is different from the VNCPASSWD security mechanism. Both protection schemes are necessary for secure graphics rendering. For more information about VNCPASSWD, see Creating a VNC password file.