Setting up the Servlet interface
The Servlet interface enables the Web server to run stand-alone executable programs in response to requests from clients. While most Web servers today support servlets, you will need to make sure the specific server you are planning to use supports servlets. A good example is the IBM WebSphere Application Server.
To install the Servlet interface, follow these steps:
1. Copy the Servlet interface Java archive file, abtwsi.jar, to the directory your Web server uses for servlets, usually a servlets subdirectory. (For IBM WebSphere Application Server, install the VAST servlets before continuing to set up the Servlet interface.)
2. Run the RouterConfigurationInfoServlet to determine the Web server's default directory for Java properties files. This servlet is included in the abtwsi.jar file. To run the servlet, point your Web browser to
//<serverName>/<servletsDirectory or alias>/com.ibm.abt.web.servlet./RouterConfigurationInfoServlet.
Note:
Many Web Servers set up an alias for the servlets directory, usually named servlet. If the server you are using has an alias, specify the alias instead of the actual servlets directory.
The RouterConfigurationInfoServlet returns an information page that lists the settings used when the Web Connection Router servlet runs. Under the Basic Properties, record the value for the Default directory property. For example:
Default Directory (abtwsi.pro) C:\WINNT\system32\
3. Copy the properties file, abtwsi.pro, to the Default directory that was listed on the information page from the RouterConfigurationInfoServlet.
4. Copy the following files to the directory to be referenced by abtwsi.pro:
a. abtwsi.cnf (configuration file)
b. abtwsi.htm (error format file)
If the web server is MS Internet Information Server, use the \Inetpub\wwwroot\cgi-bin directory .
If the web server is IBM HTTP server, then use the \Program Files\IBM Http Server\cgi-bin directory.
5. Edit the abtwsi.pro file and change the ABTWSI_BASENAME field to point to where the abtwsi.cnf and abtwsi.htm web server interface files reside. For example:
 
ABTWSI_BASENAME=d:/InetPub/wwroot/cgi-bin/abtwsi
 
This environment variable specifies where WSI looks for configuration and error message files.
When you install Web Connection, these files are installed in the webconn directory. You can copy them to another directory and also rename them. If you do either, you must reflect their new location and name in the ABTWSI_BASENAME field in the abtwsi.pro file. For example, if you moved the files to d:\wsifiles, and renamed them from abtwsi.* to mywsi.*, you would supply a value d:/wsifiles/mywsi for the ABTWSI_BASENAME field.
Note:
You must use forward slashes (/) when specifying the path information for the ABTWSI_BASENAME field. Java treats backward slashes (/) as escape characters.
6. If you made changes to abtwsi.pro, you may need to stop and restart your Web Server before the changes take effect.
7. Proceed to Testing your installation to setup, test, and run the Web Connection interface.
Last modified date: 07/30/2021