How to: |
You can run iWay Service Manager (iSM) in a command shell to debug and troubleshoot any errors that may occur.
On Windows, the iwsrv command starts iSM in a command window for debugging purposes. For reference, the following topic includes the full syntax of the iwsrv command.
Navigate to the iWay home bin directory. For example, on Windows, if iWay is installed in C:\Program Files\iWay61, go to
C:\Program Files\iWay61\bin
The syntax for the iwsrv command, which starts iWay Service Manager in a command window on Windows, is:
iwsrv [configuration] [-s service] [-l launch] [options]
where:
Is the name of the server configuration that is loaded for this instance. The default value is base.
Is the name of the service that is executed. Valid values are:
start. Starts the server configuration (default).
stop. Stops the server configuration.
install. Installs the server configuration.
remove. Removes the server configuration.
query. Queries the server configuration.
Specifies the launch method. Valid methods are:
java. Loads Java in a separate process and uses the JVM options, NT dependencies, and other preferences found within the iSM configuration that are configured through the console. For example:
iwsrv.exe base -s start -l java
script file. Specifies a script file that defines the run-time preferences. This script file must be located in the iWay Service Manager installation directory. For example:
iwsrv.exe base -s start -l iWay61.cmd
Both of the above uses of -l will force the service to load Java in a separate process. When the service is stopped, both iwsrv.exe and java.exe are terminated.
Specifies tracing or server back-up information. Valid values include:
-b. Indicates that Service Manager is a back-up server, for example:
iwsrv.exe base -s start -b
-c. Turns tracing on. In this mode, you can display useful error messages on the console. For example, you can display a message that says the Java Runtime Environment (JRE) is not properly installed. For example:
iwsrv.exe base -s start -c
-d. Limits tracing to debug only, for example:
iwsrv.exe base -s start -d
-f. [PATH] filters the system path when invoking JAVA. [RESTART] suppresses the JVM fault restart capability.
-h. iWay61 home directory.
-t. The amount of time (in seconds) to process service shutdown.
The following command starts a server configuration named test and sends traces to the command window as print lines:
iwsrv test -c