This chapter tells you how to use network administration commands. Examples of the tasks these commands perform are creating a password, setting the network date and time, and adding a user.

Signing On to the System

Signing on to a node is a two-step process that requires you to enter a User ID and a password. The system or network administrator can provide a User ID and password to you. The User ID can be up to 12 characters. To protect the security of the system, you should change your password regularly. Only your system administrator can change the User ID. To sign on to a node:

Step 1 Enter your user ID at the system prompt "Enter User ID."

Step 2 Enter your password at the "Enter Password" prompt. For initial sign-on, enter the password that the system administrator provides. You can change the password with the cnfpwd command.

After you sign on, the system is ready and so prompts you for the next command.

Signing Off the System

When you have completed a session and want to sign off, use the bye command. This command returns the display to the initial system sign-on prompt. If you enter the bye command when you have a virtual terminal connection to another node, the bye command ends the virtual terminal session and returns to the local session. To end the local session and thus sign-off the system, again enter the bye command.

Changing a Password

To change the password given to you by your System Administrator, or to change your present password to a different one, perform the following. To ensure the security of your system, your password should be changed on a regular basis. See the System Administrator for the recommended frequency of change.

Step 1 Enter the cnfpwd command. The system prompts for your current password.

Step 2 Enter your current password. The system prompts for a new password.

Step 3 Enter a new password. Passwords must have 6-15 characters. The system prompts you to confirm the new password by typing it again.

Set Date and Time

Date and time are network-wide parameters. You can set the time zone for each node. The cnfdate command lets you set both time and date. The cnftime command lets you set the time for the entire network.

Summary of Commands

Table 13-1 shows the full name and starting page for the description of each network management command.

Table 13-1: Commands for Managing a Network

Command	Description	Page
adduser	Add user(s)	13-4
cnfpwd	Configure password	13-6
cnffwswinit	Configure Cisco WAN Manager node IP address firmware/software initiator	13-7
cnfsnmp	Configure SNMP parameters	13-8
cnfstatmast	Configure statistics master SV+ address	13-9
cnfsysparm	Configure system parameters	13-10
deluser	Delete user	13-15
dsplanip	Display LAN IP address of all nodes in network	13-16
dspnwip	Display network IP interface	13-18
dsppwd	Display password	13-19
dspsnmp	Display SNMP parameters	13-21
dspsnmpstats	Display SNMP statistics	13-23
dspsv3	Display WAN Manager Layer 3 Link Control Blocks	13-25
dspusers	Display users	13-25
dspusertask	Display user task	13-34
dspusertasks	Display all user tasks	13-37

adduser

Adds a user to the network. The first time the new user ID is used for logon, a prompt appears asking the user to change from the default password to a new password which they enter using the cnfpwd command. Users with privilege levels 1 through 5 may add users with lower privilege levels. Since privilege level 6 has no user levels below it, level 6 cannot add any users.

Full Name

Add a user

Syntax

adduser <user_id> <privilege_level>

Related Commands

cnfpwd, deluser, dspusers

Attributes

Privilege	Jobs	Log	Node	Lock
1-5	No	Yes	IGX, BPX	Yes

Example 1

adduser sarah 5

Description

Add a user sarah with privilege level 5.

System Response


alpha          TRM   YourID:1        IGX 8410    9.2    Aug. 16 1998 13:48 PST 
                                                                                
YourID       1                                                                  
Sarah        5                                                                  
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
Last Command: adduser Sarah 5                                                   
                                                                                
                                                                                
Next Command:

Table 13-2: adduser—Parameters

Parameter	Description
userid	Specifies the name of the user to add.
privilege level	Specifies the privilege level to grant to the added user. The range of levels is 1-6, where 1 is the highest level and 6 is the lowest.

cnfpwd

Changes the password associated with a User ID. To change a password, you must log into the node with the User ID whose password you want to change. Passwords are case-sensitive.

In a structured network, each domain requires you to have a password. In each domain, your password and associated privilege level can be the same as or different from those in the other domains. For each domain, you can change the password at any node within the domain, including a junction node.

Full Name

Configure password

Syntax

cnfpwd <old password> <new password>

Related Commands

dsppwd, adduser, deluser, dspusers

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	Yes	IGX, BPX	Yes

Example 1

cnfpwd

Description

Change your password.

Table 13-3: cnfpwd—Parameters

Parameter	Description
old password	Specifies the old password.
new password	Specifies the new password. Passwords must have 6-15 characters. Only letters, numbers, "_", and "-" are allowed in a password. Spaces are not allowed.

cnffwswinit

Use the cnffwswinit command to inform the IGX/BPX the IP address of the machine used to initiate a firmware or software download. This is used as a sort of a safety measure, to prevent downloads from being started anywhere in the network. You must have access to a node, and use the cnffwswinit command to set the IP address before a download will be accepted from that address.

Full Name

Configure firmware and software downloader's WAN Manager IP address

Syntax

cnffwswinit <IP address of download initiator>

