Enable graphing support for HATS on iSeries

HATS enables you to transform host data such as tables into graphs on a Web page. Some additional iSeries software and configuration is required in order to support the complete graphing capabilities of HATS applications running on iSeries. The additional software provides Java Abstract Windowing Toolkit (AWT) methods via Native Abstract Windowing Toolkit (NAWT). The additional software is not included with the IBM Developer Kit for Java, 5722JV1, licensed product. Note that you cannot use Remote AWT (RAWT) to enable graphing for HATS because HATS graphing requires com.sun.* classes, which are not supported via RAWT.

This additional software is required to support the graphing function:

• 5722SS1/Option 33 - Portable App Solutions Environment (PASE)
• 5799PTL - iSeries Tools for Developers PRPQ
• For OS/400 V5R1, PASE 5722SS1 PTFs SI01551 and SI08230 are required
• For OS/400 V5R2, PASE 5722SS1 PTF SI08232 is required

Follow these steps to install and configure the required software:

1. Obtain the required software and make the media available to the iSeries machine.
2. Log into an iSeries command prompt with QSECOFR authority.
3. To install Portable App Solutions Environment, issue the following command:

   RSTLICPGM LICPGM(5722SS1) OPTION(33)

4. Ensure that the required PASE PTFs are installed.
5. To install iSeries Tools for Developers PRPQ, issue the following command:

   RSTLICPGM LICPGM(5799PTL)

6. Make the directory to store the password for the VNC server (note that if you have configured WebSphere to run under a userid other than QEJBSVR, you will have to create a directory structure for that userid):

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

7. Run the following commands to assign the appropriate permissions to the /home/QEJBSVR directory tree (or whatever directories you created in step 6):

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

8. Create the password file required by the VNC server. Note that you will be asked for a password that will be stored for the VNC server to use at start up:

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

9. Start the VNC Server under the QEJBSVR userid (or whatever userid your WebSphere Application Server runs under):

   SBMJOB CMD(CALL PGM(QP2SHELL) PARM
   ('/QOpenSys/QIBM/ProdData/DeveloperTools/vnc/vncserver_java' ':1')) 
           USER(QEJBSVR) JOBQ(QSYSNOMAX)

   It is possible to enable automatic startup of the VNC server each time that the system is restarted. Refer to the QSTRUPPGM system value in the OS/400 Work Management Guide (SC41-5306).

   You may also view the log files for the VNC server by issuing DSPF '/home/QEJBSVR/.vnc' and displaying the .log files.

Start the WebSphere Administrative Console, then follow these steps:

1. In the left pane, open the Servers folder by clicking the plus sign.
2. Click on the Application Servers link.
3. In the right pane, click on the link of the application server that your HATS application is deployed to. For example, server1.
4. On the Configuration tab of the server, under Additional Properties, page down to the Process Definition link. Click the Process Definition link.
5. Under Additional Properties, click the Environment Entries link.
6. Click New.
7. Enter DISPLAY in the Name field and host_name:1 in the Value field, where host_name is the TCP/IP host name of your system. For example, myHostName:1.
8. Click Apply. Click OK.
9. Click the Environment Entries link again.
10. Click New.
11. Enter XAUTHORITY in the Name field and /home/QEJBSVR/.Xauthority in the Value field.
12. Click Apply. Click OK.
13. Now click the Java Virtual Machine link.
14. Under Additional Properties, click Custom Properties.
15. Click New.
16. Enter os400.class.path.rawt in the Name field and 2 in the Value field.
17. Click Apply. Click OK.
18. Make sure you save your updated configuration.
19. Logout of the Administrative Console.
20. Restart the WebSphere Application Server by issuing these commands from the iSeries command prompt:

    • QSH
    • cd /QIBM/ProdData/WebAS5/Base/bin
    • stopServer serverName, where serverName is the name of the application server that you have installed your HATS applications to. For example, stopServer server1.
    • Wait for completion messages that say that the application server has stopped.
    • Restart the server by entering startServer serverName, where serverName is the name of the application server that you have installed your HATS applications to. For example, startServer server1.
    • When the startServer command completes, press F12 to exit the QSH session

 

Home