Administration and Programming Guide for OS/390
Servlets are Java classes that perform a role similar to that of CGI
programs or Web server API plug-ins. Servlets run on a Java
servlet-enabled Web server and extend the server's capabilities, much
like the way Java applets run on a browser and extend the browser's
capabilities. Use the following steps to configure your environment to
invoke Net.Data through this Java servlet interface.
Unless you modified the directory structure or name when you created the
HFS directory for Net.Data, the SMP/E install process installed the
Net.Data DLLs and NetDataServlets.jar file in the directory
/usr/lpp/netdata/servlet-lib. Because
/usr/lpp/netdata is not your Web server's root directory, the
Web server cannot handle client requests for Net.Data unless you make
some additional modifications to the Web server's configuration.
To modify the Web server:
- Enable the Web server to run servlets. (See your Web server
documentation for instructions on registering and using servlets.)
- Use either of the following approaches to complete the installation of the
executable files and DLLs.
- Using Net.Data Directories
- Add your Net.Data servlet-lib directory to the LIBPATH
statement of the Web server's environment variables file,
/etc/httpd.envvars. If your Net.Data
servlet-lib directory is /usr/lpp/netdata/servlet-lib,
then your LIBPATH statement should be similar to:
LIBPATH=/usr/lpp/internet/bin:/usr/lpp/netdata/servlet-lib
- Add the NetDataServlets.jar file to the CLASSPATH
statement of the Web server's environment variables file,
/etc/httpd.envvars. If the Net.Data
servlet-lib directory is /usr/lpp/netdata/servlet-lib,
then your CLASSPATH statement should be similar to the following
statement:
CLASSPATH=/usr/lpp/JDK1.1/lib/classes.zip:/usr/lpp/netdata/servlet-lib/
NetDataServlets.jar
- Using Web Server Directories
- Move the Net.Data DLLs
(libdtwndapi.so, appldl,
dtwle, dtwlei, dtwsql, dtwsqlv6,
filedll, odbcdll, perldll,
rexxdll, sysdll) and the
NetDataServlets.jar file to the Web server's
cgi-bin directory. The Web server default cgi-bin
directory is /usr/lpp/internet/server_root/cgi-bin.
- Add the NetDataServlets.jar file to the CLASSPATH
statement of the Web server's environment variables file,
/etc/httpd.envvars. Your CLASSPATH statement should
be similar to the following statement:
CLASSPATH=/usr/lpp/JDK1.1/lib/classes.zip:/usr/lpp/internet/server_root\
/cgi-bin/NetDataServlets.jar
- Add the Web server's cgi-bin directory to the LIBPATH
statement of the Web server's environment variables file,
/etc/httpd.envvars. If your Web server
cgi-bin directory is
/usr/lpp/internet/server_root/cgi-bin, your LIBPATH statement
should be similar to:
LIBPATH=/usr/lpp/internet/bin:/usr/lpp/internet/server_root/cgi-bin
- Ensure that the permissions are 755 for the Net.Data executable
files and DLLs and for each directory in the path to the executable files and
DLLs.
- After configuring Net.Data, configure the IBM WebSphere Application
Server to work properly with Net.Data servlets. Use one of the
following methods:
- Update the jvm.properties file by adding the full
pathname of the file NetDataServlets.jar to the property
named ncf.jvm.classpath.
- You can use the IBM WebSphere Application Server Manager:
- From your web browser, launch the IBM WebSphere Application Server Manager
login screen.
- Login to the manager and click Manage.
- From the Setup menu, select Basic.
- Add the full pathname of the file NetDataServlet.jar to
the Java classpath shown on the page.
- Select No to the question, "Use system classpath?"
- Restart the Web server.
Restriction: Do not specify more than one of the following
directories in the LIBPATH statement of the Web server's environment
variables file:
- cgi-bin
- icapi-lib
- servlet-lib
For more detail on installing the Web server and on Web server
configuration file directives, refer to the following publications:
- Lotus Domino Go Webserver Planning for Installation Version
5.0 for OS/390, SC31-8690-00
- Lotus Domino Go Webserver Webmaster's Guide Version 5.0
for OS/390, SC31-8691-00
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]