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 Historian, Cascade TextLogger, SCADALisp, and Gamma. This module is started automatically by them, 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, Using the Cascade DataHub, nsnames