As a general rule, the server runs as a "service" as appropriate for the platform. For example, under Microsoft Windows, this is a Windows Service.
It is possible to run the server under the command shell. To do so, you need access to the shell. The location containing the server software (usually the bin directory under the installation point) must be in the execution path of the operating system.
The command to start the server is:
iwsrv <configname>
Adding the parameter –c sends traces to the command shell as print lines. For example, to start the test configuration with traces visible:
iwsrv test [–c] [-b]
When running in the command shell, you control the server by typed commands in addition to the run time console. These commands are designed to assist in resolving issues, and many are technical in nature. Some of the key commands are:
Command | Description |
---|---|
copy <from> <to> | Copies a file between locations. |
errors | Displays the last few errors reported by the server. |
hotbackup | Displays the state of the hot backup system. |
info | Displays monitor information. |
line | Draws a line. This makes reading of the display simpler. |
manifest <jarname> | Displays the manifest of the named jar file. The name can be a full path name or a simple jar name in the classpath. |
memory | Displays statistics on memory in use. |
pools | Displays the contents of key internal resource pools. |
quit | Exits the server. All listeners must have been stopped. |
refresh <listener name> | Restarts the listener with an updated local configuration. The listener should be started. |
rotatelogs | Rotates the trace logs. |
sregs | Displays manager and listener-level special registers and their values. Registers that are created as part of a document workflow, such as the source name of a document read by the file listener, are not shown. |
start [<listener name>] | Starts all listeners or the identified listener. |
Stats | Displays statistics. For standard operation, this shows a wall clock (response) time figure. iWay provides a measurement that extends the functionality of this command. |
stop [<listener name>] | Stops all listeners or the identified listener. |
threads | Lists execution "threads" currently being controlled by the server. This may not include threads started by auxiliary packages such as third party interfaces. This is often very useful after a STOP command to determine what might still be running. |
time | Displays the time in GMT. |
tool <toolname> [parameters] | Runs the specified tool. See Supplied Tools. |
iWay Software |