emsntsreg


Utility

Purpose

Register or unregister the EMS server daemon as a Windows service.

This utility applies only to Microsoft Windows (all supported versions, including NT, 2000 and XP).

Syntax

emsntsreg /i [/a] service_name directory [arguments] [suffix] 
emsntsreg /r [service_name] [suffix] 

Remarks

Some situations require the EMS server to start automatically. You can satisfy this requirement by registering the server daemon with the Windows service manager. This utility facilitates registry.

Restrictions

You must have administrator privileges to change the Windows registry.

This command does not support space characters in directory paths or file names.

Location

Locate this utility program as an executable file in the EMS bin directory.

Parameter
Description
/i
Insert a new service in the registry (that is, register a new service).
/a
Automatically start the new service. Optional with /i.
service_name
Insert or remove a service with this base name.
When inserting a service, this parameter is required, and must be tibemsd.
When removing a service, this parameter is optional. However, if it is present, it must be tibemsd.
directory
Use this directory pathname to locate the tibemsd executable. Required.
arguments
Supply command line arguments to tibemsd. Optional with /i.
Enclose the entire arguments string in double quote characters.
suffix
When registering more than one tibemsd service, you can use this suffix to distinguish between them in the Windows services applet. Optional.
/r
Remove a service from the registry.

Register

To register tibemsd as a Windows service, run the utility with this command line:

 emsntsreg /i [/a] tibemsd directory [arguments] [suffix] 
 
 

Example 1

This simple example registers one service:

 emsntsreg /i tibemsd C:\tibco\ems\bin 

Example 2

This example registers a service with command line arguments:

 emsntsreg /i tibemsd C:\tibco\ems\bin "-trace DEFAULT" 

Example 3

This pair of example commands registers two services with different configuration files. In this example, the numerical suffix and the configuration directory both reflect the port number that the service uses.

 
emsntsreg /i tibemsd C:\tibco\ems\bin "-config C:\tibco\ems\7222\tibemsd.conf" 7222 
 
emsntsreg /i tibemsd C:\tibco\ems\bin "-config C:\tibco\ems\7223\tibemsd.conf" 7223 
 

Notice these aspects of this example:

Remove

To unregister a service, run the utility with this command line:

 emsntsreg /r [service_name] [suffix] 
 

Both parameters are optional. If the service_name is present, it must be tibemsd. To supply the suffix parameter, you must also supply the service_name. When both parameters are absent, the utility removes the service named tibemsd.

Command Summary

To view a command line summary, run the utility with this command line:

 emsntsreg 
 

Windows Services Applet

The Windows services applet displays the name of each registered service. For EMS services, it also displays this additional information:


TIBCO Enterprise Message Service™ User’s Guide
Software Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com