Communicator e3000 MPE/iX Release 6.5 Express 2 (Software Release C.65.02) (30216-90322)

Chapter 3 35
Technical Articles
Java Servlets for MPE/iX
variables for running the engine as a standalone process. JSRVS is the job file for
WebWise.
JSRVOFF - The Apache job stream file for stopping the JServ engine. JSRVSOFF is the job
file for WebWise.
libexec - The subdirectory containing mod_jserv.so, the JServ class files
(ApacheJServ.jar), and an example file and documentation for creating your own DSOs.
servlets - This subdirectory is the pre-configured repository for servlet files. It contains
two simple servlet source files and their corresponding class files. These files are used for
testing the installation.
conf/jserv - A subdirectory containing three new configuration files: jserv.conf,
jserv.properties, and root.properties.
htdocs/jservdocs - This subdirectory is the root for the Apache JServ documentation
including the API specification in javadoc format, a feature list, FAQs, and several
in-depth articles on functionality.
htdocs/JSDK2.0/doc/apidoc/ - This subdirectory contains the JSDK2.0 API
specification in javadoc format.
lib/jsdk.jar - Class files in jar format of the Java Servlet Development Kit 2.0
(JSDK2.0).
logs/mod_jserv.log - The log file created and used by the Apache module, mod_jserv.so.
logs/jserv.log - The log file created and used by the servlet engine, JServ.
mod_jserv.so
Mod_jserv is the add-on module to Apache that communicates with the servlet engine,
JServ. It converts browser HTTP requests to servlet AJP requests then converts servlet
AJP responses to HTTP responses and returns them to the client browser. Mod_jserv has
a ".so" suffix because it is a Dynamic Shared Object (DSO), an NMXL on MPE. Mod_jserv
is written in C and has the same structure as other Apache compiled-in modules. Because
it is a DSO, it is loaded and run at Apache startup or restart.
ApacheJServ.jar
This is the "servlet engine," a 100% pure java application that executes servlets. This
servlet engine executes like a regular Java application with a static main method in class
org.apache.jserv.JServ. This version of the servlet engine, Apache JServ 1.1, executes
servlets that are compliant with JavaSoft's Java Servlet APIs, version 2.0. The servlet
engine forwards AJP client request data to the requested servlet and then forwards the
servlet response back to the AJP client.
Java Servlet Development Kit 2.0
This version of Java Servlets for MPE/iX uses the class definitions from Sun's Java Servlet
Development Kit 2.0 (JSDK2.0). JSDK2.0 is a Sun product that can be downloaded for
free from Sun's web site. For your convenience, the JSDK2.0 class definitions are installed
as part of Java Servlets for MPE/iX in their complete and unmodified form. These servlet
classes come packaged by Sun in a Java archive file, jsdk.jar. Any version of the servlet
classes other than JSDK 2.0 (past, present, or future version) may not work with this