Setting up the IBM WebFacing Tool

Setting up your systems for the WebFacing Tool involves the following activities:

  • Setting up WebSphere® Application Server on your i5/OS® server
  • Installing the WebFacing server PTFs on your i5/OS server
  • Starting the WebFacing server on the i5/OS server
  • Transferring converted applications to the i5/OS server.

Setting up WebSphere Application Server on your i5/OS server

WebSphere Application Server handles executing the JavaServer Pages and JavaBeans™ that are generated as part of the DDS conversion process. Set up WebSphere Application Server for i5/OS using the documentation resources on the following Web sites:

Minimally you will need to carry out the installation steps. Becoming familiar with the IBM WebSphere Application Server documentation, in particular the sections on installation and creating application server instances, is highly recommended.

You can optionally set up individual instances for the WebSphere Application server. If your system is to be used for test and production work, it can be helpful to create instances for testing and development and separate instances for production. As well, if more than one developer is doing development work, their work can be developed and tested separately by creating additional instances. Installing and configuring WebSphere Application Server sets up an HTTP server by default accessible through port 80. An administrative server is by default accessible through port 9060 for versions 6.0 and 6.1, and through port 9090 for versions 5.1 Base and 5.1 Express. The administrative servers are accessed through a browser-based console. If you want to create additional instances, please refer to the Web site links above.

For version 5.1 Base, follow the navigation in the i5/OS Information Center: WebSphere Application Server home > Administration > Configuration and management > Administer WebSphere Application Server instances > Create a new instance

For version 5.1 Express, follow the navigation in the i5/OS Information Center: Information Center home > e-business and Web serving > Application Servers > WebSphere Application Server - Express 5.0 > Administration > Create an application server instance

Test the WebSphere Application Server setup. See the Verify the installation links at the following sites for information about testing your application server setup.

Installing the WebFacing server PTFs on your i5/OS server

The WebFacing server acts as a gateway between WebSphere Application Server and your original i5/OS application. Information about the WebFacing server PTFs can be found in Troubleshooting WebFacing applications.

The WebFacing server PTFs must be installed on the i5/OS server where your application will be running. Except on some later-model i5/OS servers, the WebFacing Tool consumes interactive cycles. Although WebSphere Application Server can run on the same system, it is not necessary for it to be running on the same system on which your application is running. The converted interface to your application is deployed as a WebSphere application; you can deploy the WebFacing WebSphere application to one i5/OS server while the i5/OS application is installed on another.

Starting the WebFacing runtime server on the i5/OS server

  1. Start the WebFacing runtime server on your i5/OS server. For i5/OS V5R2 and later, enter STRTCPSVR SERVER(*WEBFACING) from the command line. To stop the WebFacing server, enter ENDTCPSVR SERVER(*WEBFACING) from the command line.
  2. To ensure that the server is running, enter WRKACTJOB from the command line.
    1. From a command line enter WRKACTJOB JOB(QQF*) to list all WebFacing jobs:
      • QQFWFSVR -- the WebFacing runtime server AND
      • QQFVTSVR -- the WebFacing virtual terminal server (More than one QQFVTSVR job may be running, which is normal)
    Note: Check the system value QAUTOVRT. If this value is 0 then no browser sessions can be launched in place of VT (virtual terminal) jobs. The WebFacing runtime server relies on VT jobs. The value for QAUTOVRT determines the number of virtual terminal jobs that can be auto started. If necessary, set QAUTOVRT to *NOMAX or some value greater than 0. To change the value for QAUTOVRT, use the WRKSYSVAL i5/OS server command to work with system values.

Transferring converted applications to the i5/OS server

Application development is done on a workstation. Artifacts generated by the application must later be transferred to an i5/OS server so they can be deployed by WebSphere Application Server. Set up a method for transferring your converted applications to your i5/OS server. When you are deploying your converted applications to your i5/OS server, you will need a method to transfer them to your server. Applications are transferred as .ear files, which are archived Web application packages created through the Export wizard. They facilitate deploying and installing new WebFacing Web applications to WebSphere Application Server. These are the primary methods for transferring files:
  • Remote System Explorer perspective in the Rational® Developer for System i™ workbench
  • i5/OS NetServer™ file sharing -- With file sharing, files can be transferred using the Export wizard.
  • FTP -- With FTP, files are transferred manually.

NetServer file sharing allows you to map an IFS folder on your i5/OS server to a drive letter on your workstation. This allows you to use the Export wizard to transfer files to your server in the same way that you can copy files from one folder to another on your workstation. To transfer your files by FTP, the FTP server must be running on your i5/OS server. If FTP is not running, it can be started by entering the command STRTCPSVR *FTP.

The WebFacing Tool provides a GUI environment for selecting, converting, and testing the converted user interfaces of your original application.


Feedback