Starting and Stopping iWay Service Manager on Windows

In this section:

If you are not running on Windows, see Starting and Stopping Service Manager on UNIX, OS/400, and z/OS.

You can run Service Manager on Windows in one of the following ways:

On Windows, the startup procedure uses the configuration files as follows:

  1. The iwsrv executable program is run as a service or manually, for example:
    C:\Program Files\iWay61\bin\iwsrv.exe
  2. When Service Manager starts as a service or in a command window, it locates the required JAR files and the files you successfully registered.
  3. Service Manager loads the Java Runtime Environment (JRE) by looking for versions and locations in the Windows registry. Java version 1.6 is required.

Top of page

x
Starting and Stopping Service Manager as a Windows Service

When Service Manager is installed, a Windows service for the “base” configuration is created. By default, this service starts with Windows whenever you reboot the machine. You can manually start and stop the service as explained in the following procedures.

When running Service Manager as a Windows service, Service Manager runs in the background as the Local System account and remains running if you log off the machine. For assistance with troubleshooting, check the Event Viewer as explained in Diagnostics, Tracing, and Logging.

You can start the Service Manager service from either the Windows Services window or through the Start menu. You also can stop the Service Manager service from the Windows Services window or through the Start menu.

By default, the Service Manager service runs as the Local System account and starts automatically when you reboot the Windows machine. If you do not want Service Manager to start automatically with Windows, or you want to run Service Manager with a different user ID, see How to Change the Service Manager Windows Service Configuration.

Tip: To create Windows services for other configurations, see Managing Configurations.



x
Procedure: How to Start or Stop Service Manager From the Windows Services Window

To use the Services window to start or stop Service Manager as a Windows service:

  1. From the Control Panel, select Administrative Tools, and then Services.

    The Services window opens.

  2. To start Service Manager, right-click iWay Service Manager - base and select Start.

    The service status changes to started.

  3. To stop Service Manager, right-click iWay Service Manager - base and select Stop.


x
Procedure: How to Start or Stop Service Manager From the Windows Start Menu

To use the Windows Start menu to start or stop Service Manager as a Windows service:

  1. Select Start, Programs, and then iWay 6.1 Service Manager.
  2. To start Service Manager, select base, and then Start Service Manager - base.
  3. To stop Service Manager, select base, and then Stop Service Manager - base.


x
Procedure: How to Change the Service Manager Windows Service Configuration

To prevent Service Manager from starting automatically or to run Service Manager with a user ID other than Local System:

  1. From the Control Panel, select Administrative Tools, and then Services.

    The Services window opens.

  2. In the list, double-click iWay Service Manager - base.

    The iWay Service Manager-base Properties dialog box opens.

    1. To prevent Service Manager from starting automatically with Windows, change the Startup type to Manual.
    2. Click Apply.
  3. To run Service Manager with a user ID other than Local System:
    1. Click the Log On tab.
    2. Select the This account button.
    3. Specify the user ID and password that you want to run Service Manager.

      The user ID must be an administrator of the local machine.

      If you change the user ID under which Service Manager runs, ensure that the user ID has full NTFS permissions to the iWay61 directories.

  4. Click OK to close the dialog box.

Top of page

x
Starting and Stopping Service Manager in the Command Window

For debugging purposes, you can run Service Manager in a command window instead of running it as a Windows service.

The command window enables you to interact with Service Manager and displays diagnostic information about Service Manager processing.



x
Procedure: How to Start Service Manager in the Command Window

To start Service Manager in the command window:

  1. Open a command window and navigate to the iWay61\bin directory, for example:
    C:\Program Files\iWay61\bin
  2. At the command prompt, type the following command to start the base configuration:
    iwsrv

    Note: For other configurations, enter the configuration name after iwsrv. Configuration names are case-sensitive.

    Messages appear in the command window detailing the startup process. The following prompt appears when the start up is complete:

    Enter command:>

    If you receive errors similar to the following, Service Manager is probably already running as a service. You cannot run the same configuration at the same time as both a service and in the command window.

    ERROR (HTTP1) Unable to create server socket 9980:
    java.net.BindException: Address already in use: JVM_Bind
    ERROR (SOAP1) Unable to create server socket 9000:
    java.net.BindException: Address already in use: JVM_Bind


x
Procedure: How to Stop Service Manager in the Command Window

To stop Service Manager in the command window:

  1. Go to the following Service Manager prompt:
    Enter command:>
  2. At the Service Manager prompt, type the following:
    stop
  3. When any listeners that are running have stopped, type the following:
    quit

Note: If you close the command window without typing these commands, Service Manager stops. However, typing the commands is recommended.


iWay Software