HP 3000 Manuals

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