Cogent API and Utilities: Version 4.1
Prev |  | Next

# nserve

nserve -- starts the Cascade NameServer.

## Syntax

nserve [`-DhirvVX`] [`-p `freqncy``] [`-s `freqncy``]

## Arguments

`-D`

  Do not detach from the console. Run in the foreground.

`-h`

  Print a help message and exit.

`-i`

  Run in isolation. Refuse tasks from other nodes. If `-r` is not specified, other nodes will still see tasks on this node.

`-p `freqncy``

  Poll for dead network nodes every `freqncy` seconds (default is 5).

`-r`

  Do not run a network redirector. No other name server on the network will see tasks on this node. This name server will still see tasks on other nodes.

`-s `freqncy``

  Check for dead name servers on live nodes every `freqncy` polls (default is 1).

`-v`

  Generate debugging output. Implies `-D`.

`-V`

  Print version number.

`-X`

  Exit immediately (normally used with `-V`).

## Returns

On success, nothing; on error, a message.

## Description

This module provides a network-wide name service for Cogent tasks. These tasks include, but are not limited to, Cascade DataHub, Cascade Connect, Cascade Historian, Cascade TextLogger, SCADALisp, and Gamma. This module must be run after the qserve module.

This module should be run before the TCP/IP Socket command is run. If Socket is started before nserve then a race condition may occur where a MS-Windows node connects via TCP but sees no nserve module running and incorrectly assumes that it is running without a Cascade DataHub. Normally qserve and nserve are placed in the `sysnit.N` file of the server. Names give tasks a method of identification on one or many PCs. The nserve task is an active name server, and (unlike QNX's passive nameloc module) notifies all its tasks of start and stop events which occur in other registered tasks.

The nserve program also allows access to other registered tasks' queues.

## Dependencies

qserve

## See also

Cascade NameServer, Running the Cascade DataHub, nsnames

Prev | Home | Next
nsnames | Up | qserve

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.