Related Commands

dsppwd, adduser, deluser, dspusers

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	Yes	IGX, BPX	Yes

Example

cnffwswinit 172.29.52.17

Description

Configures the IP address of the machine running WAN Manager from which the firmware and software download will be initiated to other nodes. If you do not provide the IP address for the WAN Manager node from which to initiate the firmware/software download, you will be prompted to enter it.

Table 13-4: cnffwswinit-Parameters

Parameter	Description
IP address	Specifies IP address of machine running WAN Manager from which the firmware and software download will be initiated to other nodes in the network.

cnfsnmp

Configures the SNMP GET and SET community strings.

Full Name

Configure SNMP parameters

Syntax

cnfsnmp <GET community string> <SET community string>

Related Commands

dspsnmp, dspsnmpstats

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	Yes	IGX, BPX	Yes

Example 1

cnfsnmp

Description

Configure the SNMP GET and SET community string parameters.

Table 13-5: cnfsnmp—Parameters

Parameter	Description
get community string	Specifies the GET community string.
set community string	Specifies the SET community string.

cnfstatmast

Configures an IP address for the Statistics Master process in WAN Manager. The cnfstatmast command defines the IP address for routing the messages to and from the Statistics Master in WAN Manager.

The Statistics Master process requests and receives network statistics by using TFTP Get and Put messages. These TFTP messages pass between the node and the Statistics Master over IP Relay. See the cnfnwip description for details on setting a node address.

Full Name

Configure statistics master SV+ address

Syntax

cnfstatmast <IP Address>

Related Commands

cnfnwip, dspnwip

Attributes

Privilege	Jobs	Log	Node	Lock
1	Yes	Yes	IGX, BPX	Yes

Example 1

cnfstatmast 199.35.96.217

Description

Configure 199.35.96.217 as the IP address for the Statistics Master.

Table 13-6: cnfstatmast—Parameters

Parameter	Description
ip address	Specifies the IP address for the Statistics Master. IP addresses have 32-bits. The format of an IP address is x.x.x.x, where x is a value in the range 1-255.

cnfsysparm

Configures various system (or network) parameters. Network-wide parameters are configurable only when all nodes in the network are reachable. The parameters you specify with this command apply throughout the network regardless of which node you execute the command from. Take special note of the consequences of how you resolve conflicting values when networks are joined.

You can select each parameter by its index number. The paragraphs that follow describe each parameter by index number. Table 13-6 lists the defaults and ranges for each parameter.

Note Using cnfsysparm requires caution because network rerouting or loss of data may result from changes in system parameters. If necessary, consult with the TAC before you use cnfsysparm.

The following paragraphs describe the user-configurable system parameters by index number.

1: Maximum Time-Stamped Packet Age is the maximum age a time-stamped packet can have before the switch discards it. If networks are joined and the Maximum Time-Stamped Packet Age in the networks differ from each other, the lower value becomes the maximum.
2: Fail Connections On Communication Break Determines whether connections are conditioned if the node at the other end of the connection becomes unreachable. If networks with different settings are joined, the resolution is to enable this parameter for the new network.
3-7: Maximum Network Delay for various types of compressed voice and high-speed data connections using SDP/LDP on an IPX node or LDM/HDM on an IGX node. When the total queueing delay on a route exceeds this value, connection traffic cannot use the route. The units of measure are milliseconds. When networks with different values are joined, the lower value becomes the Maximum Network Delay.
8-12: Maximum Network Delay for compressed voice and high-speed data connections. When the total queueing delay on a route exceeds the specified number of milliseconds, a connection traffic cannot use the route. When networks with different values are joined, the higher value becomes the Maximum Network Delay. Applicable cards are the UVM, CDP, or CVM.

Note In Release 9.1, when cost-based routing is configured, the delay cost cap is the maximum allowable end-to-end delay for the connection type. Use parameters 3 through 12 to configure this delay network-wide for all delay-sensitive connections.

