The SYSGEN configuration utility/Node

From CometWiki

[NODE]

Minimum Requirements: The NAME= segment title is required. If you are using CometServeNLM, CometServe32, or the Comet Security Server, the SERVER= segment title is required if the Comet node is in a network The other segment titles are optional Refer to the minimal INI file to see the minimum requirements to configure Comet.

The NODE group contains information about a specific node, such as the node name, descriptive fields, path name where the node’s configuration is to reside, phone/fax numbers, user information, Internet address, and information on how the server(s) will be used by this node. As described below, some of these fields are required while others are optional. The required fields are stored in the CFG file, while the optional fields are not.

This group contains the following segment titles:

Name = node-name;
Server = server-number,usage-code;
Desc = description-of-node;
Misc = miscellaneous-information-about-node;
Path = path-where-CFG-file-is-to-reside;
Phn# = phone-number;
Fax# = fax-number;
User = user-information;
Internet Addr = Internet-address;

For example:

[NODE]

Name = SALES;                         name of the node
Server = N01,S;                       login to N01, set Comet security
Server = N02,F;                       login to N02, for Type S directory access
Desc = Sales, Order Status Inquiry;   describes the node’s use
Misc = Compaq Pentium 100 MHz;        describes the system
Path = ;                              SALES.CFG will reside in start-in diretory
Phn# = 888-555-1212;                  phone number
Fax# = 888-555-1313;                  fax number
User = Sales Department;              user
Internet Addr = ;

Segment Titles

Name = node-name;

           Required.

Identifies a specific node in a network. The node-name parameter may be up to 30 characters long, although only the first 8 characters are used.

The node-name parameter is used in two places:

1. When the INI file is processed, the node-name is used to create/update the configuration file name. For example, if the node-name is SALES, SYSGEN creates/updates a configuration file named SALES.CFG.

2. When you start Comet on a specific node, use the node-name with the “profile name” (/PN=) startup option to specify which configuration file should be used for that node. For example:

C:\COMET\COSW /PN=SALES

Server = server-number,usage-code;

Optional for single-user Comet systems.

Required for networked Comet systems.

           Defines how each server is used (if at all) by this node. The following table describes the two parameters: 

Parameter

Description 

server-number

This is the number of the server used by this node, in the form N01 through N99.  If a node will access multiple servers, multiple SERVER commands are required. 

The server-number used here must have been previously defined under the [SITE] segment. If it has not been defined, SYSGEN will report an error when the INI file is processed.

usage-code

This code defines how the server will be used.

· C specifies that this server will be used for CFAM directory file access. This is the preferred method of configuration.

· F specifies that this server will be used for type-S directory file access. This type is used for Novell servers and older Windows installations. The last version of the CometServe32 file server for Windows to support this type is 5.08.

· S specifies that this server will be used for security (license validation). This may be combined with either C or F if the server is to be used as both a security server and a file server: SC or SF.

Example 1:

Defining a server for both type-S directory file access and security:

[NODE] SERVER = N01,CS; get files and security from N01

Example 2:

Defining multiple servers. Security will come from N01, while CFAM directory file access will only come from N02 and N03.

[NODE] SERVER = N01,S; get security from N01 SERVER = N02,C; get files from N02 SERVER = N03,C; get files from N03

Example 3:

Only one source of security may be specified for any node. The following specification would result in an error.

[NODE]

Server = N00,SF; get security and files from N00

Server = N02,S; get security from N02 (ERROR)

Furthermore, only one type of file server may be specified in each Server statement. The following specification would result in an error.

[NODE]

Server = N02,FC; Server serves both CFAM and type S files (ERROR)

Instead you would use two separate Server statements. Note: Each File Server used by a node requires its own file server license. Thus a user with the following configuration would consume two licenses.

SERVER = N02,CS; get security and CFAM files from N02 SERVER = N02,F; also get some old type S files from N02 - not recommended

Desc = description-of-node;

Optional.

Provides a description of the node. The description-of-node parameter may be up to 30 characters long.

Misc = miscellaneous-information-about-node;

Optional.

Provides miscellaneous information about the node. This parameter may be up to 30 characters long.

Path = path-where-CFG-file-is-to-reside;

Optional.

Designates a path for SYSGEN to store the CFG file. It is recommended that this field remain empty, so that SYSGEN can store the CFG file in the "Start in" directory designated in the desktop icon used to launch Comet.

Phn# = phone-number;

Optional.

Provides a phone number for the user of the node. The phone-number parameter may be up to 15 characters long.

Fax# = fax-number;

Optional.

Provides a optional fax number for the user of the node. The fax-number parameter may be up to 15 characters long.

User = user-information;

Optional.

           Provides information about the user, such as the user’s name. The user-information parameter may be up to 30 characters long.

Internet Addr = Internet-address;

Optional.

Provides an Internet address/e-mail address for this node. The Internet-address parameter may be up to 64 characters long