netadmin Utility

Note

For a more detailed description of netadmin, refer to User's Reference: Administration.

The Network Administration Utility netadmin allows you to configure Reality networking by adding, editing and deleting Reality routing entries.

To run the utility, enter netadmin at the Command Prompt.

Note

Only users with Administrator privilege are allowed to execute netadmin.

The following main menu is displayed:

NEC NETWORK ADMINISTRATION - MAIN
1. Destination Hosts
2. Alternative Host Lists
3. Listening Ports
4. Remote Databases
5. Local Databases
6. Session Manager Options
7. Refresh Session Manager
8. Defaults
9. Diagnostics
Select option [1-9 / q] :

This menu lists the Reality routing entries which can be administered using netadmin.

1. Destination Hosts
A Destination Host entry defines a route to a particular remote system, allowing outgoing connections to be built to it.

2. Alternative Host Lists
An Alternative Host entry contains a list of equivalent destination systems, in the order in which connection is to be attempted.

3. Listening Ports
A Listening Entry defines a route to the local system allowing smanager to accept incoming calls.

4. Remote Databases
A Remote Database entry identifies a Reality database on a local or remote host.

5. Local Databases
A Local Database entry specifies the version of Reality to be used when logging in remotely.

6. Session Manager Options
To change Reality session manager options.

7. Refresh Session Manager
To request smanager to restart its listening ports. This must be used after changes to listening entries.

8. Defaults
To display and change the default database, realman folder and the default version of Reality.

9. Diagnostics
To display a submenu showing diagnostic options including: Trace Enable, Trace File, All Trace Levels, Trace Flags, Trace Levels.

q To exit the utility.

Session Manager Options

Network Administration Utility netadmin option 6 - 'Session Manager Options' allows you to change the options which control the working functionality of smanager.

Selecting this option displays a list of current smanager values. For example:

Default protocol                : TELNET
Default Interface               : SOCKETS
Default Transport               : TCP
Default port                    : 23
Default login prompt            : %m% (%d%) : Login please :
Default login timeout           : 6
Event log, in REALROOT\files    : Event.log
Switch-over size of event log   : 1048576
Session log, in REALROOT\files  : Session.log
Switch-over size of session log : 1048576

Note

'Default Interface' and 'Default transport' are currently fixed and are consequently not prompted for.

  1. First you are prompted to change the default applications protocol used to communicate with the remote software:

    1. TELNET
2. DDA
Select protocol [1-2 / (1) / q] :

    Enter a menu number to select the applications protocol required to communicate with the remote software. Press RETURN to retain the current value.

  2. Enter the port number [PortNumber / (23) / q] :

    Enter the port to be used by Destination host and Listening port entries which use the protocol selected above and for which no port has been specified, or press RETURN to retain displayed value.

    The default, if no value is given, depends on the default protocol: if the default protocol is TELNET, the default is "23"; if the default protocol is DDA, the default is "1203"

  3. Enter default login prompt [Prompt/(Welcome to %m% (%d%) : Login please : ) / q] :

    Enter the logon prompt message to be used by Listening entries for which no prompt has been specified, or press RETURN to retain displayed value.

    The message should be a alphanumeric text string containing '\r' for a carriage return and '\n' for a line feed. %m% specifies the machine system name. %d% specifies the default database name.

  4. Enter login timeout [ Seconds / (6) / q] :

    Enter the timeout in seconds. This is the period of time within which a user must login to the system, after the login prompt has been displayed, before the terminal is disconnected. The default, if no value is given, is 60 seconds. Press RETURN to retain displayed value.

  5. Enter event log name [(Event.log) / q] :

    Enter the name of the event log file in %REALROOT%\files. Press RETURN to retain displayed value.

  6. Enter switch-over size of event log [Bytes /1048576/ q]:

    Enter the maximum size (in bytes) of the event log. The default value is 1,048,576. If the existing file is larger than this maximum, the existing file is renamed with the prefix "Old_" and a new file created.

    Note

    Session manager switches when the log reaches the maximum size.

  7. Enter session log name [File / (Session.log) / q] :

    Enter the name of the session log file in %REALROOT%\files. Press RETURN to retain displayed value.

  8. Enter switch-over size of session log [Bytes / (1048576) / q]:

    Enter the maximum size (in bytes) of the session log.

    The default value is 1,048,576. If the existing file is larger than this maximum, the existing file is renamed with the prefix "Old_" and a new file created.

    Note

    Session manager switches when the log reaches the maximum size.

The complete set of smanager options is then displayed:

Default protocol                : TELNET
Default Interface               : SOCKETS
Default Transport               : TCP
Default port                    : 23
Default login prompt            : %m% (%d%) : Login please
Default login timeout           : 6
Event log, in REALROOT\files    : Event.log
Switch-over size of event log   : 1048576
Session log, in REALROOT\files  : Session.log
Switch-over size of session log : 1048576
Do you wish to commit this [y / (n)] :

Enter y to save these changed options or n to discard the changes. You are then returned to the main menu.

Specifying defaults

Network Administration Utility netadmin option 8 - 'Defaults' allows you to set default Reality parameters.

Selecting this option displays the menu:

Northgate NETWORK ADMINISTRATION - DEFAULTS
1. Default database           : DefaultDatabaseName
2. Path to realman directory  : RealmanDirectory
3. Default release of reality : DefaultRelease

Select action [1-3 / q] :

The parameters requiring set up are as follows:

Default database
The database to which smanager connects, unless the @database syntax is used.

Path to realman directory
The folder containing the Reality software on the Windows system.

Default release of Reality
The default (live) version of Reality.

At the Select action [1-3 / q] prompt on the 'Northgate Network Administration -Defaults' screen, enter 1 to set the default database.

The following sequence of prompts is displayed. Database names are displayed in lists of up to 20, followed by a prompt. For example:

1. admin
2. personnel
3. payroll
Select database [1-3 / 0:db / n:none / q] :

The last list of entries is followed by End of list.

Enter the number of the listed database you require as the default, or press RETURN to display the next list. Enter 0 to select the current default database, or n for no default.

Having entered a number, for example, number 3, the value is saved and you are returned to the Northgate Network Administration - Defaults menu which now displays the selected default. For example:

1. Default database           : payroll
2. Path to realman directory  : realmanDirectory
3. Default release of reality : DefaultRelease

At the Select action [1-3 / q] prompt on the Northgate Network Administration -Defaults screen, enter 2 to set up the path to the Reality folder. The following prompt is displayed.

Enter the absolute path to the realman directory [Path/(CurrentDefault)/q)
>>

Enter the requested path, for example, d:\realman, or press RETURN. The path entered is verified to confirm that it exists and is then saved and you are returned to the Northgate Network Administration - Defaults menu which displays the selected path to the Reality folder. For example:

1. Default database           : DefaultDatabaseName
2. Path to realman directory  : d:\realman
3. Default release of reality : DefaultRelease

At the Select action [1-3 / q] prompt on the Northgate Network Administration -Defaults screen, enter 3 to set up the default release of Reality.

The following sequence of prompts is displayed. Database names are displayed in lists of up to 20, followed by a prompt. For example:

1. 8.1{x}
2. 9.0{x}
Select default release [1-2 / q] :

The last list of entries is followed by End of list.

Enter the number for the required release, or press RETURN to display the next list.

Having entered a listed number, for example, 2, you are returned to the Northgate Network Administration - Defaults menu which now displays the selected default. For example:

1. Default database           : DefaultDatabaseName
2. Path to realman directory  : realmanDirectory
3. Default release of reality : 15.5