13: Enable Discard Eligibility (DE) bit for Frame Relay connections. Frames received with DE set have been sent on connections where the PIR has been exceeded and are eligible to be discarded. Enabling DE automatically enables CLP. CLP is disabled when Discard Eligibility is turned off except on the bursty data B queue when ForeSight is enabled.
14: Use Frame Relay Standard Parameters Bc and Be allows you to substitute the Frame Relay Forum standard Bc for VC Q depth and Be for PIR when you configure Frame Relay ports and connections. (The affected commands are cnffrport, addcon for Frame Relay, and cnfcon.) Screen displays for Frame Relay ports and connections reflect the choice for this parameter. Note that if you change this parameter, a network-wide reset to the default values takes place for all Frame Relay classes, and the terminal displays a warning that the reset occurred.
Obsolete: 15-20: Maximum Local Delay for Interdomain UVM, CDP, or CVM to UVM, CDP, or CVM connections is similar to parameters 8-12 described above. These parameters specify the maximum delay at the local domain in a structured network. These delays can be set only on a domain-by-domain basis (not end-to-end).
21: FastPAD Jitter Buffer Size is the size of the buffer for neutralizing jitter in connections that terminate on a FastPAD. The units of measurement are milliseconds.
22: Number of Consecutive Invalid Login Attempts to Cause Major Alarm specifies the number of failed login attempts that causes a major alarm. The default of 0 means that failed login attempts do not cause an alarm. If the threshold is set to 0, the Too Many Invalid Login Attempts service-affecting alarm is disabled and no alarm will be generated.
23: Enable Connection Deroute Delay is an enable that causes the network to wait a period of time before rerouting connections because of an error on a trunk. With Enable Connection Deroute Delay enabled, the network does not immediately reroute connections when statistical errors are occurring or when a trunk momentarily moves into a failure state then returns to normal operation. This feature is relevant when rerouting the connections is more of a disruption than the errors caused by the intermittent trunk.
24: Frame Relay VCs Polling Rate is the period between the start of polling cycles for both ATM and Frame Relay virtual connections. The possible values are 5, 10, and 15 seconds. As the number of connections in a network grows, greater intervals between cycles may be appropriate. The suggested intervals for the numbers of connections are:

5 minute polling for up to 4000 connections
10 minute polling for up to 8000 connections
15 minute polling beyond 8000 connections.

25: Port Polling Rate is the time between the start of polling cycles for interval statistics. The possible values are 5, 10, and 15 minutes. (To specify the particular statistics, use the statistics manager in WAN Manager.) As the number of connections in a network grows, greater intervals between cycles may be appropriate. The suggested intervals for the numbers of connections are:

5 minutes for up to 300 connections
10 minutes for up to 500 connections
15 minutes for more than 500 connections.

Table 13-7: Defaults and Ranges of cnfsysparm Parameters

System Parameters
Index	System-Wide Parameter	Default	Range
1	Max Time Stamped Packet Age (in milliseconds).	40	1-60
2	Fail Connections On Communication Break.	No	y or n
3	Max Network Delay for "v" connections (in milliseconds).	14	1-255
4	Max Network Delay for "c" connections (in milliseconds).	27	1-64
5	Max Network Delay for "d" connections (in milliseconds).	14	1-255
6	Max Network Delay for "a" connections (in milliseconds).	27	1-255
7	Max Network Delay for High-Speed Data connections (in milliseconds).	40	1-255
8	Max Network Delay for CDP or CVM to CDP or CVM "v" connections (in milliseconds).	64	1-255
9	Max Network Delay for CDP or CVM to CDP or CVM "c" connections (in milliseconds).	64	1-64
10	Max Network Delay for CDP or CVM to CDP or CVM "t & p" connections (in milliseconds).	64	1-255
11	Max Network Delay for CDP or CVM to CDP or CVM "a" connections (in milliseconds).	64	1-255
12	Max Network Delay for CDP or CVM to CDP or CVM High-Speed Data connections (in milliseconds).	64	1-255
13	Enable Discard Eligibility (DE).	No	y or n
14	Use Frame Relay standard parameters Bc and Be.	No	y or n
15	Obsolete: Max Local Delay for Interdom CDP to CDP "v" connections.	27	1-255
16	Obsolete: Max Local Delay for Interdom CDP to CDP "c" connections.	27	1-64
17	Obsolete: Max Local Delay for Interdom CDP to CDP "t & p" connections.	27	1-255
18	Obsolete: Max Local Delay for Interdom CDP to CDP "a" connections.	27	1-255
19	Obsolete: Max Local Delay for Interdom CDP to CDP High-Speed Data connections.	27	1-255
20	Obsolete: Max Local Delay for Interdom High-Speed Data connections (in milliseconds).	28	1-255
21	FastPAD Dejitter Buffer Depth (in milliseconds).	15	0-255
22	Number of Consecutive Invalid Login Attempts to Cause Major Alarm.	0	3-9
23	Enable Connection Deroute Delay.	Yes	y or n
24	Frame Relay VCs Polling Rate is the number of minutes between polling cycles for both ATM and Frame Relay virtual connections in the network.	5	5, 10, or 15
25	Port Polling Rate is the number of minutes between polling cycles for interval statistics gathered for all ports in the network.	5	5, 10, or 15

Full Name

Configure system parameters

Syntax

cnfsysparm <index> <value>

Related Commands

none

Attributes

Privilege	Jobs	Log	Node	Lock
1	Yes	Yes	IGX, BPX	Yes

Example 1

cnfsysparm

Description

Configure system-wide parameters. In response to the prompt "Continue" at the bottom of the display enter a "y", or press Return to display the second screen, or enter "n" to not display the next screen. If you enter an "n," the prompt line requests an index number.

System Response


sw171          VT    SuperUser       IGX 8420    9.2 Oct. 14 1998 17:37 GMT 
 
                           System-Wide Parameters
 
