Network Configurator and Network Database [ RJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation
RJE User/Programmer Reference Manual
Network Configurator and Network Database
One of the features of the Network Configurator/Network Database is the
ability to define the network configuration once, store it away in an
IMAGE database and have it automatically used whenever you use the
network database. In addition, you can later alter the configuration and
store it for future use.
The data associated with the configuration is stored in an IMAGE database
in the PUB.SYS account. The data in the database is manipulated by means
of the Network Configuration Utility (NETCONF), which is also in the
PUB.SYS account. The Distributed Systems Network (DSN) products access
the database (read-only access) to determine the options selected. It
will be necessary, since the configuration information is kept in a
database, to periodically make a backup copy on magnetic tape, for
purposes of catastrophe recovery. It is recommended that a backup be
made whenever the network configuration is changed, since the database is
only updated by the Network Configuration Utility. (Note that NS X.25
3000/V Link only has read access.)
The Database
The network configuration information is held in an IMAGE database in the
PUB.SYS account. The database consists of the following files:
NETCON (Root File)
NETCON01
NETCON02
NETCON03
NETCON04
NETCON05
It will be necessary, since the configuration information is kept in a
database, to periodically make a backup copy onto magnetic tape, for
purposes of catastrophic recovery. It is recommended that the backup be
taken each time the network configuration is changed, since the database
is only updated by the Network Configuration Utility. (Note that NS X.25
3000/V Link only has read access.) By doing this, a secure backup will
be held of the latest network configuration.
The DBSTORE operation must be done by a user of the PUB.SYS account. It
is assumed that this user is also the network manager, as only the
network manager would have access to the database maintenance password.
The database should be "RELEASED" using DBUTIL, so that all users may
have read access to the database. Read access is necessary for the
:DSLINE command to execute properly.
The NETCONF Utility
The NS Network Configuration Utility (NETCONF) resides in the PUB.SYS
account. NETCONF obtains the following from the network manager: the
information necessary to describe the network connections, the parameter
values and options chosen at subscription time, and all information
related to the way the connections are going to be used.
The NETCONF utility can be run by any user with read access to the
database. Only the database creator has a write access to the database
and it is assumed that the creator is the network manager.
Database Organization. The network configuration data is arranged into
two sets (or tables) of information. The first set of data is known as
the Remote Node (RN) table and contains the relationships between the
destination logical node name, the logical device number (line
identifier), the X.25/X.21 PDN address of the destination node (assigned
by the PDN), and the remote node machine type. This table can have up to
2048 entries and it must have one entry for every relationship. For
example, if node FRED has a PDN address of 1234 and can be reached across
two separate DS lines, there must be one entry for each line.
Remote Node Name Logical Device Number PDN Address
-----------------------------------------------------------------------------------------
Fred 51 1234
Fred 52 1234
Similarly, if two different nodes can be reached across the same line (as
is probable when that line is connected to a PDN) then there will be an
entry for each node.
Remote Node Name Logical Device Number PDN Address
-----------------------------------------------------------------------------------------
Fred 51 1234
Joe 51 1235
The second set of data is known as the Line Characteristics (LC) table
and contains information pertaining to a particular line (logical device
number). There must be an entry in this table for every line from this
node and, unlike the RN table, each entry must be unique.
The relationship between the two tables is the line identifier (logical
device number). For every line identifier referenced in the RN table,
there should be an entry in the LC table, and vice versa. The Network
Configuration Utility warns of any unsatisfied or illegal relationships
when exiting; however, no attempt is made to insist on their being
satisfied.
The Commands. The Network Configuration Utility has eight permissible
commands. These are, ADD, CHECK, DELETE, EXIT, HELP, LIST, PRINT, and
UPDATE. Any of these can be input after NETCONF has issued its
identifying banner and may be abbreviated to one character. Any other
input is ignored. The mode of NETCONF is conversational. After one of
the commands has been specified, a series of prompts to the user is
issued, as appropriate, for the relevant inputs.
To terminate NETCONF command execution during an interactive session on
HP terminals, press [CTRL]-Y (hold the control key and press Y). This
action terminates the current command and prompts for another first-level
command.
NOTE The following description of the interactive dialogue, that is
initiated by these commands, is presented in a format similar to
the one used for the MPE Configuration Dialogue in appendix A of
the DS/3000 Reference Manual.
The A[DD] Command
This command is used to add a new entry to either the Remote Node (RN)
table or the Line Characteristic (LC) table. Note that only the creator
of the database can add entries to it. After specifying the ADD command,
the dialogue proceeds as follows:
Step Dialogue
No.
0 REMOTE NODE (RN) OR LINE CHARACTERISTICS (LC) TABLE?
Enter one of the following replies:
RN When this is specified, you will be adding an
entry to the RN table, and the dialogue
proceeds from there. Skip to step 1.0.
LC When this is specified, you will be adding an
entry to the LC table, and the dialogue
proceeds from there. Skip to step 2.0.
[ENTER] When you reply with the [ENTER] key, you will
receive the following prompt:
CONTINUING ADDING (YES OR NO)?
YES This response takes you back to the ADD prompt (step 0).
NO This response takes you out of the ADD command and
prompts for another first-level command.
INPUT MUST BE RN OR LC
If this message appears, the response was not one of the above.
You will be prompted again with the ADD prompt (step 0).
Adding to the Remote Node Table. The following prompts cover the remote
node characteristics.
Step Dialogue
No.
1.0 REMOTE NODE NAME?
Enter a logical node name. This name can be up to eight
alphanumeric characters (the first being an alphabetic character)
and it must refer to the same name by which the destination node
is to be referred when using the DSLINE command.
NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS
This message appears when the node name is greater than eight
alphanumeric characters or when the first character is numeric.
You will be prompted again for a logical node name (step 1.0).
1.1 REMOTE COMPUTER TYPE (HP3000 OR HP1000)?
[ENTER] The default remote computer type (HP 3000) is
used.
HP3000 The type of the logical node being addressed
is an HP 3000.
HP1000 The type of the Logical Node being addressed
is an HP 1000.
INPUT MUST BE HP3000 OR HP1000
This message is received if the response was not one of the
above. You will be prompted again for the remote computer type
(step 1.1).
1.2 LOGICAL DEVICE NUMBER TO BE USED?
Enter a line identifier (logical device number). This can be a
numeric value between 1 and 255, and it must refer to the logical
device number used on the DSLINE command.
LOGICAL DEVICE SHOULD BE IN THE RANGE OF 1 TO 255
This message appears when a line identifier that is not in the
range of 1 to 255 has been specified. You will be prompted again
for a logical device number (step 1.2).
Step Dialogue
No.
1.3 LINE TYPE (X25 OR X21)?
Enter one of the following replies:
X25 When this is specified, you will be prompted for the X.25
remote node address. Skip to step 1.3.1.
X21 When this is specified, you will be prompted for an X.21
remote node address. Skip to step 1.3.2.
INPUT MUST BE X25 OR X21
This message appears when the response was not one of the above.
You will be prompted again for the line type (step 1.3).
1.3.1 REMOTE X25 PDN ADDRESS?
Enter one of the following replies:
[ENTER] Either an X.25 network address is not needed
because the connection will be across a
point-to-point line, rather than a PDN; or
the default network address will be used if
the connection is across a PDN. (The default
address is NULL.) Skip to step 1.4.
X.25 PDN network This will be assigned by the relevant PDN
address across which you will be talking to the
logical node using the previously specified
line identification. It should be a numeric
address up to 14 digits in length, and it is
the actual PDN address of the logical node.
Skip to step 1.4.
X25 ADDRESS SHOULD BE UP TO 14 DECIMAL DIGITS
This message appears if the specified address is greater than 14
decimal digits or if a non-numeric network address was entered.
You will be prompted again for the X.25 PDN address (step 1.3.1).
Step Dialogue
No.
1.3.2 X21 PDN ADDRESS?
Enter one of the following replies:
[ENTER] The default X.21 Address (all blanks) is
used.
X.21 PDN network This address must be no more than 30
address characters in length.
X21 ADDRESS SHOULD BE UP TO 30 CHARACTERS
This message appears if the address entered was larger than 30
characters. You will be prompted again for the X.21 PDN address
(step 1.3.2).
1.4 CONTINUING ADDING (YES OR NO)?
YES This will take you back to the ADD prompt (step 0).
NO or This will take you out of the ADD command and prompt for
any another first-level command.
input
except
ADDITION COMPLETE
This message appears when the remote node characteristics have
been added to the RN table.
DUPLICATE ENTRY - NEW ENTRY NOT ADDED
This message appears when there was already an entry in the RN
table with these relationships.
DATA BASE IS FULL - NEW ENTRY NOT ADDED
This message appears when the database is full. To correct this
situation, exit from the utility and enlarge the size of the
IMAGE database.
Adding to the Line Characteristics Table. The following prompts cover
the general line characteristics.
Step Dialogue
No.
2.0 LOGICAL DEVICE NUMBER?
Enter a line identifier (logical device number). This can be a
numeric value between 1 and 255 and it must refer to the logical
device number used on DSLINE command.
LOGICAL DEVICE SHOULD BE IN THE RANGE OF 1 TO 255
This message appears if a line identifier not in the range 1 to
255 has been specified. You will be prompted again for a logical
device number (step 2.0).
DUPLICATE ENTRY - NEW ENTRY NOT ADDED
This message appears if there was already an entry in the LC (LC)
table with the same logical device number.
2.1 LINE TYPE ( X25 OR X21 )?
Enter one of the following replies:
[ENTER] The default protocol (X.25) will be used.
X25 X.25 protocol will be used. Skip to step
2.1.1.
X21 X.21 protocol will be used. Skip to step
2.1.2.
INPUT MUST BE X25 OR X21
This message appears if the response was not one of the above.
You will be prompted again for a logical device number (step
2.1).
Step Dialogue
No.
2.1.1 CONNECTION DIRECT OR VIA PDN?
This prompt is issued only if the connection protocol is X.25.
Enter one of the following responses:
[ENTER] The default connection type (DIRECT) is used.
Skip to step 2.1.1.1.
DIRECT The line connection will be point-to-point.
Skip to step 2.1.1.1.
PDN The line connection will be via Public Data
Network. Skip to step 2.1.1.2.
INPUT MUST BE DIRECT OR PDN
This message appears if the response was not one of the above.
You will be prompted again for the connection type (step 2.1.1).
2.1.2 LINE IS LEASED OR SWITCHED?
This prompt is issued only if the connection protocol is X.21.
Enter one of the following responses:
[ENTER] The default LEASED is used (step 2.2).
LEASED The line type is leased and the connection is
point-to-point. Skip to step 2.2.
SWITCHED The line type is switched and the connection
is via PDN. Skip to step 2.1.3.
INPUT MUST BE LEASED OR SWITCHED
This message appears if the response was not one of the above.
You will be prompted again for the line type (step 2.1.2).
Step No. Dialogue
2.1.1.1 MASTER (DCE) OR SLAVE (DTE) MODE?
This prompt is issued only if the connection protocol is
X.25 and line connection is direct. Enter one of the
following responses:
DTE The node is set up to act as a DTE. Note that
one end of the connection must be set up as
the DTE (DCE), while on the destination node
it must be set up as a DCE (DTE). Skip to
step 2.2.
DCE The node is set up to act as a DCE. Skip to
step 2.2.
INPUT MUST BE DCE OR DTE
This message appears if the response was not one of the
above. You will be prompted again for the DTE or DCE mode
(step 2.1.1.1).
2.1.1.2 LOCAL X25 PDN ADDRESS?
This prompt is issued only if the connection protocol is
X.25 and line connection is via PDN. Enter one of the
following responses:
[ENTER] The default local address of all zeroes
is used.
local X25 PDN This is the actual local address (from
address address) assigned by PDN at
subscription time. It should be a
numeric address up to 14 digits in
length.
X25 ADDRESS SHOULD BE UP TO 14 DECIMAL DIGITS
This message appears if the specified address is greater
than 14 decimal digits or if a non-numeric network address
has been specified. You will be prompted again for the
local X.25 PDN address (step 2.1.1.2).
Step Dialogue
No.
2.1.3 NAME OF PDN?
This prompt is issued only if the connection protocol is X.21 and
the line is switched, or if the connection protocol is X.25 and
the line connection is via PDN. Enter one of the following
responses:
name of PDN The PDN name must be no more than eight
alphanumeric characters.
[ENTER] The default PDN name of all blanks is used.
PDN NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS
This message appears if the PDN name is greater than eight
alphanumeric characters. You will be prompted again for a PDN
name (step 2.1.3).
2.2 PRIMARY REMOTE NODE TO BE CONNECTED TO ON THIS LINE?
Reply by entering the logical node name. This must correspond to
one of the logical node names associated with this line
identifier in the RN table. When a DSLINE command is issued with
a line identifier instead of a logical node name, it might not be
unique. In this case, the logical node to which the connection
will be established is the one identified here.
NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS
This message appears if the node name is greater than eight
alphanumeric characters or if the first character was numeric.
You will be prompted again for primary node name (step 2.2).
The following prompts, covering low-level (Level 2)
characteristics, are issued only if the connection protocol is
X.25.
Step Dialogue
No.
2.3 RESPONSE TIMER (MILLISECONDS) ?
Enter one of the following replies:
[ENTER] The default value of 200 is used.
response timer This value must be an integer in the range of
1 to 9999 and it specifies the period at the
end of which retransmission of a frame can be
indicated. (In the case of a PDN connection,
this is usually dictated by that PDN.)
RESPONSE TIMER SHOULD BE IN THE RANGE 1 TO 9999
This message appears if your reply was either non-numeric or not
in the range of 1 to 9999. You will be prompted again for
response timer (step 2.3).
2.4 RETRY COUNT (1..999) ?
Enter one of the following replies:
[ENTER] The default value of 8 is used.
retry count This must be a numeric value in the range of
1 to 999. It specifies the maximum number of
retransmissions of frames that will be
attempted following the running out of the
response timer. (In the case of a PDN
connection, this is usually dictated by that
PDN.)
RETRY COUNT SHOULD BE IN THE RANGE 1 TO 999
This message appears if your response was either non-numeric or
not in the range of 1 to 999. You will be prompted again for
retry count (step 2.4).
Step Dialogue
No.
2.5 WINDOW SIZE (FRAMES) ?
Enter one of the following replies:
[ENTER] The default value of 2 is used.
window size Window size specifies the maximum number of
sequentially numbered I-frames that a DTE/DCE
may have outstanding (unacknowledged) at any
given time. The minimum value of this
parameter is 1 and the maximum value is 7.
(In the case of a PDN connection, this is
usually dictated by that PDN.)
WINDOW SIZE SHOULD BE IN THE RANGE 1 TO 7
This message appears if your response was either non-numeric or
not in the range 1 to 7. You will be prompted again for packet
size (step 2.5).
The following prompts cover the upper-level (Level 3)
characteristics.
2.6 LOW VC NUMBER (0..4095) ?
Enter one of the following replies:
[ENTER] The default value of 0 is assigned as the low
virtual circuit number.
virtual circuit This must be an integer in the range of 0 to
number 4095. It represents the low end of the
virtual circuit identification numbers. (In
the case of a PDN connection, this is usually
dictated by that PDN.)
LOW VC SHOULD BE IN THE RANGE OF 0 TO 4095
This message appears if your response was not numeric or if it
was not in the range of 0 to 4096. You will be prompted again
for the low VC number (step 2.6).
Step Dialogue
No.
2.7 HIGH VC NUMBER (0..4095) ?
Enter one of the following replies:
[ENTER] The default value of the low virtual circuit
number plus 255 is assigned as the high
virtual circuit number.
virtual circuit This must be an integer in the range of 0 to
number 4095 and it represents the high end of the
virtual circuit identification numbers. It
has to be greater than the low virtual
circuit number, but no more than 255 above
that value. (In the case of a PDN
connection, this is usually dictated by that
PDN.)
HIGH VC SHOULD BE IN THE RANGE nnnn TO mmmm
This message appears if your response was non- numeric, was not
in the range of 0 to 4095, was less than the low virtual circuit
number, or was greater than the sum of the low virtual circuit
number plus 255. You will be prompted again for the high virtual
circuit number (step 2.7).
2.8 PACKET SIZE (32..1024) ?
Enter one of the following replies:
[ENTER] The default packet size (128 bytes) is used.
packet size This must be a numeric value in the range of
32 to 1024. It represents the packet size
(in bytes) that will be used across this
connection. (In the case of a PDN
connection, this is usually dictated by that
PDN.)
PACKET SIZE SHOULD BE IN THE RANGE 32 TO 1024
This message appears if your response was either non-numeric or
not in the range of 32 to 1024. You will be prompted again for
the packet size (step 2.8).
Step Dialogue
No.
2.9 WINDOW SIZE (PACKETS) ?
Enter one of the following replies:
[ENTER] The default window size (2 packets) is used.
window size This must be a numeric value in the range of
1 to 7. It represents the window size (in
packets) that will be used across this
connection. (In the case of a PDN
connection, this is usually dictated by that
PDN.)
WINDOW SIZE SHOULD BE IN THE RANGE 1 TO 7
This message appears if your response was either non-numeric or
not in the range of 1 to 7. You will be prompted again for the
window size (step 2.9).
2.10 CONTINUING ADDING (YES OR NO)?
YES This will take you back to the ADD prompt (step 0).
NO or This will take you out of the ADD command and prompt for
any another first-level command.
input
except
ADDITION COMPLETE
This message appears when the line characteristics have been
added to the (LC) table.
DATA BASE IS FULL - NEW ENTRY NOT ADDED
This message appears when the database is full. To correct this
situation, exit from the utility and enlarge the size of the
IMAGE database.
The C[HECK] Command
This command is used to check the relationships and report any
discrepancies between the Remote Node (RN) and Line Characteristics (LC)
tables. Three basic checks are performed and since they are both always
done, there is no dialogue following the command.
The first check is to scan the RN table and for every line identifier
(logical device number) that is used, a corresponding entry in the LC
table is checked for. If there is no such entry, the following warning
is printed:
Ldev nnn is not entered in the LC table
The second check is to scan the LC table and for each entry a check is
made to verify that the primary node name specified for a logical device
has a corresponding entry in the RN table. If there is no such entry,
the following warning is printed:
aaaaaaaa ( using LDEV nnn ) is not entered in the RN table
The third check is to scan the LC table and for each entry, a check is
made to verify that all RN entries with the same logical device number
have the same line type as the LC entry. For each entry in the RN table
that the line types do not match, the following warning is printed:
aaaaaa (LDEV nnn) line type differs from LC line type
The D[ELETE] Command
This command is used to remove data entries from the Remote Node (RN)
table or the Line Characteristics (LC) table. Note that only the creator
of the database can delete entries. After specifying the DELETE command,
the dialogue proceeds as follows:
Step Dialogue
No.
0 REMOTE NODE (RN) OR LINE CHARACTERISTICS (LC) TABLE?
Enter one of the following replies:
RN When this is specified, you will be deleting
an entry from the RN table and the dialogue
proceeds from there. Skip to step 1.0.
LC When this is specified, you will be deleting
an entry from the LC table and the dialogue
proceeds from there. Skip to step 2.0.
[ENTER] When you reply with the [ENTER] key, you will
receive the following prompt:
CONTINUING DELETING (YES OR NO)?
YES This response takes you back to the DELETE prompt (step
0).
NO This response takes you out of the DELETE command and
prompts for another first-level command.
INPUT MUST BE RN OR LC
If this message appears, the response was not one of the above.
You will be prompted again with the DELETE prompt (step 0).
Deleting from the Remote Node Table. The following prompts cover the
remote node characteristics.
Step Dialogue
No.
1.0 REMOTE NODE NAME?
Enter a logical node name. This name can be up to eight
alphanumeric characters (the first being an alphabetic character)
and it must refer to the same name by which the destination node
is to be referred when using the DSLINE command.
NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS
This message appears when the node name is greater than eight
alphanumeric characters or when the first character is numeric.
You will be prompted again for a logical node name (step 1.0).
NO SUCH ENTRY IN THE RN TABLE
This message appears if a legal logical node name has been
specified, but there is no entry in the RN table for it. You
will be prompted for another first-level command.
A valid logical node name has been specified and you are about to
delete an entry or entries from the RN table. The utility also
prompts to enable you to delete a corresponding entry from the LC
table. Since there can be multiple entries in the RN table for
the name you have specified, the utility repeats the following
sequence of prompts until all entries have been covered;
whereupon you will be prompted for a first-level command.
RN TABLE ENTRY WITH NODE NAME = xxxxxxxx USING LDEV = nnn
CONFIRM DELETION (YES OR NO) ?
Enter one of the following replies:
[ENTER] When you reply with the [ENTER] key, this
message appears:
Step Dialogue
No.
ENTRY NOT DELETED
The delete is not confirmed and processing proceeds. If there
are further entries in the RN table satisfying the logical node
name specified, this step will be repeated; otherwise, you will
be prompted for a first-level command.
NO or any This reply results in the message:
input except
YES
ENTRY NOT The delete is not confirmed and processing
DELETED proceeds. If there are further entries in the RN
table satisfying the logical node name specified,
this step will be repeated; otherwise, you will be
prompted for a first-level command.
YES This reply results in the message:
ENTRY HAS BEEN DELETED
The entry has been deleted from the RN table and processing
proceeds. If there is an LC entry corresponding to this entry
(having the same logical device number), processing proceeds to
the next step; if there is not a corresponding LC entry and there
are further entries in the RN table satisfying the logical node
name specified, this step will be repeated. Otherwise, you will
be prompted for a first-level command.
ASSOCIATED LC TABLE ENTRY WITH LDEV = nnn
CONFIRM DELETION (YES OR NO) ?
Enter one of the following replies:
[ENTER] The delete will not be confirmed and
processing proceeds. If there are further
entries in the RN table satisfying the
logical node name specified, the previous
prompt is repeated; if there are not, you
will be prompted for a first-level command.
Step Dialogue
No.
NO or The delete will not be confirmed and processing
any proceeds. If there are further entries in the RN table
input satisfying the logical node name specified, the previous
exceptprompt is repeated; if there are not, you will be
YES prompted for a first-level command.
YES The entry is deleted from the LC table, and processing
proceeds. If there are further entries in the RN table
satisfying the logical node name specified, the previous
prompt is repeated; if there are not, you will be
prompted for a first-level command.
Deleting from the Line Characteristics Table. The following prompts
cover the line characteristics.
Step Dialogue
No.
2.0 LOGICAL DEVICE NUMBER?
Enter a line identifier (logical device number). This can be a
numeric value between 1 and 255 and it must refer to the logical
device number used on DSLINE command.
LOGICAL DEVICE SHOULD BE IN THE RANGE OF 1 TO 255
This message appears if a line identifier not in the range 1 to
255 has been specified. You will be prompted again for a logical
device number (step 2.0).
NO SUCH ENTRY IN THE RN TABLE
This message appears if a legal line identifier was specified,
but there is no entry in the LC table for it. You will be
prompted for another first-level command.
Step Dialogue
No.
A valid logical device number has been specified, and you are
about to delete an entry from the LC table. The utility also
prompts to enable you to delete a corresponding entry or entries
from the RN table.
LC TABLE ENTRY WITH LOGICAL DEVICE NUMBER = nnn
CONFIRM DELETION (YES OR NO) ?
Enter one of the following replies:
[ENTER] The delete is not confirmed and you will be
prompted for a first-level command.
NO or any input The delete will not be confirmed and
except YES processing proceeds. You will be prompted
for a first-level command.
YES The entry is deleted from the LC table, and
processing proceeds. If there is an entry
(or entries) in the RN table corresponding to
this line identifier, processing proceeds to
the next step; if not, you will be prompted
for a first-level command.
ASSOCIATE RN TABLE ENTRIES USING LDEV = nnn
CONFIRM DELETION (YES OR NO) ?
Enter one of the following replies:
[ENTER] The delete is not confirmed and you will be
prompted for a first-level command.
NO or any input The delete is not confirmed and you will be
except YES prompted for a first-level command.
YES All entries in the RN table that use this
line identifier (ldev) are deleted and you
will be prompted for a first-level command.
The E[XIT] Command
This command is used to terminate the execution of the Network
Configurator. Prior to termination, a call is automatically made to the
CHECK command and any discrepancies in the relationship between the
Remote Node (RN) and Line Characteristics (LC) tables are printed. If
there are no discrepancies, the utility terminates. If there are
discrepancies, processing proceeds as follows:
Step Dialogue
No.
IS IT OK TO EXIT ?
Enter one of the following replies:
[ENTER] You will be prompted for a first-level
command.
NO or any input You will be prompted for a first-level
except YES command.
YES The utility terminates execution.
The H[ELP] Command
This command provides a basic description of each of the commands in the
Network Configuration Utility command set. Since the commands are only
being described, there is no follow-up dialogue in the HELP command.
Only a very basic description of functionally is provided by the HELP
command; so when more detail is required, refer to the descriptions
presented in this manual.
The L[IST] Command
This command provides a display on your terminal screen of the current
content of the network configuration database. The data is arranged into
the Remote Node (RN) and Line Characteristics (LC) tables, under the
following headings
Remote Node Table
Node Name System Type Ldev No Line Type Remote PDN Address/Phone Number
xxxxxxxx HP3000 nnn X25 nnnnnnnnnnnnnn
. . . . .
xxxxxxxx HP1000 nnn X21 xxxxxxxxxxxxxxxxxxxxxxxx
Line Characteristics Table
Ldev No Line Type Connect Method DCE/DTE Remote Primary Node
nnn X21 xxxxxxxx DCE xxxxxxxx
. . . . .
nnn X25 xxxxxxxx DTE xxxxxxxx
Line Characteristics Table (X25)
Ldev No Local X25
Address
T1 Timer Retry Window Low VC High VC Packet Window
Count Size No No Size Size
nnn nnn...nnn nnnn nnn n nnnn nnnn nnnn nnnn
NOTE The Line Characteristics Table (X25) will not be printed unless
there are entries in the LC table that have the X25 line type. If
there are any X.25-related entries in the general LC table, then
the LC (X25) table will contain entries only for those X.25-related
logical devices.
Since all of the information is automatically provided upon specifying
the LIST command, there is no following dialogue.
The P[RINT] Command
The PRINT command lists the current contents of the Remote Node (RN) and
Line Characteristics (LC) tables to a line printer and validates the node
name and logical device relationship between the two tables. It executes
the LIST and CHECK commands, with the output device being a line printer
rather than the $STDLIST. The formal designator is NETLIST and the
default device name is LP. FILE equations are permitted, which enables
you to specify a file or device to which the database contents are to be
printed.
The U[PDATE] Command
This command is used to update entries in the Remote Node (RN) or Line
Characteristics (LC) table which already exist. Note that only the
creator of the database can update the database. After specifying the
UPDATE command, the dialogue proceeds as follows:
Step Dialogue
No.
0 REMOTE NODE (RN) OR LINE CHARACTERISTICS (LC) TABLE?
Enter one of the following replies:
RN When this is specified, you will be adding an
entry to the RN table and the dialogue
proceeds from there. Skip to step 1.0.
LC When this is specified, you will be adding an
entry to the LC table, and the dialogue
proceeds from there. Skip to step 2.0.
[ENTER] When you reply with the [ENTER] key, you will
receive the following prompt:
CONTINUING UPDATING (YES OR NO)?
YES This response takes you back to the UPDATE prompt (step
0).
NO This response takes you out of the UPDATE command and
prompts for another first-level command.
INPUT MUST BE RN OR LC
If this message appears, the response was not one of the above.
You will be prompted again with the UPDATE prompt (step 0).
Updating the Remote Node Table. The following prompts cover the remote
node characteristics.
Step Dialogue
No.
1.0 REMOTE NODE NAME?
Enter a logical node name. This name can be up to eight
alphanumeric characters (the first being an alphabetic character)
and it must refer to the same name by which the destination node
is to be referred when using the DSLINE command.
NODE NAME SHOULD BE UP TO 8 ALPHANUMERIC CHARACTERS
This message appears when the node name is greater than eight
alphanumeric characters or when the first character is numeric.
You will be prompted again for a logical node name (step 1.0).
NO SUCH ENTRY IN THE RN TABLE
This message appears if a legal logical node name was specified,
but there is no entry in the RN table for it. You will be
prompted for another first-level command.
Prior to issuing any prompts, the utility first prints all
entries in the RN table that qualify with the logical node name
specified. Since there can be multiple entries in the RN table
for the logical node name you have specified, you will be
prompted for the logical device number associated with the
logical node name.
1.2 LOGICAL DEVICE NUMBER ?
Enter one of the following replies:
[ENTER] You will be prompted again for a logical
device.
line identifier This must be the line identifier that
(logical device qualifies which of the entries in the RN
number) table for a particular logical node you wish
to update.
LOGICAL DEVICE NUMBER SHOULD BE IN THE RANGE OF 1 TO 255
This message appears when a non-numeric line identifier, or a
range of 1 to 255, has been specified. You will be prompted
again for a logical device number (step 1.2).
NO SUCH ENTRY IN THE RN TABLE
This message appears if a valid line identifier was specified,
but none of the qualifying NLA entries uses this line
identification. You will be prompted for a first- level command.
All other prompts, responses and error messages are the same as
for the ADD command. For each variable in the entry, the current
value is printed, followed by a prompt for a new value. An
[ENTER] key maintains the current value.
Updating the Line Characteristics Table. The following prompts cover the
line characteristics.
Step Dialogue
No.
2.0 LOGICAL DEVICE NUMBER?
Enter a line identifier (logical device number). This can be a
numeric value between 1 and 255 and it must refer to the logical
device number used on DSLINE command.
LOGICAL DEVICE SHOULD BE IN THE RANGE 1 TO 255
This message appears if a line identifier not in the range of 1
to 255 has been specified. You will be prompted again for a
logical device number (step 2.0).
NO SUCH ENTRY IN LC TABLE
This message appears if a legal line identifier was specified,
but there is no entry in the LC table for it. You will be
prompted for another first-level command.
This procedure follows that of adding to the LC table. For each
variable in the entry, the current value is printed, followed by
a prompt for a new value. An [ENTER] key maintains the current
value. All other prompts, responses and error messages are the
same as for the ADD command.
MPE/iX 5.0 Documentation