PURGEVC [ Using the Node Management Services (NMS) Utilities ] MPE/iX 5.0 Documentation
Using the Node Management Services (NMS) Utilities
PURGEVC
Purges an X.25 virtual circuit address key from the network directory and
the configuration file.
Syntax
PURGEVC [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
PURGEVC removes an address key from both the local network directory and
the configuration file. If there are multiple occurrences of the same
address key under a single NI, all occurrences are purged. The directory
node associated with the address key to be purged will be purged itself
if it contains no other addresses.
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.
PURGEVC 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 PURGEVC is used interactively and no filename is specified, the user
is prompted to enter address parameters for each remote node. When
PURGEVC is run interactively and a filename is specified, or when the
command is run from a job, entries must be made in the following format:
nodename[,] address key[,] NI name [;]
The description of each address key parameter is as follows:
nodename The name of a node for which the address key is to be
purged. 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.
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 network interface name. The name of the local
X.25 NI, (configured under the path NETXPORT.NI). The
name may contain a maximum of eight alphanumeric
characters.
Example
To purge a virtual circuit associated with the NI named X25 for the node
named NODE1.XLNET.ACCTG:
NMMGR>OPENCONF NMCONFIG
NMMGR>OPENDIR NSDIR.NET.SYS
NMMGR>PURGEVC
Enter the node name (or press return to exit):
PURGEVC >NODE1.XLNET.ACCTG
Enter address key:
PURGEVC > NODE1
Enter NI name:
PURGEVC >X25
Address key NODE1 deleted.
Enter node name (or press return to exit):
NMMGR>
MPE/iX 5.0 Documentation