1  Max Time Stamped Packet Age (msec) ................................   32
2  Fail Connections On Communication Break ...........................   No
3  Max Network Delay for 'v' connections (msec).......................   14
4  Max Network Delay for 'c' connections (msec).......................   27
5  Max Network Delay for 't' & 'p' connections (msec).................   14
6  Max Network Delay for 'a' connections (msec).......................   27
7  Max Network Delay for High Speed Data connections (msec)...........   32
8  Max Network Delay for CDP-CDP 'v' connections (msec)...............   32
9  Max Network Delay for CDP-CDP 'c' connections (msec)...............   32
10 Max Network Delay for CDP-CDP 't' & 'p' connections (msec).........   32
11 Max Network Delay for CDP-CDP 'a' connections (msec)..............    32
 
                                                                                
                                                                                
This Command: cnfsysparm                                                        
                                                                                
                                                                                
Continue? n

System Response

In response to the "Continue" prompt at the bottom of the display, enter an "n," then enter a "1" to enter the maximum allowable age for a time-stamped packet.


sw171          VT    SuperUser       IGX 8420    9.2 Oct. 14 1998 17:37 GMT 
 
                           System-Wide Parameters
 
1  Max Time Stamped Packet Age (msec) ................................   40
2  Fail Connections On Communication Break ...........................   No
3  Max Network Delay for 'v' connections (msec).......................   14
4  Max Network Delay for 'c' connections (msec).......................   27
5  Max Network Delay for 't' & 'p' connections (msec).................   14
6  Max Network Delay for 'a' connections (msec).......................   27
7  Max Network Delay for High Speed Data connections (msec)...........   32
8  Max Network Delay for CDP-CDP 'v' connections (msec)...............   32
9  Max Network Delay for CDP-CDP 'c' connections (msec)...............   32
10 Max Network Delay for CDP-CDP 't' & 'p' connections (msec).........   32
11 Max Network Delay for CDP-CDP 'a' connections (msec)..............    32
 
 
                                                                                
This Command: cnfsysparm 1
 
 
Enter new value (in Decimal):

Enter the number of the parameter you wish to change, along with the value. For example, to change the Maximum Time-Stamped Packet Age (1) from 40 milliseconds to 42 milliseconds, enter:

: 1 42

Table 13-8: cnfsysparm—Parameters

Parameter	Description
index	Specifies a numerical value that refers to the specific parameter to be changed. Index numbers and descriptions of the system-wide parameters are in the table that precedes the command summary.
value	Specifies a numerical value that applies to the selected parameter. See Table 13-6.

deluser

Deletes a user from the network. A user can delete users at any lower privilege level.

Full Name

Delete a user

Syntax

deluser <user_id>

Related Commands

adduser, dspusers

Attributes

Privilege	Jobs	Log	Node	Lock
1-5	No	Yes	IGX, BPX	Yes

Example 1

deluser john

Description

Delete user "john."

alpha          TRM   YourID:1        IGX 8410    9.2    Aug. 16 1998 13:52 PST 
                                                                                
YourID       1                                                                  
Sarah        5                                                                  
 
 
 
 
 
\
 
 
 
 
 
                                                                                
Last Command: deluser John                                                      
                                                                                
                                                                                
Next Command:

Table 13-9: deluser—Parameters

Parameter	Description
userid	Specifies the name of the user to delete from the network.

dsplanip

The dsplanip command is similar to the dspnwip command. It displays the LAN IP address and subnet mask of the local node, and also displays the LAN IP address of all other nodes in the network, including feeder nodes. (Feeder nodes are displayed with a blank node name, and they appear immediately beneath the hub node to which they are attached.)

The dsplanip command displays the LAN IP address of all nodes reachable from a given node in the network.

The dsplanip command is new in Release 9.2 in support of the Out-of-Band network management feature which enables management traffic to be sent over IP to the switches' LAN Ethernet interface, thereby reducing the load on trunk bandwidth and node processor times.

Service-Affecting Alarms and Out-of-Band Network Management Features in Release 9.2

The service-affecting alarms feature enhances reporting of switch alarm conditions to Cisco WAN Manager, and to a customer network management system (NMS) through the Cisco WAN Manager RTM Proxy. New Robust Alarm messages are generated from existing switch events that could affect service.

The Out-of-Band network management feature in Release 9.2 enables management traffic to be sent over IP to switches' LAN Ethernet interface to Cisco WAN Manager, thereby reducing the load on trunk bandwidth and node processor times. For WAN Manager to be able to manage a switch out of band, the following things must be done:

To support out-of-band management feature and service-affecting alarms, SV+ must be running Release 9.2 or higher.
The LAN IP address of the switch must be configured.
LAN Ethernet access must be provided from the Cisco WAN Manager workstation to the switches' LAN port.
You may only use the "lanip" option for Cisco WAN Manager, which enables out-of-band management, if all switch nodes in the network are running switch software Release 9.2 or higher.
For an MGX 8220 (AXIS) interface shelf to be able to send LAN IP address changes to a routing node, it must be running MGX 8220 release 4.0.20 or higher.

