HPlogo Using the Node Management Services (NMS) Utilities > Chapter 5 Using NMMGR in Maintenance Mode

ADDVC

MPE documents

Complete PDF
Table of Contents
Index

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 italicized): 

  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>



ADDNODE

CARDCONF