Installing an ECDA server as a Windows service

ECDA does not automatically create the server as a Windows service. However, you can run the ECDA Option for ODBC server and the Mainframe Connect DirectConnect for z/OS Option server as a Windows service. The following describes how to add, start, stop, and remove ECDA as a Windows service.

NoteIf you set up an ECDA server as a Windows service using ServiceWrapper, you must remove the Windows service using the ServiceWrapper utility. The InstallShield Uninstall process does not remove the Windows service.

Add an ECDA server as a Windows service

To add ECDA as a Windows service use the ServiceWrapper utility.

StepsTo add an ECDA server as a Windows service

  1. Go to the installation directory where the ServiceWrapper is located:

    c:\<install_dir>\DC-15_0\bin 
    
  2. Execute the ServiceWrapper utility:

    ServiceWrapper.exe --install <service_name> --user=<userid> 
    --password<password> <installation directory>\DC-15_0\bin\DCStart.bat 
    -S<dc_server_name>
    

    where:

    • service_name is the Windows service name

    • userid is the user name for the service that will run

    • password is the password for the userid

    • installation directory is the target installation directory where you installed ECDA

    • dc_server_name is the name of the DirectConnect server

    For example:

    ServiceWrapper.exe
    --install dcw2ksrv
    --password=password
    C:\<install_dir>\DC-15_0\bin\DCStart.bat -Sdcw2ksrvd
    

    NoteYou must specify the .bat suffix for DCStart.

Starting an ECDA server as a Windows service

NoteStarting and stopping the ECDA server as a Windows service on Windows XP and Windows 2000 may generate the following in the Windows Event Log:

“The description for Event ID (11) in Source ( ) cannot be found. The local computer may not have the necessary registry information or message DLL files to display messages from a remote computer. The following information is part of the event: DC_150.”

StepsTo start an ECDA server as a Windows service

  1. Select Start | Settings | Control Panel | Administrative Tools | Services.

  2. Select the name of the Windows service you installed, right click, and select Properties.

  3. Select the Log On tab and verify “This Account” is selected and that the user name is the same as you specified while adding the Windows service.

  4. If the Windows service fails, use the Recovery tab to specify any actions.

  5. Select the General tab to provide a description of the Windows service and to specify whether the Windows service is to start automatically or manually Click Start to start the Windows service.

Stopping an ECDA server as a Windows service

StepsTo stop an ECDA server as a Windows service

  1. Select Start | Settings | Control Panel | Administrative Tools | Services.

  2. Select the name of the Windows service you want to stop and select Stop the service.

Removing the ECDA server as a Windows service

StepsTo remove the ECDA server as a Windows service

NoteSybase recommends that you stop the Windows service before you execute the utility to remove it.

  1. Go to the installation directory where the ServiceWrapper is located:

    C:\<install_dir>\DC-15_0\bin 
    
  2. Execute the ServiceWrapper utility:

    DC-15_0\ServiceWrapper.exe --uninstall <service_name>
    

    where service_name is the Windows service name.