Software AG Infrastructure 10.11 | Concepts | The Java Service Wrapper
 
The Java Service Wrapper
The Java Service Wrapper is an application developed by Tanuki Software, Ltd. Some Software AG products use the Java Service Wrapper to:
*Start and stop the Java Virtual Machines (JVM) in which they run. You can configure Java startup parameters such as heap size and classpath.
*Record the console output from the JVM in a log file. This log includes stack traces that the JVM produces when a process throws an exception and any thread dumps you generate from the JVM. The wrapper log is particularly useful when a webMethods product runs as a Windows service, because console output is not normally available to you in this mode. The log file is named wrapper.log.
*Monitor the JVM for various fault conditions and take a specified action when a fault occurs. You can do the following:
*Detect a nonoperational (hung) JVM. After the Java Service Wrapper starts the JVM, it pings the JVM periodically to check whether it is operational. If the JVM does not respond to a ping within a specified interval, the Java Service Wrapper assumes that the JVM has stopped functioning and restarts it. Each Software AG product configures this feature differently; some disable it entirely.
*Detect thread deadlocks in the JVM. A thread deadlock occurs when two or more threads try to lock resources in a manner that causes all threads to wait indefinitely. The Java Service Wrapper can monitor the JVM for a deadlock condition and take a specified action (for example, restarting the JVM) when the condition occurs. For most Software AG products, this feature is disabled by default.
*Detect specified messages in the console output. The Java Service Wrapper can monitor the console output and take a specified action when a given string of text appears. This feature is often used to watch for out-of-memory messages.
*Enable you to generate a thread dump when the JVM is running as a service under Windows.
This guide discusses the Java Service Wrapper as it is used by Software AG products that run on the Software AG Common Platform. The documentation for a product might contain additional instructions for using the Java Service Wrapper for that product.
Note:
For information about Software AG products that use the Java Service Wrapper but do not run on the Software AG Common Platform, see the documentation for those products.