seedispatch: start a dispatcher

Syntax

seedispatch parameter parameter . .

Starts a self-hosted dispatcher and optional start listener, SEP, and console viewer processes. An event monitor starts if one is not already started.

Parameters

-automatic

Automatically start self-hosted SEP process.

-listener

Automatically start a listener process.

-manual

A self-hosted SEP process must be started manually. This is the default.

-nobanner

Do not display utility welcome and copyright messages.

-nocv

Do not start a console viewer process. If this parameter is omitted, a console viewer process starts automatically.

-nocvchild

Starts the console viewer in a separate console window.

-nowait

Do not wait for key press before existing. Used in conjunction with -was.

-region:<region-name>

Name of the region to associate with a started listener and console viewer. The default is ESDEMO.

-showtime:<number-of-columns>

Passed to the started console viewer process, or ignored if -nocv is specified. Prefixes each console message with the date and time it was created.

You can also enter a numeric value to specify the width of the console window. If the value for <number-of-columns> is greater than the maximum width supported for a Windows Console, the value is set to the maximum width.

-usedb:<database-server-instance>

Name of the database server instance that hosts the region database. For example:

Default database server on the local machine:	`-usedb`
Default database server on the local machine, identical to `-usedb`:	`-usedb:(local)`
Specific database server on the local machine:	`-usedb:(local)\SQLEXPRESS`
Default database server instance on a specific machine (SC1 used in example)	`-usedb:SC1`
Specific database server instance on a specific machine (SC1, SQLEXPRESS used in example for machine name, database server name)	`-usedb:SC1\SQLEXPRESS`

Note: Parameter values are not case sensitive.

-verbose: The command output displays all of the messages that the command generates.

-was: Use a WAS-hosted dispatcher instead of self-hosting. With this parameter, seedispatch starts the console viewer and/or listener, depending on other command-line parameters. A WAS process running under IIS handles dispatching.
-wassep: Use a WAS-hosted SEP. This parameter is only required if -was is not specified. A WAS-hosted dispatcher always uses a WAS-hosted SEP.

Using a configuration file with seedispatch

You can use a seedispatch.config configuration file to configure the behavior of seedispatch. In the current release, the maximum TCP and named pipe connections supported by the exposed WCF services, the default port for the WCF services, and CTF tracing can be configured.

The following statements show how to use a configuration file to specify a maximum of 20 connections for each protocol.

<configSections>
  <sectionGroup name="MicroFocus.SEE.Dispatch">
    <section name="services" type="System.Configuration.NameValueSectionHandler" />
  </sectionGroup>
</configSections>
...
<MicroFocus.SEE.Dispatch>
  <services>
    <add key="NetNamedPipe.maxConnections" value="20" />
    <add key="NetTcp.maxConnections" value="20" />
  </services>
</MicroFocus.SEE.Dispatch>
...

Example: Starting a self-hosted dispatcher

The following command:

Starts a self-hosted dispatcher
Automatically starts a self-hosted SEP
Automatically starts a listener and console viewer for the ESDEMO region

seedispatch -region:ESDEMO -usedb:(local)\SQLEXPRESS -automatic
 -listener

Example: configuring a WAS-hosted dispatcher and SEP

The following command configures a WAS-hosted Dispatcher and SEP. This example starts a listener and console viewer for the ESDEMO region. The console viewer starts with a 132-column wide window and the date and time of creation prefixes each message output.

Note: The -nowait parameter terminates the seedispatch process once the other processes start.

seedispatch -was -nowait -region:ESDEMO -usedb:(local)\SQLEXPRESS 
-automatic -listener -showtime:132