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