tcl.network-setup Verb: Access/TCL

tcl.network-setup

Command tcl.network-setup Verb: Access/TCL
Applicable release versions: AP 6.2
Category TCL (746)
Description allows the setup and control of a Pick network. If no arguments are supplied, a menu is displayed. This is the normal form of operation. See the section "network, General", for a discussion of the important notions of the network configuration.


Using the menus :
All operations are controlled through menus. If the terminal allows it, arrow keys can be used where indicated:
ENTER Validate the highlighted choice.
number From 0 to 9. Select the corresponding choice. '0' selects the option 10.
CTRL-N Move cursor down. (down arrow)
CTRL-B Move cursor up. (up arrow)
CTRL-X Cancel. Applicable only when input is requested.
ESC Quit. Go back to previous menu, or back to TCL. This key can be used to terminate all menus.
Q Quit. Go back to previous menu.
X Exit. Go back to TCL from any menu.

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


Screen layout :
The screen is divided in two sections:
- The menu section, where menus are displayed.
- The message section, where results, messages or help are displayed.


Definitions :
host
A definition for a local or remote Pick machine. There should be one for each system.


Main Menu
1 Start network 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.

2 Stop network 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 & writes per second.

5 List all hosts
Displays an access listing of all defined hosts, both the local and all remotes.

6 Print all hosts
Lists all hosts to the currently selected printer.

7 Define local host
Configure the local netork hosts. If you are defining an entire network, use option 9 Define all hosts. The following input fields are requested:

Host Name :
Any alpha-numeric string. This will be the Pick name of the local host. This field defaults to the name of the Unix machine if no local host is defined.
Optional Host Description :
An optional description of the host. The physical description of the machine or a description of it's location, or the name and number of it's system administrator would be helpful here.
TCP Name/Address :
The TCP Name/Address where the Pick machine exists. For the server, this should be the local Unix host name.
TCP Service Name/Number :
The TCP service number. Normally, the default of "pnfs" is correct as this is the default Pick service name. An alternate service is only necessary if there is more than one Pick virtual machine on the same Unix box.
Options :
These are driver-specific options. These may be left blank in the simplest case.
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 will provide a good balance between too many TCP connection in TIMEWAIT state and too few server processes. Note that server process remain bound to it's client when it holds item locks for that client, regardless of the Accept Timeout value.
Initial Server Processes :
The 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 :
The host ID number is used to differentiate between different virtual machines on the same unix host. If you only have one Pick virtual machine on each unix machine, this number is not needed. If you have more than one Pick 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.

8 Define remote host
Configure the local netork hosts. After choosing this option, another menu appears asking which host to edit as well as a "New Host" option to create a new host. Select the "New Host" option when intially configuring a network. Next, the following input fields are requested:

Host Name :
Any alpha-numeric string. This will be the Pick name of this remote host.
Optional Host Description :
An optional description of the host. The physical description of the machine or a description of it's location, or the name and number of it's system administrator would be helpful here.
TCP Name/Address :
The TCP Name/Address where the Pick machine exists.
TCP Service Name/Number :
The TCP service number. Normally, the default of "pnfs" is correct as this is the default Pick service name. An alternate service is only necessary if there is more than one Pick virtual machine on the same Unix box.
Options :
These are driver-specific options. These may be left blank in the simplest case.

The host ID number is used to differentiate between different virtual machines on the same unix host. If you only have one Pick virtual machine on each unix machine, this number is not needed. If you have more than one Pick 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.

9 Define all host
Configure all hosts on a Pick network. Use this option to configure an entire Pick 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 seperate virtual Pick machine. See menu optio 7 for details for each prompt.

10 Dump host file
A tape is selected, and network items in the dm,hosts, file are dumped to it.

11 Load host file
A tape is selected, and items prepared by option 10 above are loaded from that tape.

12 Declare local host
After network host items are loaded from tape during option 11 above, the user must tell the system which host item describes the local Pick virtual machine. This option presents the user with a list of hosts, the user pick's one the one that describes this machine.

13 Exit
Exits the program


Non Menu Operation :
It is possible to perform some operations from TCL by specifying a 'command' on the TCL line. This for is useful to perform some automatic commands in macros.

'command':

start
Start the local server processes.

stop
Stop all local server processes.

status
Display the status information for all local server processes.

statistics
Display the transaction statistics for all local server processes.
Syntax network-setup {{command}}
Options Q Quiet. Valid only for the non menu operation. Supresses all messages.
Example
Purpose
Related tcl.:kill-network
tcl.:start-network
tcl.:kill-node
tcl.:restart-node
tcl.:init-network
tcl.net-status
tcl.network-status