To change the LAN IP address of a routing node you use the cnflan user command. The Out-of-Band Network Management software in Release 9.2 detects a change to the LAN IP address on a routing or feeder note and forwards an update message to Cisco WAN Manager.

Note The service-affecting alarms and out-of-band network management features in Release 9.2 can interoperate in mixed networks containing one or more nodes running switch software Release 9.1 or 8.5.

Full Name

Display LAN IP address of local node, and all nodes in the network

Syntax

dsplanip

Related Commands

dspphyslns, dsptrks

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX	No

Example 1

dsplanip

Description

Display the LAN IP address of local node, and all other reachable nodes in network.

System Response


sw248      TN      StrataCom       BPX 15 9.2.0     May 4 1998 18:28 GMT  
 
Active LAN IP Address:           172.29.9.155
Active LAN IP Subnet Mask:       255.255.255.0  
 
NodeName      LAN IP Address
sw252         172.29.9.159
              172.29.9.175
sw263         172.29.9.167
              172.29.9.163
sw8           172.29.9.124
sw248         172.29.9.155
              172.29.9.134
              172.29.9.173 
 
 
Last Command: dsplanip

dspnwip

Displays the IP address for each node in the network. The IP address is used to route TFTP messages transferring bulk statistics between the node and the WAN Manager Statistics Master.

Full Name

Display network IP interface

Syntax

dspnwip

Related Commands

cnfwip

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspnwip

Description

Display network IP addresses.


axiom1       TN    bootzilla       IGX 32    9.2       Sep. 5 1998  18:18 GMT
 
Active Network IP Address:             169.134.90.106
Active Network IP Subnet Mask:         255.255.255.0
 
NodeName   IP Address
axiom1   169.134.90.111
         169.134.90.105
         169.134.90.101
axiom2   169.134.90.102
axiom3   169.134.90.103
axiom1   169.134.90.106
 
 
Last Command: dspnwip
 
 
Next Command:

dsppwd

Displays the password of the current user or any user at any lower privilege level.

Full Name

Display password

Syntax

dsppwd <user_id>

Related Commands

adduser, cnfpwd, deluser, dspusers

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dsppwd yourid

Description

Display the password for user YourID.

System Response


alpha          TRM   YourID:1        IGX 8410    9.2    Aug. 16 1998 13:56 PST 
                                                                                
                                                                                
                                                                                
The password for YourID is liftoff

                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
This Command: dsppwd YourID                                                     
                                                                                
This screen will self-destruct in ten seconds                                   
Next Command: dsppwd YourID

Table 13-10: dsppwd—Parameters

Parameter	Description
userid	Specifies the user whose password is displayed.

dspsnmp

Display the following SNMP parameters for the current node:

Get Community String
Set Community String
Trap Community String
SNMP Set Request Queue Size
SNMP Queued Request Timeout, in seconds
SNMP Trap Event Queue Size

Full Name

Display SNMP parameters

Syntax

dspsnmp

Related Commands

cnfsnmp, dspsnmpstats

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspsnmp

Description

Display the SNMP parameters for the current node.

System Response


sw91           TN    SuperUser       IPX 8     9.2       Aug. 29 1998 13:45 GMT
 
Get Community String:                  NOACCESS
Set Community String:                  NOACCESS
Trap Community String:                 NOACCESS
 
SNMP Set Request Queue Size:           110
SNMP Queued Request Timeout (secs):    30
SNMP Trap Event Queue Size:            100
 
 
 
 
 
 
 
 
 
Last Command: dspsnmp
 
 
Next Command:

dspsnmpstats

Displays the following SNMP statistics for the node:

SVC Requests Received, the number of SVC requests received.
SVC Current Queue Length, the number of outstanding SVC requests in the queue.
SVC Maximum Queue Length, the high watermark of the number of outstanding SVC requests in the queue.
SVC Requests Timed Out, the number of SVC requests that have timed out.
Current Trap Managers, the number of managers (up to 10) that are currently registered, their IP addresses and UDP ports.
Traps Transmitted, the number of traps transmitted.
TRAP Current Queue Length, the number of outstanding traps in the queue.
TRAP Maximum Queue Length, the high watermark of the number of outstanding traps in the queue.
TRAP Queue Events Discarded, the number of traps discarded due to queue overflow.
Overflow Traps Transmitted, the number of overflow traps transmitted due to queue overflow.

Full Name

Display SNMP parameters

Syntax

dspsnmpstats

Related Commands

cnfsnmp, dspsnmp

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspsnmpstats

Description

Display SNMP statistics for the current node.

System Response


sw91           TN    SuperUser       IPX 8     9.2       Aug. 29 1998 13:21 GMT
 
SVC Requests Received:       256       Traps Transmitted:            256
 
