Configuring Network Data [ Using NS3000/XL Network Services ] MPE/iX 5.0 Documentation
Using NS3000/XL Network Services
Configuring Network Data
Figure 7-2 shows an internetwork that includes three networks (NET1,
NET2, and NET3) connected together. We will use NET3 as the sample LAN
network for our discussion. NET3 shows six nodes connected together by a
LAN. NetCI is installed on node K , which is the management node.
Figure 7-2. Sample Internetwork
Configuring Logon Information
NetCI establishes multiple remote sessions on one or more nodes when
executing a particular command or running a program. Before remote logon
sessions can be established, system and logon information for each node
must be stored in the NetCI internal data structure.
To configure each node, use the following commands:
* NEWNODE to configure each node and its logon sessions.
* ALTNODE to change the node's logon information.
* PURGENODE to delete a node from configuration.
You can then use the SHOWNODE command to list all the nodes and logon
sessions that you configured, and to check whether you correctly changed
a node's logon information or deleted a node. Refer to the commands on
the following pages for more specific details.
Node Names. Each node in the network is identified by its NS3000 node
name. Any node may be added to the NetCI configuration and identified in
NetCI by a unique NetCI node name. The NetCI node name may be the NS3000
node name or another NetCI name you want to assign to the node. Each
NetCI node name is associated with a logon session on a node. You can
have several logon sessions established on one node but each session must
have an individual NetCI node name.
Sample LAN. Using our sample LAN, we will configure all the nodes in
NET3 from one location, node K.
In order to configure node K, use the NEWNODE command:
NetCI> NEWNODE K OPERATOR.SYS/NET3K
NetCI will now have in its configuration a node called K. The logon
session for K will be OPERATOR.SYS/NET3K.
For our example, we will configure the remaining nodes on the LAN in NET3
using their NS3000 node names:
NetCI> NEWNODE Y OPERATOR.SYS/NET3Y
NetCI> NEWNODE I OPERATOR.SYS/NET3I
NetCI> NEWNODE J OPERATOR.SYS/NET3J
NetCI> NEWNODE L OPERATOR.SYS/NET3L
NetCI> NEWNODE H OPERATOR.SYS/NET3H
Reassigning Node Names. You can reassign each node a nique NetCI name
instead of using the NS3000 node name. For example, you can assign a
session on node Y the NetCI name, BURGUNDY. NetCI will then recognize
the logon session ( OPERATOR.SYS) on node Y as BURGUNDY. To assign a
unique NetCI name to a node and logon session, you use the NEWNODE
command with the ;dsline= NS nodename option. For example, you enter
NetCI> NEWNODE BURGUNDY OPERATOR.SYS/NET3Y;DSLINE=Y
After configuring your network, you may then assign the nodes with their
associated sessions to different lists and assign an identifier to each
list. If four nodes are assigned to a list, a session will be initiated
on each of the four nodes when the command is executed on each node.
Refer to "Configuring for Command Broadcast" for more information.
When you reassign an NS node a NetCI name, you need to only specify the
NetCI name instead of the fully-qualified NS node name to perform an
operation on the node. For example, to assign a NetCI name, you enter
NetCI>NEWNODE PORT OPERATOR.SYS/NET1A
;DSLINE=A.NET1.BND
to configure node A with its logon session in NET1 as PORT. If the NS3000
node name is not a unique node name in the internetwork, the node name
following ;dsline= NS nodename option must be a fully-qualified node
name, nodename.domain.organization. Whenever you want to establish a
session on node A in NET1, you simply need to specify PORT instead of the
fully-qualified NS3000 node name.
NEWNODE
Adds a node and its logon information to the user's NetCI configuration.
Syntax
_______________________________________________________
| |
| NEWNODE node logon[ ;dsline= NS nodename]|
_______________________________________________________
Parameters
node
NetCI name or identifier for the node to be added. The NetCI name may be
a maximum of 15 characters.
logon
Node's logon identification which is a valid logon sequence in the form:
username [ /userpass] .acctname [ /acctpass][ ,groupname ][/grouppass ].
For information on additional MPE logon parameters and options, refer to
the MPE XL Commands Reference Manual.
NS nodename
If the NetCI name (specified in the node field) is the same as the
NS3000 node name, leave this field blank. If the NetCI name is not the
same as the NS3000 node name, specify the NS node name configured in the
NS3000 network.
Discussion
Make sure that the NS node name specified in ;dsline= NS nodename is a
valid NS node name and is entered correctly (not misspelled). If you
enter an erroneous node name into the NetCI configuration, NetCI will
only discover the invalid node name when it attempts to log on to a
target node.
There are special considerations that apply to scripting (refer to
"Redirecting NetCI Input and Output" discussed later in this chapter for
further details) that you must consider during configuration:
* If a password is required to initiate a logon session, make sure to
include the password.
* If remote application programs will poll terminals for termtype
during logon (which occurs when the application is run as part of a
logon UDC), make sure that you specify the termtype option with the
logon information. If it is not specified, connection to that remote
node on which the application is running will hang.
Examples
Example 1
This example adds nodes with logon sessions to the NetCI configuration.
NetCI>NEWNODE K OPERATOR.SYS/NET3K
NetCI>NEWNODE Y OPERATOR.SYS/NET3Y
NetCI>NEWNODE I OPERATOR.SYS/NET3I
NetCI>NEWNODE J OPERATOR.SYS/NET3J
NetCI>NEWNODE L OPERATOR.SYS/NET3L
NetCI>NEWNODE H OPERATOR.SYS/NET3H
Since the ;dsline= NS nodename option is not specified after the logon
information, the NetCI name for each node will be the actual NS3000 node
name. In the example, the default environment for each of the above
nodes will be:
;DSLINE=K
;DSLINE=Y
;DSLINE=I
;DSLINE=J
;DSLINE=L
;DSLINE=H
Example 2
This example assigns a NetCI name (or identifier) to a logon session on
node Y.
NetCI>NEWNODE CHABLIS OPERATOR.SYS/NET3K;DSLINE=Y
Y is the NS node name. The node name specified for the ;dsline= NS
nodename option must be the actual NS3000 node name specified in the
NS3000 configuration. In NetCI, CHABLIS now refers to a specific session
on remote node Y under the user name OPERATOR.
An NS node may be assigned more than one NetCI name and logon session.
For example,
NetCI>NEWNODE PINOIT MGR.SYS/NET3K;DSLINE=Y
assigns node Y another NetCI name and user on that node. In NetCI,
PINOIT refers to a session established on remote node Y under the user
name MGR. This example shows that two NetCI names, CHABLIS and PINOIT,
are assigned to node Y. These two names refer to node Y with different
user sessions being established.
ALTNODE
Changes the NetCI node name and logon information in the user's NetCI
configuration for an NS3000 node.
Syntax
_________________________________________________
| |
| ALTNODE node logon [;dsline= NS nodename]|
_________________________________________________
Parameters
node
NetCI name of the node whose logon information is to be changed.
logon
New logon identification which is a valid logon sequence in the form:
username [ /userpass] .acctname [ /acctpass][ .groupname/ grouppass] ;
dsline= NS nodename
For information on additional MPE logon parameters and options, refer to
the MPE XL Commands Reference Manual.
NS nodename
If the NetCI name (specified in the node field) is the same as the
NS3000 node name, leave this field blank. If the NetCI name is not the
same as the NS3000 node name, specify the NS node name in the NS3000
network.
Examples
Example 1
This example changes the user of the logon session for node I. The remote
environment for NetCI node I remains as previously configured, which is
node I (the default environment), so it is not necessary to enter the
same remote environment information again.
NetCI>ALTNODE I NETADMIN.SYS/BRIE
Example 2
This example changes the user of the logon session for the NetCI node
PINOIT whose remote environment remains as previously configured which is
node Y (the default environment). However, it is necessary to enter the
NS nodename again since it is not the same as the NetCI node name.
NetCI>ALTNODE PINOIT NETADMIN.SYS/NET3K;DSLINE=Y
Example 3
This example changes the remote environment for the NetCI node CHABLIS to
NS node L.
NetCI>ALTNODE CHABLIS OPERATOR.SYS/NET3K;DSLINE=L
You still need to enter the user logon information even though you are
only changing the remote environment. The NetCI node CHABLIS now refers
to a session on NS3000 node L instead of node Y (which was the previous
configuration).
PURGENODE
Deletes a node and its logon information from the user's NetCI
configuration and from any list of which the node is a member.
Syntax
_____________________________________
| |
| PURGENODE node |
_____________________________________
Parameters
node
NetCI name of the node to be deleted from configuration and from all
lists of which that node is a member.
Example
This example deletes node J from the data base.
NetCI>PURGENODE J
SHOWNODE
Shows the node's logon information and the lists of which the node is a
member.
Syntax
_____________________________________
| |
| SHOWNODE node |
_____________________________________
Parameters
node
NetCI name of the node whose information is to be displayed. If you want
to display the information for all nodes in the NetCI configuration,
specify
SHOWNODE @
Discussion
Passwords are not displayed for security reasons.
Example
This example shows the logon information and the lists of which node Y is
a member. The information displayed shows that node Y is a member of
LIST1 and no commands or programs are being executed on this node (no
session is established).
NetCI>SHOWNODE Y
Y Connection is closed
Login Data: OPERATOR.SYS
Dsline = Y
Node is on lists:
LIST1
Configuring for Command Broadcast
You may group nodes in the network in various combinations. By grouping
nodes and assigning each group to a list, you can "broadcast" to all
nodes on the list by issuing a command referencing that list name.
To configure nodes for command broadcast, use the following commands:
* NEWLIST to first create a list.
* ALTLIST to add nodes to or delete nodes from a list.
* PURGELIST to delete a list and all its nodes.
You can then use the SHOWLIST command to 1) display all the nodes
belonging to a list, 2) check whether you correctly added a particular
node to or deleted a node from a list, 3) verify whether a list is
deleted, or 4) display all lists. Refer to the commands on the following
pages for more specific details.
When you broadcast or execute a command on a list, you execute the
command sequentially on each node on the list. If a node is down,
execution will continue to the next node on the list.
Sample LAN
Using our sample LAN (Figure 7-2), we will create for NET3 three lists
identified as LIST1,LIST2, and ALLNODES with different nodes assigned
to each list. First, we must use the NEWLIST command to create and
assign a name to each list.
NetCI>NEWLIST LIST1
NetCI>NEWLIST LIST2
NetCI>NEWLIST ALLNODES
Next we will use the ALTLIST command to assign nodes to each list.
NetCI>ALTLIST ADD LIST1 K,I,H
NetCI>ALTLIST ADD LIST2 K,L,H
NetCI>ALTLIST ADD ALLNODES K,Y,I,L,H
The first list, named LIST1, will have three members, nodes K, I, and
H. The second list, named LIST2, will also have three members, nodes
K,L, and H. The third list, named ALLNODES, will have five members,
nodes K, Y, I,L, and H. We will now use the SHOWLIST command to verify
that we correctly added or assigned the nodes to each list.
NetCI>SHOWLIST @
LIST1
Nodes on list:
H I K
LIST2
Nodes on list:
H L K
ALLNODES
Nodes on list:
H L I Y K
NEWLIST
Creates a new list in NetCI configuration.
Syntax
_____________________________________
| |
| NEWLIST list |
_____________________________________
Parameters
list
Name of the new list to be created in the NetCI configuration. The list
identifier may be a maximum of fifteen characters.
Discussion
The new list must be created before you can add nodes to the list.
Example
NetCI>NEWLIST NET3
ALTLIST
Adds nodes to or deletes nodes from a list.
Syntax
______________________________________
| |
| ALTLIST {ADD} list nodes|
| {DEL} |
______________________________________
Parameters
ADD
Adds a node to a list.
DEL
Deletes a node from a list. If you delete the last node from the list,
the list will still exist in the configuration with no node members.
list
Name of the list to which a new node is to be added, or from which an
existing member node is to be deleted.
nodes
Name of the nodes to be added to or deleted from the list. More than one
node can be specified here separated by spaces or commas.
Discussion
You must create a list before you can add a node to the list. If you add
or delete a node to or from a non-existing list, you will get an error
message that the list name is an unknown list name.
Examples
This example shows how to add nodes H, L, K, I and Y to a list named NET3
with the parameter ADD. This list now has five members:
NetCI>ALTLIST ADD NET3 H,L,K,I,Y
This example shows how to delete node Y from NET3. However, nodes H, L,
K and I still exist in the NetCI configuration.
NetCI>ALTLIST DEL NET3 Y
To check whether node Y is deleted from NET3, use the SHOWLIST command
(which is discussed later in this section). This command shows only
nodes I, K, L, and H as members of NET3.
NetCI>SHOWLIST NET3
NET3
Nodes on list:
I K L H
PURGELIST
Deletes an existing list from the NetCI configuration.
Syntax
_____________________________________
| |
| PURGELIST list |
_____________________________________
Parameters
list
Name of the list to be deleted.
Discussion
This command deletes the name of the list and the configuration
specifying which nodes are members of the list.
NetCI>PURGELIST LIST2
SHOWLIST
Displays the names of the nodes included in a list.
Syntax
_____________________________________
| |
| SHOWLIST list |
_____________________________________
Parameters
list
Name of the list whose member nodes are to be displayed. If you want to
display all lists and the nodes on each list, specify
NetCI>SHOWLIST @
Examples
Example 1
This example displays the nodes belonging to a specific list.
NetCI>SHOWLIST LIST1
LIST1
Nodes on list:
H I K
This example displays all the lists and the nodes belonging to each list.
Example 2
NetCI>SHOWLIST @
LIST1
Nodes on list:
H I K
ALLNODES
Nodes on list:
H L I Y K
NET3
Nodes on list:
I K L H
MPE/iX 5.0 Documentation