network-setup utility

The network-setup utility allows the setup and control of a D3 network. If no arguments are supplied, a menu displays. This is the normal form of operation.

Syntax

network-setup {{command}} {(options}

Parameter(s)

options

(Quiet) Valid only for nonmenu operations. Suppresses all messages.

Using the Menus

All operations are controlled through menus. If the terminal allows it, arrow keys can be used where indicated:

ENTER	Validates the highlighted choice.
`number`	Selects (from 0 to 9) the corresponding choice. Note: The number 0 selects the option 10.
CTRL+N	Moves cursor down (down arrow).
CTRL+B	Moves cursor up (up arrow).
CTRL+X	Cancels. Applicable only when input is requested.
Esc	Quits and returns to previous menu, or back to TCL. This key can be used to terminate all menus.
Q	Quits and returns to previous menu.
X	Exits and returns to TCL from any menu.

When the cursor is moved to a new field, a short help displays in the message area.

Screen Layout

The screen is divided in two sections:

Menu section, where menus are displayed
Message section, where results, messages, or help are displayed

Definitions

A host is a definition for a local or remote D3 machine. There should be one for each system.

Main Menu

`1 Start servers`	Starts up all local network servers. Before running this command, it is necessary to define the network using the Define local hosts and Define remote host options. The server status is automatically displayed after network servers are started. Note: Local servers must be started before a remote server can have access to the local database.
`2 Stop servers`	Stops all local network servers.
`3 Server status`	Displays the status of all local servers.
`4 Server statistics`	Displays transaction statistics for all local server processes, such as reads and writes per second.
`5 Server pid status`	Displays the UNIX process status of each server process. Note: The UNIX processes all show to have been spawned by the UNIX command, which started the primary server. This is due to the way the servers are configured and does not indicate an error.
`6 Network status`	Displays remote files open by each process.
`7 Define the network`	Allows the user to define the way the network is set up. This submenu is documented below.
`8 Exit`	Exits and returns to TCL.

Define the Network

`1 List all hosts`	Displays an AQL listing of all defined hosts, both the local and all remotes.
`2 Print all hosts`	Lists all hosts to the currently selected printer.
`3 Define local host`	Configure the local network hosts. If you are defining an entire network, use option 5 Define all hosts. These input fields are requested:
	Host Name	Any alphanumeric string. This is the D3 name of the local host. This field defaults to the name of the UNIX machine if no local host is defined.
	Optional Host Description	Optional description of the host. The physical description of the machine or a description of its location, or the name and number of its system administrator would be helpful here.
	TCP Name/Address	TCP name/address where the D3 machine exists. For the server, this should be the local UNIX host name.
	TCP Service Name/Number	TCP service number. Normally, the default of 1598 is correct, as this is the default D3 service name. An alternate service is only necessary if there is more than one D3 virtual machine on the same UNIX box. Note: If a firewall is enabled on the specified server, the TCP port must be allowed entry through the firewall.
	Security Options	Tunes the security parameters of the server. Without any parameters, remote users may connect and disconnect freely and are given the same permissions as they have on their original client machines. Each open request from a client machine passes the retrieval and updates keys assigned to the user on that client to the server. The server then utilizes those client keys to open the requested file. If the a option is used, then the client retrieval and update keys are ignored, and the connection is refused completely if the passed user name and password do not match a user/password combination on the local server. The server looks for: ClientHostName: ClientUserName or ClientUserName when looking for a user match. If the user name and/or password must be different on the local server than on the remote client, then the client user can utilize the set-remote-user command to perform automatic user/password mapping when connecting to that server. If the h option is not used, then the server disconnects unused connections after a certain time period. In this situation, it may be unclear to the administrator which connections are being utilized by which remote users. If the h option is set, then all connections are held until the remote client logs off. This requires one server for each remote client, but helps prevent snooping and spoofing security problems, and makes system administration easier as the list-users command always shows the connected users.
	Transmit Timeout	Time (in seconds) allowed for each remote operation. After this time, the client assumes the server is down and follows the error path. This value should be increased when the server is slow and `no response` errors are randomly encountered.
	Accept Timeout	Time (in seconds) during which a server process remains bound to a client when no operations are performed. A setting of 0 disconnects after every operation and is not recommended. For most situations, a value between 1 and 10 provides a good balance between too many TCP connection in timewait state and too few server processes. Note: Server process remains bound to its client when it holds item locks for that client, regardless of the Accept Timeout value.
	Initial Server Processes	Number of server processes that are started when the network is started. To change the number of servers, you must shut down the network, change this number, and then restart the network.
	Host ID Number	Used to differentiate between different virtual machines on the same UNIX host. If you only have one D3 virtual machine on each UNIX machine, this number is not needed. If you have more than one D3 virtual machine on a UNIX host, then pick small numbers (less than 128) for each virtual machine on that host.
	Confirm (y/n/q)	`y` to confirm the host modification. `n` to go back to any of the previous fields. `q` to quit and abandon.
`4 Define remote host`	Configure the remote network hosts. After choosing this option, another menu displays asking which host to edit as well as a New Host option to create a new host. Select the New Host option when initially configuring a network. These input fields are requested:
	Host Name	Any alphanumeric string. This is the D3 name of this remote host.
	Optional Host Description	Optional description of the host. The physical description of the machine or a description of its location, or the name and number of its system administrator would be helpful here.
	TCP Name/Address	TCP name or address where the D3 machine exists.
	TCP Service Name/Number	TCP service number. Normally, the default 1598 is correct as this is the default D3 service name. An alternate service is only necessary if there is more than one D3 virtual machine on the same UNIX box.
	Transmit Timeout	Time (in seconds) allowed for each remote operation. After this time, the client assumes the server is down and follows the error path. This value should be increased when the server is slow and `no response` errors are randomly encountered.
	Host ID	The host-ID number is used to differentiate between different virtual machines on the same UNIX host. If you only have one D3 virtual machine on each UNIX machine, this number is not needed. If you have more than one D3 virtual machine on a UNIX host, then pick small numbers (less than 128) for each virtual machine on that host.
	Confirm (y/n/q)	`y` to confirm the host modification. `n` to return to any of the previous fields. `q` to quit and abandon.
`5 Define all host`	Configure all hosts on a D3 network. Use this option to configure an entire D3 network from one station. This option, when combined with the next three, allow a user to enter configuration data for all hosts, both this local one and all remotes, then dump the information to tape. That tape is then loaded on each separate virtual D3 machine. (see menu option 7).
`6 Dump host file`	A tape is selected, and network items in the dm,hosts, file are dumped to it.
`7 Load host file`	A tape is selected, and items prepared by option 6 above are loaded from that tape.
`8 Declare local host`	After network host items are loaded from tape during option 7 above, the user must tell the system which host item describes the local D3 virtual machine. This option presents the user with a list of hosts, the user picks one the one that describes this machine.
`9 Remove Host`
`10 Back to main menu`	Exits back to the main menu.

Nonmenu Operation

It is possible to perform some operations from TCL by specifying a command on the TCL line. This is useful to perform some automatic commands in macros.

Command	Description
start	Starts the local server processes.
stop	Stops all local server processes.
status	Displays the status information for all local server processes.
statistics	Displays the transaction statistics for all local server processes.