HP 3000 Manuals

ADDVC [ Using the Node Management Services (NMS) Utilities ] MPE/iX 5.0 Documentation


Using the Node Management Services (NMS) Utilities

ADDVC 

Adds an X.25 virtual circuit address key to the network directory and to
the configuration file.

Syntax 

ADDVC [filename]

Parameters 

filename              The name of a text file that contains X.25 address
                      information for each remote node to be added to the
                      configuration file and directory.  The format for
                      the file name is:

                      filename[.groupname[.accountname]]

                      A file lockword may not be specified.  The contents
                      of the file must be formatted as described below.

Description 

ADDVC updates both the local network directory and the configuration file
with X.25 address information.  It uses the address key specified for the
network directory to relate the remote node name to an IP address, local
NI name, and an X.25 address.

The directory and configuration files must be opened either via the Open
Configuration/Directory File screen or via the OPENDIR and OPENCONF
maintenance mode command before ADDVC is invoked.

This command can be run interactively, by entering maintenance mode from
screen mode and typing the command, or it can be run from a batch job.

When ADDVC is used interactively and no filename is specified, the user
is prompted to enter address parameters for each remote node.  When ADDVC
is run interactively and a filename is specified, or when the command is
run from a job, each entry is defined as a set of positional parameters
delimited by spaces or a comma.  An unspecified parameter must be
delimited by a comma, or by a semicolon if it occurs at the end of the
entry.

For switched virtual circuits, the format is:

nodename[,] IP address[,] address key[,] NI name[,] Y[,] svc address[,]
[facility set][,] [security class][;]

For permanent virtual circuits, the format is:

nodename[,] "IP address"[,] address key[,] NI name[,] N[,] circuit
number[;]

The description of each parameter that must be defined when the command
is run from a job or with a filename specified is as follows:

nodename            The name of a node to which the address key is to be
                    added.  The format is:

                    nodename.domain.organization

                    Each of the three names may be from one to sixteen
                    characters long, must begin with a letter, and may
                    contain letters, digits, underscores, or dashes.

                    If the nodename does not exist, it will be created.
                    If it does exist, the IP address and additional
                    address (if any) will be added to its path report
                    list in the directory.

IP address          The IP address of the remote node whose X.25 address
                    is to be added to the configuration.  The format of
                    the address is the same as the IP address in the
                    Network Directory Data screen.  It must be enclosed
                    in quotes (") if it is not entered interactively.

address key         The name tag used to relate a node name and IP
                    address from the network directory, with a switched
                    or permanent virtual circuit address, configured
                    under an X.25 NI in the local configuration file.
                    The name may contain a maximum of eight alphanumeric
                    characters.

NI name             The name of the local X.25 NI. The name may contain a
                    maximum of eight alphanumeric characters.

Y or N              A Y or an N must be entered after the NI name
                    parameter to indicated whether the virtual circuit
                    being added is a switched virtual circuit (Y) or a
                    permanent virtual circuit (N).

svc address         The address associated with an X.25 node.  The
                    address can be a maximum of 15 digits and is supplied
                    with the network subscription or assigned by the
                    network administrator.

facility set        The name of the facility set to be used when the
                    switched virtual circuit connection is created with
                    the remote node.  The name may contain a maximum of
                    eight alphanumeric characters.  The default is
                    STDSFSET, which is supplied when the NI is created
                    using NS guided configuration.

security class      The security class to be associated with switched
                    virtual circuit connections established with the
                    remote node.  The choices are:

                    IO                  Initiate outbound and accept
                                        inbound connections.

                    IN                  Accept inbound connections only.

                    OU                  Initiate outbound connections
                                        only.

                    LK                  Do not permit inbound or outbound
                                        connections (placeholder entry).

circuit number      The permanent virtual circuit number supplied with
                    your network subscription or assigned by your network
                    administrator.

Example 

To interactively add a switched virtual circuit for the node named
NODE1.XLNET.ACCTG to the NI named X25 (user input is underlined):

     NMMGR> OPENCONF NMCONFIG
     NMMGR> OPENDIR NSDIR.NET.SYS
     NMMGR> ADDVC
     Enter node name (or press return to exit):
     ADDVC> NODE1.XLNET.ACCTG
     Enter IP address:
     ADDVC> C 192.000.001 001
     Enter address key:
     ADDVC> NODE1
     Enter NI name:
     ADDVC> X25
     Is the X.25 address a switch VC (Y/N)?
     ADDVC> Y
     Enter X.25 address:
     ADDVC> 123456789O12345
     Enter facility set name (press return for STDSFSET):
     ADDVC> [RETURN]
     Enter security class (IO,IN,OU,LK):
     ADDVC> IO
     Address key NODE1 added.
     Enter node name (or press return to exit):
     ADDVC> [RETURN]
     NMMGR>



MPE/iX 5.0 Documentation