SVC Current Queue Length:    0         TRAP Current Queue Length:    0
SVC Maximum Queue Length:    0         TRAP Maximum Queue Length:    0
SVC Requests Timed Out:      0         TRAP Queue Events Discarded:  196864
                                       Overflow Traps Transmitted:   100925440
 
Current Trap Managers:       0/10      Snmp_Trap_Db Ptr:             30DDCD02
 
 
 
 
 
 
 
 
Last Command: dspsnmpstats
 
 
Next Command:

dspsv3

Displays the Cisco WAN Manager L3 (Layer 3) Link Control Blocks.

The dspsv3 command displays the LCBs (Link Control Blocks) used by a switch to communicate with one or more SV+ workstations. The display shows whether the out-of-band (lanip) option is being used. Previous to Release 9.2, the dspsv3 screen indicated whether or not NWIP was being used. In Release 9.2, the dspsv3 screen distinguishes between the three modes supported in Release 9.2:

nwip_off
nwip_on
lanip

This command supports the Out-of-Band network management feature, which enables management traffic to be sent over IP to switches' LAN Ethernet interface, thereby reducing the load on trunk bandwidth and node processor times.

The dspsv3 command displays counts of pending SONET APS (Automatic Protection Switching) alarms.

Full Name

Display Cisco WAN Manager L3 (Layer 3s) Link Control Blocks

Syntax

dspsv3

dspsv3 <LCB number>

Table 13-11: Description of the Fields in the dspsv3 Display

Field	Explanation
Serial Admin	Serial link admin window
LAN Admin	LAN Admin window
LCB	Link Control Block number (0 is the gateway link)
Node	SV+ gateway node number (0 is local IO)
IP	IP address (* indicates nwip is enabled)

Related Commands

dsplanip

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	BPX	No

Example 1

dspsv3

Description

Display Cisco WAN Manager L3 Link Control Blocks.

System Response


nsaigx2       TN    StrataCom     IGX 8420    9.2    June 8 1998  06:11 GMT
 
Number of Active SV3 Links: 2        Serial Admin: None     LAN Admin: None
LCB:  0 Node:   0 IP:*172.16.64.20
LCB:  1 Node:   3 IP:*172.16.64.20
 
 
 
>Last Command: dspsv3

Example 2

dspsv3

System Response


 
sw248     TN      StrataCom     BPX 15 9.2.0            May 4 1998 18:05 GMT  
 
Number of Active SV3 Links: 2        Serial Admin: None       LAN Admin: None
LCB:    0 Node: 128 IP:N172.29.9.29
LCB:    1 Node: 128 IP:L172.29.9.53
LCB:    2 Node: 128 IP: 172.29.9.115  
 
 
 
Last Command: dspsv3

In Example 2, the summary display shows three Link 1 LCBs, which connect to three different SV+ workstations. The "N" next to the first IP address indicates the nwip_on option. The "L" next to the second address indicates the lanip option. The absence of a symbol on the third line indicates the nwip_off option.

Example 3

dspsv3

System Response


sw248      TN       StrataCom       BPX 15 9.1.a5        May 4 1998 18:11 GMT   
 
LCB: 1 Alloc: 1 sv3_lcb_ptr: 31514034
IP Address: 172.29.9.53 (lanip)
Response Timer: 0
Idle Timer: 393
Retry Count: 120
Current Protocol State: SV3_TRANSFER
No. of Buffers in the data_q: 0
No. of Buffers in the xmit_q: 0
No. of Buffers in the nflow_q: 0
Comm Break Alarm: Update: 0, Pending: 0
Comm Break Alarm Bitmaps: Update: 314741FC, Pending: 3147449C
 
 
 
 
Last Command: dspsv3 1

In Example 3, the detailed display below shows the state on an individual link control block. The display indicates the use of the lanip option.

Table 13-12: Description of the Fields in the dspsv3 Display

Field	Explanation
Serial Admin	Serial link admin window
LAN Admin	LAN Admin window
LCB	Link Control Block number (0 is the gateway link)
Node	SV+ gateway node number (0 is local IO)
IP	IP address (* indicates nwip is enabled)

Example 1

dspsv3 0

Description

Display Cisco WAN Manager L3 Link Control Blocks.

Table 13-13: Description of the Fields in the Previous dspsv3 Display

Field	Explanation
LCB	LCB number
Alloc	LCB allocated (1) or no (0)
sv3_lcb_ptr	Address of LCB in memory
IP Address	SV+ IP Address
Response Timer	SV+ Link Response Timer
Idle Timer	Display SV+ Link Idle Timer
Retry Count	SV+ Link Retry Count
Current Protocol State	Link state (idle, reset, transfer, poll)
No. of buffers in the data_q	Messages in the data queue
No. of buffers in the xmit_q	Messages in the transmit queue
No. of buffers in the nflow_q	Messages in the non-flow-controlled queue
Subscribed applications	Applications to which SV+ has subscribed
Update object(s)	Robust object types that have updated status
Pending	Robust object types that have been updated to SV+, and are waiting for an acknowledgment from SV+.

