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 iSeries server
  • Installing the WebFacing server PTFs on your iSeries server
  • Starting the WebFacing server on the iSeries server
  • Transferring converted applications to the iSeries server.

Setting up WebSphere Application Server on your iSeries 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 iSeries using the documentation resources on the following Web sites:

IBM WebSphere Application Server 5.0 for iSeries -- Base Edition
http://publib.boulder.ibm.com/iseries/v1r1m0/websphere/ic2924/index.htm
IBM WebSphere Application Server 5.0 for iSeries -- Express Edition
http://publib.boulder.ibm.com/iseries/v5r3/ic2924/index.htm?info/rzamy/50/install/install.htm
IBM WebSphere Application Server 6.0 for iSeries
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp

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 version 6.0 and through port 9090 for versions 5.0 Base and 5.0 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.0 Base, follow the navigation in the iSeries Information Center: WebSphere Application Server home > Administration > Configuration and management > Administer WebSphere Application Server instances > Create a new instance

For version 5.0 Express, follow the navigation in the iSeries 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 iSeries server

The WebFacing server acts as a gateway between WebSphere Application Server and your original iSeries application. Information about the WebFacing Server PTFs is available at the Web site ibm.com/software/awdtools/iseries/.

The WebFacing server PTFs must be installed on the iSeries server where your application will be running. Except on some later-model iSeries 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 iSeries server while the iSeries application is installed on another.

Starting the WebFacing runtime server on the iSeries server

  1. Start the WebFacing runtime server on your iSeries server. For V5R1 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 iSeries server command to work with system values.

Transferring converted applications to the iSeries server

Application development is done on a workstation. Artifacts generated by the application must later be transferred to an iSeries server so they can be deployed by WebSphere Application Server. Set up a method for transferring your converted applications to your iSeries server. When you are deploying your converted applications to your iSeries 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 Development Studio Client workbench
  • iSeries 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 iSeries 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 iSeries server. If FTP is not running, it can be started by entering the command STRTCPSVR *FTP.

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