Virtual Network Computing

Overview

Document Manager and Internet Mailbox require additional setup to support the use of document conversion. Document conversion enables WebSphere Portal to convert documents produced by commonly used office programs into Web pages, so that they can be viewed and searched by users online.

To make document conversion possible, have an AT&T Virtual Network Computing (VNC) server running on the iSeries system. IBM provides a version of the VNC server that runs in the OS/400 Portable Application Solutions Environment (OS/400 PASE). This version of VNC is available in versions of iSeries Tools for Developers PRPQ (5799PTL) ordered after 14 June 2002.

Once you have a VNC server running on the iSeries system, follow the instructions in this section for Configure for VNC.

While VNC can be installed through other means, the instructions in this section apply only to the version of VNC provided with iSeries Tools for Developers PRPQ.

  1. Set up a VNC server
  2. Verifying the VNC server
  3. Ending the VNC server

 

Set up a VNC server on the iSeries System

Follow these instructions to set up a VNC server on the iSeries system.

  1. Verify that the following software is installed:

    5722SS1/Option 33 Portable App Solutions Environment
    5799PTL iSeries Tools for Developers PRPQ
    (PTF) SI08232 OSP-JVA-RUN NAWT Can't Connect to X11 Window Server

  2. Make the directory to store the password for the VNC server by entering the following commands on an OS/400 command line:

    MKDIR DIR('/home/QEJBSVR')
    MKDIR DIR('/home/QEJBSVR/.vnc')

  3. Run the following command to assign the appropriate permissions to the /home/QEJBSVR directory tree:

    STRQSH CMD('chown -R QEJBSVR /home/QEJBSVR')

  4. Create the password file required by the VNC server. Note that you will be prompted for a password that will be stored for the VNC server to use at startup:

    QAPTL/VNCPASSWD USEHOME(*NO) PWDFILE('/home/QEJBSVR/.vnc/passwd')

  5. Start the VNC Server under the user ID used by WAS (QEJBSVR is the default):

    SBMJOB CMD(CALL PGM(QP2SHELL) PARM('/QOpenSys/QIBM/ProdData/DeveloperToosl/vnc/vncserver_java' ':<n>')) USER(QEJBSVR) JOBQ(QSYSNOMAX)

    where n is the VNC server number (for example ':1').

You can enable the automatic startup of the VNC server each time that the iSeries system is restarted. Refer to the QSTRUPPGM system value in the OS/400 Work Management Guide (SC41-5306) for details. See the iSeries Information Center at http://publib.boulder.ibm.com/html/as400/infocenter.html for more information.

You can view the log files for the VNC server by entering the following on an OS/400 command line:

DSPF '/home/QEJBSVR/.vnc'

Select option 5 to display any of the files in this directory.

 

Verifying the VNC server

Follow these steps to verify that the VNC server is running and properly configured:

  1. Start the Qshell Interpreter by entering the following on an OS/400 command line:

    STRQSH

  2. Enter the following:

    export DISPLAY=<hostname>:<n>

    where host_name is the TCP/IP host name of the system, and n is the VNC server number (for example ':1').

  3. Enter the following: 

    export XAUTHORITY=/home/QEJBSVR/.Xauthority

  4. Enter the following:

    java -Djava.version=1.3 -Dos400.class.path.rawt=2 -classpath /QIBM/ProdData/Java400/jdk13/jdkawt.jar NAWTtest

If the VNC server is running and properly configured, the output generated by entering these commands should look like this: 

jpgName will be /tmp/NAWTtest.jpg  
JPG construction is complete   
Press F3 to exit the QSH session.

When displayed with an image viewer, the file /tmp/NAWTtest.jpg will show a page of sample fonts.

 

Ending the VNC server

To end the VNC server, enter the following on an OS/400 command line under the user ID used by WAS (QEJBSVR is the default):

SBMJOB CMD(CALL PGM(QP2SHELL) PARM('/QOpenSys/QIBM/ProdData/DeveloperTools/vnc/vncserver_java' '-kill' ':<n>')) USER(QEJBSVR)

where n is the VNC server number (for example ':1').

The user profile used to perform this command must have *JOBCTL and *USE authority.

 

See also