System Response


nsaigx2       TN    StrataCom     IGX 8420    9.2    June 8 1998  06:11 GMT
 
 
LCB: 0 Alloc: 1 sv3_lcb_ptr: 3120248C
IP Address: 172.29.9.60
Response Timer: 0
Idle Timer: 600
Retry Count: 120
Current Protocol State: SV3_TRANSFER
No. of Buffers in the data_q: 0
No. of Buffers in the xmit_q: 0
No. of Buffers in the nflow_q: 0
 
This Command: dspsv3 0
 
Continue?
 
LCB: 0 Alloc: 1 sv3_lcb_ptr: 3120248C
Subscribed Applications: Topology MaintLog
                         312024C0
 
               Update      Pending
Revision:      0           0
Stats Rebuild: 0           0
Subscription:  0           0            APS Alarm:     0 31202EB6  0 31202EDB
Feeder Obj:    0 312029D2  0 312029D4   Feeder Alarm:  0 31202ED8  0 31202EDA
Port Obj:      0 312029C6  0 312029CC   Port Alarm:    0 31202ECC  0 31202ED2
Conn Obj:      0 312024D0  0 31202741   Conn Alarm:    0 312029D6  0 31202C47
Cline Obj:     0 312029B2  0 312029B7   Cline Alarm:   0 31202EB8  0 31202EBD
Trunk Obj:     0 312029BC  0 312029C1   Trunk Alarm:   0 31202EC2  0 31202EC7
 
Last Command: dspsv3 0
 
Continue?
 
LCB: 0 Alloc: 1 sv3_lcb_ptr: 3120248C
Robust Database Updates data:
db_update_flags:     30D6E16C db_pending_flags:    30D6E355
flag_offset_table:   30D6E56C
  1:0    2:0    3:0    4:0    5:0    6:0    7:0    8:1    9:16  10:1A
11:59  12:0   13:D6  14:D7  15:0   16:DC  17:FC  18:0   19:13B 20:0
21:17B 22:17D 23:0   24:0   25:17F 26:0   27:180 28:0   29:181 30:183
31:0   32:0   33:0   34:185 35:0   36:0   37:186 38:0   39:0   40:0
41:0   42:0   43:0   44:0   45:0   46:187 47:0   48:0   49:0   50:0
51:18C 52:0   53:0   54:0   55:0   56:0   57:0   58:0   59:0   60:0
61:0   62:0   63:0   64:0   65:0   66:18D 67:0   68:0   69:0   70:0
71:0   72:0   73:18E 74:0   75:0   76:0   77:0   78:0   79:0   80:0
81:0   82:0   83:0   84:0   85:0   86:0   87:0   88:0   89:0   90:0
91:0   92:18F 93:18F 94:190 95:1A5 96:1A9 97:0   98:0   99:1E8 100:0
101:0   102:0   103:0   104:0
 
 
 
Last Command: dspsv3 0
 
LCB                          - LCB number
Alloc                        - LCB allocated (1) or not (0)
sv3_lcb_ptr                  - address of LCB in memory
IP Address                   - SV+ IP Address
Response Timer               - SV+ Link Response Timer
Idle Timer                   - Display SV+ Link Idle Timer
Retry Count                  - SV+ Link Retry Count
Current Protocol State       - Link state (idle, reset, transfer, poll)
No. of Buffers in the data_q - Messages in the data queue
No. of Buffers in the xmit_q - Messages in the transmit queue
No. of Buffers in the nflow_q- Messages in the non-flow-controlled queue
 
Subscribed Applications      - Applications to which SV+ has subscribed
 
Update                       - Robust object types that have updated object(s)
                               status.
Pending                      - Robust object types that have been updated to
                               SV+, and are waiting for an acknowledge from
                               SV+.
 
Robust database update bitmap addresses.

dsptsmap

Displays the following SNMP statistics for the node:

SVC Requests Received, the number of SVC requests received.
SVC Current Queue Length, the number of outstanding SVC requests in the queue.
SVC Maximum Queue Length, the high watermark of the number of outstanding SVC requests in the queue.
SVC Requests Timed Out, the number of SVC requests that have timed out.
Current Trap Managers, the number of managers (up to 10) that are currently registered, their IP addresses and UDP ports.
Traps Transmitted, the number of traps transmitted.
TRAP Current Queue Length, the number of outstanding traps in the queue.
TRAP Maximum Queue Length, the high watermark of the number of outstanding traps in the queue.
TRAP Queue Events Discarded, the number of traps discarded due to queue overflow.
Overflow Traps Transmitted, the number of overflow traps transmitted due to queue overflow.

Full Name

Display SNMP parameters

Syntax

dspsnmpstats

Related Commands

cnfsnmp, dspsnmp

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspsnmpstats

Description

Display SNMP statistics for the current node.

System Response


sw91           TN    SuperUser       IPX 8     9.2       Aug. 29 1998 13:21 GMT
 
SVC Requests Received:       256       Traps Transmitted:            256
 
