Web Connection User's Guide

Setting up the ICAPI web server interface

The Lotus Go Webserver for OS/390 must be configured to properly handle and route requests for the VisualAge server program. The Go Webserver is designed to use HFS files in OS/390. This means that you must create a directory to put the WSICNF file into as well as create a symbolic link for the executable module.

In an OMVS shell, do the following:

  1. Create an HFS directory for the configuration file (WSICNF) and error format file (WSIHTM). For example: /usr/lpp/wsi.
  2. FTP the web server interface configuration files to the directory.
    Note:The web server interface files are installed in a webconn of the VisualAge client. You can rename these files, for example from abtwsi.* to mywsi.*. If you do this, you must reflect their new location and name in the ABTWSI_BASENAME field in the abtwsi.pro file. For example, if you renamed the files from abtwsi* to mywsi*, you would need to point to <path>/mywsi in the ABTWSI_BASENAME field.
  3. Create an external symbolic link in the Go Webserver cgi-bin directory that links to the ABTWSAI executable, which is in an MVS load library. For example, from your Go Webserver cgi-bin directory, ln -e ABTWSAI abtwsai.so. For more information about creating external symbolic links, refer to the OS/390 Open Edition MVS User's Guide.

In TSO, do the following:

  1. Edit the Go Webserver start up PROC (IMWEBSRV).
  2. Modify the STEPLIB concatenation in IMWEBSRV to include the load library containing ABTWSAI.
  3. Add the following statements to IMWEBSRV:
    //ABTCNF  DD PATH='/usr/lpp/wsi/abtwsi.cnf',PATHOPTS=(ORDONLY)
    //ABTHTM  DD PATH='/usr/lpp/wsi/abtwsi.htm',PATHOPTS=(ORDONLY)
    //ABTLOG  DD SYSOUT=*
    

From the Go Webserver configuration and administration page, update your HTTP server configuration by doing the following:

  1. Start your web server.
  2. Open a web browser and point it to your server location (the hostname of the server).
  3. On the Go Webserver page, select Configuration and Administration Forms.
  4. On the Configuration and Administration page, select GWAPI Application Processing.
  5. On the GWAPI page, for ServerInit, specify the server initialization directive. For example:
    /webserver/cgi-bin/abtwsai.so:AbtWsiServerInit
    
  6. For ServerTerm, specify the server termination directive. For example:
    /webserver/cgi-bin/abtwsai.so:AbtWsiServerTerm
    
  7. Apply the changes.
  8. On the Configuration and Administration page, select *Service in the Action drop-down list.
  9. For the URL request template, specify /abtwsi*.
  10. For Replacement file path, specify the service directive. For example:
    /webserver/cgi-bin/abtwsai.so:AbtWsiService*
    
  11. Apply the changes and restart the web server.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]