HP 3000 Manuals

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