SVC Current Queue Length:    0         TRAP Current Queue Length:    0
SVC Maximum Queue Length:    0         TRAP Maximum Queue Length:    0
SVC Requests Timed Out:      0         TRAP Queue Events Discarded:  196864
                                       Overflow Traps Transmitted:   100925440
 
Current Trap Managers:       0/10      Snmp_Trap_Db Ptr:             30DDCD02
 
 
 
 
 
 
 
 
Last Command: dspsnmpstats
 
 
Next Command:

dspusers

Displays users. The privilege levels in the display are restricted to those of the current user and any privileges below the current user.

Full Name

Display users

Syntax

dspusers

Related Commands

adduser, deluser, dspusers

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspusers

Description

Display the users on a network.

dspusertask

Displays information about the current user-task. The displayed information varies with the user task. For example, information about a vt session slightly differs from a telnet session. The command takes a user task number as an argument. If the user task number is unknown, enter the command without a number to see a list of possible user tasks and the current user task. The types of user tasks are as follows:

User, which can be the control terminal user, auxiliary port user, or StrataView
A telnet session
A virtual terminal session (vt)
An SNMP agent
A job

Full Name

Display user task

Syntax

dspusertask [user task number]

Related Commands

adduser, cnfpwd, deluser, dspusers, dsppwd

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspusertask

Description

Display user task information—without specifying a task in this case. This example shows a case in which the user has started a vt session on a node. See also step 2 of this example.

System Response


sw78           VT    SuperUser       BPX 15    9.2      Jan. 31 1998 15:52 PST
 
 #  TASK PURPOSE      USER ID            #  TASK PURPOSE      USER ID
 -- ---- ------------ -------            -- ---- ------------ -------
 1  USR1 control port none               13 VT-5 VT           none
 2  USR2 auxilry port none               14 VT-6 VT           none
 3  USR3 lan port(SV) none               15 SNMP agent        n/a
 4  TN-1 lan (telnet) none               16 JOBS runs jobs    n/a
 5  TN-2 lan (telnet) none
 6  TN-3 lan (telnet) none
 7  TN-4 lan (telnet) none
 8  TN-5 lan (telnet) none
 9  VT-1 VT: sw81     SuperUser   < You
 10 VT-2 VT           none
 11 VT-3 VT           none
 12 VT-4 VT           none
 
 
This Command: dspusertask
 
 
Please Enter User Number:9

Example 2

Description

This example shows the screen after the you enter a 9 at the prompt in the previous screen, a case in which you already started a vt session on a node. Note that the display shows the status as a vt slave, and the node on which the vt session originated is sw81.

sw78           VT    SuperUser       BPX 15    9.2      Jan. 31 1998 15:53 PST
 
 
    Task: VT-1
    Logged in as: SuperUser
    VT master:  no
    VT slave:   yes    Master node is: sw81
    VT pending: no
 
    Public  lock: no
    Private lock: none
 
    No command is currently running.
    Previous command: dspusertask 9
 
 
Last Command: dspusertask 9
 
 
Next Command:

Table 13-14: dspusertask—Parameters

Parameter	Description
user task number	Specifies the number of the user task whose information is displayed.

dspusertasks

Displays general information about all current user tasks. The types of user tasks are as follows:

User, which can be the control terminal user, auxiliary port user, or Cisco WAN Manager
A telnet session
A virtual terminal session (vt)
An SNMP agent
A job

Full Name

Display user tasks

Syntax

dspusertasks

Related Commands

adduser, cnfpwd, deluser, dspusers, dsppwd, dspusertask

Attributes

Privilege	Jobs	Log	Node	Lock
1-6	No	No	IGX, BPX	No

Example 1

dspusertasks

Description

Display user task information.

System Response


sw151          TN    SuperUser       IGX 8420    9.2       Aug. 14 1998 18:02 GMT
 
 #  TASK  PURPOSE     USER ID            #  TASK  PURPOSE     USER ID
 -- ---- ------------ -------            -- ---- ------------ -------
 1  USR1 control port SuperUser          13 VT-5 VT           none
 2  USR2 auxilry port none               14 VT-6 VT           none
 3  USR3 lan port(SV) none               15 SNMP agent        n/a
 4  TN-1 lan (telnet) none               16 JOBS runs jobs    n/a
 5  TN-2 lan (telnet) SuperUser   < You
 6  TN-3 lan (telnet) none
 7  TN-4 lan (telnet) none
 8  TN-5 lan (telnet) none
 9  VT-1 VT           none
 10 VT-2 VT           none
 11 VT-3 VT           none
 12 VT-4 VT           none
 
 
Last Command: dspusertasks
 
 
Next Command:

Table of Contents

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

System Response

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

Full Name

Syntax

Related Commands

Attributes

Example

Description

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

System Response

System Response

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

System Response

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

System Response

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

System Response

Full Name

Syntax

Related Commands

Attributes

Example 1

Description

System Response