Configuring the iceWM window manager

Configure the iceWM window manager (iceWM), as an optional step during NAWT set up, when you want to interactively use the Virtual Network Computing (VNC) server. For example, you may want to run a Java™ application that features a graphical user interface (GUI).

iceWM is a small but powerful window manager included in the iSeries™ Tools For Developers PRPQ. For information about installing the PRPQ, see the following page:

Install iSeries Tools for Developers PRPQ

Running in the background, iceWM controls the look and feel of windows running within the X Window environment of the VNC server. iceWM provides an interface and a set of features that are similar to many popular window managers. The default behavior of the included vncserver_java script starts the VNC server and runs iceWM.

Completing this step creates several configuration files that iceWM requires. If you want, you can also disable iceWM.

Configuring iceWM

To configure the iceWM window manager, complete the following steps at an i5/OS™ command prompt. Be sure to perform these steps under the profile that you use to start the VNC server.

Type the following command and press ENTER to start the installation. :
```
    STRPTL CLIENT(IGNORE)
```
The IGNORE value functions as a placeholder that ensures the command activates only the configuration features of STRPTL that NAWT requires.
Type the following command and press ENTER to sign off:
```
    SIGNOFF
```
Signing off ensures that any session-specific results of the STRPTL command do not affect subsequent actions that you perform to use or configure NAWT.

Note: Run the STRPTL command only once for each profile that starts a VNC server. NAWT does not require any of the available optional arguments for the command. These statements override any setup instructions for STRPTL associated with the 5799-PTL iSeries Tools For Developers PRPQ.

Disabling iceWM

Starting the VNC server creates or modifies an existing script file called xstartup_java that contains the command to run iceWM. The xstartup_java script file resides in the following integrated file system directory:

     /home/VNCprofile/.vnc/

where VNCprofile is the name of the profile that started the VNC server.

To completely disable iceWM, use a text editor to either comment out or remove the line in the script that starts iceWM. To comment out the line, insert a pound sign character (#) at the beginning of the line.