![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
This chapter describes the CiscoWorks Blue Maps data-link switching (DLSw) application. It contains the following main sections:
If you prefer to view the DLSw information from a web browser, see the chapter "Using the Web Browser."
DLSw Maps provides the following main views of your network devices:
From these DLSw map views, you can obtain additional DLSw-related information by selecting the popup menu associated with a device on the map. Data-link switching plus (DLSw+) network entities, such as border nodes, backup nodes, and group numbers, are shown as regular DLSw nodes on the map.
This section describes how to start the DLSw application. You can start the DLSw application from the workstation system prompt or from a network management system, such as NetView for AIX.
To start DLSw from a network management system:
You can start DLSw from any valid user account. The installation process establishes a sample default user account named cwblue. The user cwblue does not have a starting password. You can either assign a password to cwblue or log in as root and change to cwblue. Then start the DLSw application.
To start the DLSw application from a system prompt, you can use the cwb start dlsw command. The command sets up all the environment variables, starts the DLSw monitor and poller daemons, and then calls the dlsw executable. To start the DLSw application, enter the following commands:
cd /opt/CSCOcb/bin
./cwb start dlsw
You can log in to a remote UNIX host from your own local UNIX workstation, export the remote host display to your local workstation, and then run the application from the remote host. To start the remote host's DLSw application from your local workstation, use the following procedure:
Step 1 At your local UNIX workstation, enter the following command:
xhost +
Step 2 Log in to the remote UNIX host.
Step 3 Set your DISPLAY environment variable to export the display from the remote host to your local workstation. Depending on which shell you are using, use one of these commands.
setenv DISPLAY
export DISPLAY=IP_address:0.0
setenv DISPLAY IP_address:0.0
Step 4 To start DLSw, enter the following commands:
cd /opt/CSCOcb/bin
./cwb start dlsw
This section describes what happens when you start DLSw for the first time (or when you select View>Key Devices from the menu bar).
When it first starts, DLSw tries to display a special view called the key devices view. The key devices view displays those routers that you have designated as "key devices." Key devices are explained in the CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide.
If no devices are designated as key devices, the key devices view is empty. DLSw determines whether there are any routers enabled for DLSw in the Maps database. Depending on whether there are DLSw--------enabled routers in the database, DLSw proceeds as described in the following sections:
If the key devices view is empty and there are no DLSw routers in the Maps database, then discovery was not done. DLSw displays this message:
Key devices discovery needs to be performed.
Please create a seed file with "key" tags in it.
After that, select Admin->Discover->Seed File.. on that seed file.
OK?
Ask your network administrator to run a discovery process, as described in the CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide.
If the key devices view is empty, but there are DLSw routers in the Maps database, then discovery was done but no key routers are designated. DLSw displays the message window shown in Figure 4-1.
Report this problem to your network administrator, who will use the processes outlined in the CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide to designate key routers.
This section describes how to locate and select devices on the DLSw map.
There are two methods for locating a device on the map:
To locate a device from the View menu you must know the device's IP address or host name. Then use the following procedure:
Step 1 From the DLSw menu bar, select View>Locate.
Step 2 Select either By Name or By IP Address.
Step 3 Enter the IP address or host name of a router.
Step 4 Click Locate.
DLSw displays the part of the map that contains the selected device and highlights the device.
If the set of devices on any map is not up-to-date because automatic update is disabled or set to an infrequent interval, and you have not chosen to list target devices in a seed file, you can add and delete devices manually. From the Edit menu, you can select either Add Device or Delete Device(s).
When you add or delete a device, the DLSw application prompts you for the device's host name or IP address and read community string. If the device is found to belong on this map, the application immediately adds a new device to the map or removes an existing device, depending on the menu item you selected.
If a Cisco device does not appear on the map, but you know that it exists in the network, add the device using Edit>Add Device from the Maps menu bar.
After you add or delete a device from the map, you can save that device in your seed file with the cwb create seed command:
cd /opt/CSCOcb/etc
./cwb create seed -s seed_file_name
Where seed_file_name is the name of the seed file.
Each icon on the DLSw map has an associated popup menu. To activate the menu, click the icon with the right mouse button. Table 4-1 lists the popup menus associated with the icon.
Icon | Popup Menu Items |
---|---|
Router | Information---Displays information about the selected known router, including the DLSw version, the version of Cisco IOS that the router is running, DLSw performance information, and circuit information. Peer Statistics---Displays a list of the selected router's peer routers. When you select a peer router, you will see detailed statistics about that peer router. The Peer Statistics option is available in the focus view and global view only. Circuit List---Displays the Circuit List window for a known router. After you select the filter criteria, it displays a list of circuits that meet the filter criteria. You can double-click the displayed circuits to view more detailed information about the circuit and its component devices and links. Rediscover---Rediscovers the router information and updates the router information in the Maps database. Telnet---Starts a Telnet client that logs you in to the selected device. |
Aggregated Peer Router | Focus View---Displays a focus view map for the key router. Aggregate Summary---Displays information about the aggregated peer connection. |
Aggregated Peer Connection | Focus View---Displays a focus view map for the key router. Aggregate Summary---Displays information about the aggregated peer connection. |
The DLSw map presents several views of your DLSw network devices:
The key devices view is displayed when you start the DLSw application. To display the key devices view at any other time, select View>Key Devices from the DLSw menu bar. The key devices view is displayed, as shown in Figure 4-2.
The key devices view displays the key routers in the network. For any one key router, all its peer routers are displayed as a single icon that represents the aggregation of those peer routers. From any one key router, all the peer connections to its peer routers are displayed as a single peer connection. The color of the aggregated peer router and aggregated peer connection both reflect the status of the links that make up the aggregated peer connection.
From the key devices view, you can select an aggregated peer router icon or aggregated peer router icon with the right mouse button. Select Focus View from the menu to display a focus view for the key router.
You can also select an aggregated peer router icon or an aggregated peer connection icon and select Aggregate Summary from its popup menu to see information about the individual peer connections that make up the aggregation.
To display the global view, select View>Global from the DLSw menu bar. The global view is displayed, as shown in Figure 4-3.
The following sections describe the ways you can display the focus view for a router.
To display the focus view for a specific router from the View menu, use the following procedure:
Step 1 Locate the router in the main window.
Step 2 Click the router with the right mouse button.
Step 3 From the popup menu, select Focus View.
To display the focus view for a router from the View menu, use the following procedure:
Step 1 From the DLSw menu bar, select View>Focus.
Step 2 Type in the device name of the router.
Step 3 Click OK.
To display the focus view for a selected router from the View menu, use the following procedure:
Step 1 Locate the router in the main window.
Step 2 Click the router with the left mouse button to select it.
Step 3 Select View>Focus.
Step 4 Click OK in the Focus Peer Prompt window.
Once you locate a router on the map, you can display information about that router by doing the following steps:
Step 1 Locate the router in the main window.
Step 2 Click the router with the right mouse button.
Step 3 Select Information from the router's popup menu.
The DLSw application displays the Peer Information window, as shown in Figure 4-4, that contains information about that router, including the DLSw and Cisco IOS versions, connections, and circuits.
In the Peer Information window, you can click Refresh to update the view.
Table 4-2 describes the fields in the Peer Information window.
Field | Description |
---|---|
DLSw Version | Version of DLSw used between local and remote peers. |
Vendor ID | Name of the DLSw vendor and its ID. |
IOS Version | Cisco IOS release running on the router. |
Pacing Support | Receiving window size. The possible values are NONE, ADAPTIVE, and FIXED. |
Up Time | Elapsed time since the DLSw router entered the active state. |
Largest DLSw Frame | Largest frame size (including DLC header and information field but not any MAC-level or framing octets) that this DLSw router can forward on any path through itself. |
Active Peer Connections | Number of transport connections that are not in the disconnected state. |
Busy Connections Closed | Number of times transport connections in this node exited the connected state with some non-zero number of active circuits on the transport connection. |
Active Circuits | Current number of circuits that are not in the disconnected state. |
Circuits Created | Total number of circuits added or reactivated upon exiting the disconnected state table. |
Step 1 Locate the router in the main window in the focus view or global view.
Step 2 Click the router with the right mouse button.
Step 3 Select Peer Statistics from the router's popup menu. If the router has more than one peer connection, the Select Peer window is displayed.
Step 4 If the Select Peer window is displayed, select the peer connection you want to see and click Get.
The DLSw application displays a Peer Statistics window, shown in Figure 4-5, that contains routing statistics for the peer connection. In the Information window, you can click Refresh to update the view.
Table 4-3 describes the fields in the Peer Statistics window.
Field | Description |
---|---|
State | State of the transport connection. |
Local Address | Local transport address for this transport connection. |
Remote Address | Remote transport address of the transport connection. |
Transport | Transport domain of the transport connection. |
Flow Control Mode | Flow control mechanism in use on the transport connection. Values are UNDETERMINED, PACING, and OTHER. |
Sap List | Supported SAP list received in the capabilities exchange message from the peer DLSw router. |
Data Packets In | Number of Switch-to-Switch Protocol (SSP) messages of type DGRMFRAME, DATAFRAME, or INFOFRAME received on this transport connection. |
Data Packets Out | Number of SSP messages of type DGRMFRAME, DATAFRAME, or INFOFRAME transmitted on this connection. |
Data Octets In | Number of octets in SSP messages of type DGRMFRAME, DATAFRAME, or INFOFRAME received on this transport connection. |
Data Octets Out | Number of octets in SSP messages of type DGRMFRAME, DATAFRAME, or INFOFRAME transmitted on this connection. |
Control Packets In | Number of SSP messages received on this transport connection which were not of type DGRMFRAME, DATAFRAME, or INFOFRAME. |
Control Packets Out | Number of SSP messages transmitted on this transport connection which were not of type DGRMFRAME, DATAFRAME, or INFOFRAME. |
CanUReach expl Sent | Number of CanUReach_ex messages sent on the transport connection. |
ICanReach expl Rcvd | Number of ICanReach_ex messages received on the transport connection. |
CanUReach expl Rcvd | Number of CanUReach_ex messages received on the transport connection. |
ICanReach expl Sent | Number of ICanReach_ex messages sent on the transport connection. |
NETBIOS NQ Sent | Number of NetBIOS_NQ_ex messages sent on the transport connection. |
NETBIOS NR Rcvd | Number of NetBIOS_NQ_ex messages received in the transport connection. |
NETBIOS NR Sent | Number of NETBIOS_NR_ex messages sent on this transport connection. |
NETBIOS NQ Rcvd | Number of NetBIOS_NQ_ex messages received in the transport connection. |
Circuits Created | Number of times that circuits entered a circuit-established state (not counting transitions from circuit-restart). |
Active Circuits | Number of currently active circuits on this transport connection. |
Step 1 Locate the router in the main window.
Step 2 Click the router with the right mouse button.
Step 3 Select Circuit List from the router's popup menu.
The Circuit List window, as shown in Figure 4-6, shows a list of the circuits that pass through the selected router. For each circuit, the Circuit List window displays the name, MAC, and service access point (SAP) for the host network connection and for the PU on the circuit (the host and the remote PU).
In the Information window, click Refresh to get a more up-to-date view.
Table 4-4 describes the fields in the Circuit List window.
Field | Description |
Filter | Enter MAC and SAP addresses and click Get Next to get a new set of circuits based on the new MAC and SAP addresses. |
Resource1 | PU name of the resource associated with the router in the title bar. |
MAC1 Address | MAC address of Resource1. |
SAP1 Address | SAP address of Resource1. |
Resource2 | PU name in the circuit that is associated with the peer router. |
MAC2 Address | MAC address of Resource2. |
SAP2 Address | SAP address of Resource2. |
State | State of the circuit connection, which can be DISCONNECTED, CIRCUIT START, RESOLVE PENDING, CIRCUIT PENDING, CIRCUIT ESTABLISHED, CONNECT PENDING, CONTACT PENDING, CONNECTED, DISCONNECT PENDING, HALT PENDING, HALT PENDING NOACK, CIRCUIT RESTART, or RESTART PENDING. |
Step 4 Double-click a circuit (one row of information) in the Circuit List window to display a Circuit Information window (Figure 4-7), which shows a diagram of the entire circuit and lists information about the peer routers in the circuit.
Table 4-5 describes the fields in the Circuit Information window.
Field | Description |
Router Name | Device name of the DLSw router. |
Circuit Identifier | Circuit identifier assigned by this DLSw node to this circuit. The first four octets are the Data Link Control (DLC) port ID, and the second four octets are the data link correlator. |
Interface Index | IfEntry index of the local interface through which the PU can be reached. |
DLC Type | DLC protocol in use between the DLSw node and the PU. The possible values are QLLC, SDLC, LLC, NA, or Other. |
Route Information | If source-route bridging is in use between the DLSw node and the PU, this is the routing information field describing the path between the two devices. Otherwise the value will be an octet string of zero length. |
Max Messages Sendable | Number of paced Switch-to-Switch Protocol (SSP) messages that this DLSw router is authorized to send on this circuit before it must stop and wait for an additional flow control indication from the partner DLSw router. |
Send Window Size | Current window size that this DLSw is using in its role as a data sender. This is the value by which the router can increase the number of messages it is authorized to send if it receives a flow control indication with the bits specifying a repeat window. |
Max Messages Receivable | Current number of paced SSP messages that this DLSw router has authorized the partner DLSw router to send on this circuit before the partner DLSw must stop and wait for an additional flow control indication from this DLSw router. |
Receive Window Size | Current window size that this DLSw router uses in its role as a data receiver. This is the number of additional paced SSP messages that this DLSw router can authorize its DLSw partner router to send if this DLSw router sends a flow control indication with the bits specifying a repeat window. |
Receive Largest Window | Largest receive window size granted by this DLSw router during the current activation of this circuit. This is not the largest number of messages granted at any time, but the largest window size as represented by FCIND operator bits. |
Send Largest Window | Largest send window size (with respect to this DLSw router) granted by the partner DLSw router during the current activation of this circuit. |
Halve Window Sent | Number of Halve window operations this DLSw has sent on this circuit, in its role as a data receiver. |
Reset Window Sent | Number of Reset window operations this DLSw router has sent on this circuit, in its role as a data receiver. |
Halve Window Received | Number of Halve window operations this DLSw router has received on this circuit, in its role as a data sender. |
Reset Window Received | Number of Reset window operations this DLSw router has received on this circuit, in its role as a data sender. |
While in the key devices view, you can display a focus view of a key router from its aggregated peer router or its aggregated peer connection by using the following procedure.
Step 1 Locate an aggregated peer router in the main window.
Step 2 Click the router with the right mouse button.
Step 3 Select Focus View from the router's popup menu. The application displays the focus view for the key router that is the peer to the routers that are represented by the selected aggregated peer router.
While in the key devices view, you can display summary information about the peer connections that are represented by an aggregated peer router icon or aggregated peer connection icon.
Step 1 Locate an aggregated peer router or aggregated peer connection in the main window.
Step 2 Click the icon with the right mouse button.
Step 3 Select Aggregate Summary from the icon's popup menu. The application displays the summary of aggregated peer connections, as shown in Figure 4-8. This aggregation does not include connections to other key devices.
Table 4-6 describes the fields in the Aggregate Summary window.
Field | Description |
Total Non-Key Peer Connections | Total number of peer connections that are aggregated into this icon. This count does not include connections to key devices. |
Number of Active | Number of active peer connections that are aggregated into this icon. |
Number of Inactive | Number of inactive peer connections that are represented by this icon. |
Number of Degraded | Number of degraded peer connections that are represented by this icon. |
Number of Unknown | Number of unknown peer connections that are represented by this icon. |
You can change the view by selecting one of the following items from the View menu:
You can retrieve the dependency view information for a PU or LU. Maps gets the PU and LU information from the VTAM at the mainframe and displays the PU and LU information at the workstation in logical maps. You can display information about specified PUs and LUs, and you can see their dependency paths through the network to the VTAM host. There are several ways to retrieve PU and LU information, depending on whether you know the PU or LU name, and on what you want to do with the PU or LU once you locate it.
If you know the name of the PU or LU, you can use the View menu on the Maps menu bar to locate a PU or LU and display a dependency view. To view a PU or an LU from the View menu, use the following procedure:
Step 1 From the DLSw application's menu bar, select View. The View menu is displayed.
Step 2 From the View menu, select PU to view a PU, or select LU to view an LU. The PU/LU Prompt window is displayed, as shown in Figure 4-9.
Step 3 From the PU/LU Prompt window, enter the PU name or LU name in the format NAME.DOMAIN.
Step 4 Click OK. Maps displays a dependency view for the selected PU or LU.
If you would rather select the PU names from a filtered list, you can use the PU item on the Tools menu, which lets you set up filtering criteria to search for a PU name based on VTAM information or on its router or Token Ring dependency. From the Map application's menu bar, select Tools>PU to display the PU Filter window, as shown in Figure 4-10.
When you select PU from the Maps Tools menu, the application displays the PU Filter window (Figure 4-10) to let you configure a filter to be used in selecting which PUs to display in a PU List window. Select PUs the following ways:
Click Apply to display all the PUs filtered as you requested. The PU List window is described in the section "Using the PU List Window."
You can filter the PU List based on the PU name, PU state, and PU type.
Step 1 From the PU Filter window, select By VTAM Info.
Step 2 In the PU Name field, enter all of a PU name, or just part of a PU name and wildcards. The PU List will contain PUs with names that match the filter criteria:
Step 3 In the PU State field, select one or more PU states. The PU List window will contain the names of PUs that match one of the PU states that you select.
Step 4 In the PU Type field, select one or more PU types. The PU List window will contain PUs whose type matches one of the PU types that you select.
Step 5 Click Apply.
Use the following procedure to filter PUs by dependency:
Step 1 From the PU Filter window, select By Dependency to filter the PU List based on the router dependency.
Step 2 Select one or more routers from the Routers field in the PU Filter window.
Step 3 Click Apply.
The PU List window displays the PUs dependent on the selected routers.
Select Get All PUs and then click Apply to display a PU List that contains all discovered PUs.
This section describes how to use the functions of the PU List window, shown in
Figure 4-11. The PU List window shows all the PU names that satisfy the same set of PU filter criteria.
The PU List window is static; select View>Refresh to update the status.
From the PU List window, you can do the following tasks:
You can activate a PU from the PU List window. This action is comparable to using the VTAM command VARY NET,ACT,ID=PU_name.
To activate a PU from the PU List window, use the following procedure:
Step 1 Select an inactive PU from the PU List window.
Step 2 From the PU List window menu bar, select Activate.
Step 3 From the Activate menu, select one of the following:
You can deactivate an active PU from the PU List window. This is comparable to issuing the VTAM command VARY NET,INACT,ID=PU_name. To deactivate a PU from the PU List window, use the following procedure:
Step 1 Select an active PU from the PU List window.
Step 2 From the PU List window menu bar, select Deactivate.
Step 3 From the Deactivate menu, select one of the following:
From the PU List window you can display a list of LUs attached to a PU. To display an LU list, use the following procedure:
Step 1 Select a PU from the PU List window.
Step 2 From the PU List menu bar, select View>Show LU List. The LU List window is displayed.
For information about using the LU List window, read the section "Using the LU List Window."
From the PU List window you can display a dependency view of the path from the PU back toward the VTAM host. To display a dependency view, use the following procedure:
Step 1 Select a PU from the PU List window.
Step 2 From the PU List menu bar, select View>Dependency.
Maps displays the PU dependency view, as shown in Figure 4-12.
Step 3 Because the PU dependency view is static, select View>Refresh to update the status.
The PU dependency view shows the network components from the PU itself, back toward the mainframe to the host network connection. The PU dependency view shown in Figure 4-12 includes the following network components, starting at the top:
From the PU List window, you can configure a new PU filter to display a new set of PU names in the PU List window. To configure a new PU List filter, use the following procedure:
Step 1 From the PU List menu bar, select View>Filter.
Step 2 Choose your filtering options: By VTAM Info, By Dependency, and Get All PUs. (These options are explained in the section "Filtering the PU List.")
Step 3 Click Apply.
You can use the LU item on the Tools menu to set up filtering criteria to search for an LU name based on VTAM information or on its router or Token Ring dependency. From the Map application's menu bar, select Tools>LU to display the LU Filter window, as shown in Figure 4-13.
The LU Filter window (Figure 4-13) lets you configure a filter that will be used to select the LUs to display in an LU List window. Select LUs in the following ways:
The LU List window is described in the section "Using the LU List Window."
You can filter the LU List based on the LU name, PU name, and LU state.
Step 1 From the LU Filter window, select By VTAM Information.
Step 2 In the LU Name field, enter all of an LU name, or just part of an LU name and wildcards. The LU List contains LUs with names that match the filter criteria:
Step 3 In the LU State field, select one or more LU states. The LU List window will contain the names of LUs that match one of the LU states that you select.
Step 4 In the LU Type field, select one or more LU types. The LU List window will contain LUs whose type matches one of the LU types that you select.
Step 5 Click Apply.
You can filter the LU List based on the router dependency. Select one or more routers from the Routers field in the LU Filter window. The LU List window will contain the LUs dependent on the selected routers.
From the LU Filter window, you can select Get All LUs to display an LU List that contains all LUs discovered by SNA View.
This section describes how to use the functions of the LU List window, shown in
Figure 4-14. The LU List window shows all the LU names that satisfy the same LU filter criteria. The LU List window is static; select View>Refresh to update the status.
From the LU List window, you can perform the following actions:
You can activate an LU from the LU List window. This is comparable to issuing the VTAM command VARY NET,ACT,ID=LU_name.
To activate an LU from the LU List window, use the following procedure:
Step 1 Select an inactive LU from the LU List window.
Step 2 From the LU List menu bar, select Activate.
Step 3 From the Activate menu, select one of the following:
You can deactivate an active LU from the LU List window. This is comparable to issuing the VTAM command VARY NET,INACT,ID=LU_name. To deactivate an LU from the LU List window, perform the following steps:
Step 1 Select an active LU from the LU List window.
Step 2 From the LU List menu bar, select Deactivate.
Step 3 From the Deactivate menu, select one of the following:
From the LU List window you can display a dependency view of the path from the LU back toward the VTAM host. To display an LU dependency view, use the following procedure:
Step 1 Select an LU from the LU List window.
Step 2 From the LU List menu bar, select View>Dependency.
Maps displays the LU dependency view, as shown in Figure 4-15.
Step 3 Because the LU dependency view is static, select View>Refresh to update the status.
The LU dependency view shows the network components from the LU itself, back toward the mainframe to the host network connection. The LU dependency view shown in Figure 4-15 includes the following network components, starting at the top:
From the LU List window, you can configure a new LU filter to display a new set of LU names in the LU List window. To configure a new LU List filter, use the following procedure:
Step 1 From the LU List menu bar, select View>Filter.
The LU Filter window is displayed.
Step 2 Choose your filtering options: By VTAM Info, By Dependency, or Get All LUs. (These options are explained in the section "Filtering the LU List.")
Step 3 Click Apply.
The colors and symbols on a DLSw map have the following meanings:
Table 4-7 shows the icons that can appear on a DLSw map.
Icon | Description |
---|---|
![]() | Token Ring |
![]() | Routing information field (RIF)
|
![]() | Known DLSw router
|
![]() |
Focus router
|
![]() |
Router not known to CiscoWorks Blue Maps (not discovered)
|
![]() |
Aggregated peer routers
|
![]() |
PU in a dependency view |
![]() |
LU in a dependency view |
![]() |
Physical connection |
![]() |
Logical connection or aggregated link |
Posted: Wed Jun 30 06:25:36 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.