Using the RSRB Application

The RSRB Maps application discovers Cisco IP-based, RSRB-enabled routers in your network and displays them in a map. Using the RSRB Maps application, you can do the following tasks:

View your entire network or specific portions of your network
View changes to peer states
Get network traffic statistics for a peer
Get peer information

RSRB Maps provides the following main views of your network devices:

The global view shows all routers in the RSRB network with their virtual and associated rings.
The virtual ring view shows a specific virtual ring with all routers belonging to that virtual ring. Peer routers are displayed on this map.
The focus view shows the RSRB network from a specified router (focus router). The focus router, its peers, associated rings, and virtual rings appear on this map.
The PU and LU dependency views show the devices in the network path from a PU or LU back toward the VTAM host.

From these RSRB map views, you can obtain additional RSRB-related information by selecting the popup menu associated with a device on the map.

Starting RSRB

This section describes how to start the RSRB application. You can start the RSRB application either from the workstation system prompt or from a network management system, such as NetView for AIX.

Starting the RSRB Application from a Network Management System

To start RSRB from a network management system:

On SunNet Manager select Tools>CWB-DLSW from the menu bar.
On HP-OV and NetView for AIX select CWBlue>DLSW from the menu bar.

Starting RSRB from a System Prompt

You can start RSRB 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.

To start the RSRB application from a system prompt, enter the commands shown below:

cd /opt/CSCOcb/bin
./

cwb start rsrb

Starting RSRB from a Remote Workstation

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 RSRB 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, using the following commands:

From the K shell (ksh):

setenv DISPLAY

export DISPLAY=IP_address:0.0

From the C shell (csh) or TC shell (tcsh):

setenv DISPLAY IP_address:0.0

Step 4 To start RSRB, enter the following commands:

cd /opt/CSCOcb/bin
./

cwb start rsrb

Locating Devices on the RSRB Map

This section describes how to locate and select devices on the RSRB map. There are two methods for locating a device on the map:

Select View>Locate from the menu bar if you know the IP address or host name of the you device.
Use the Locator window if you do not know the IP address or host name.

Locating a Device Using the View Menu

To locate a device from the View menu you must know the device's IP address or device name. Then use the following procedure:

Step 1 From the RSRB menu bar, select View>Locate.

Step 2 Select either By Name or By IP Address.

Step 3 Enter the IP address or name.

If you enter a host name, you must specify the name in the same form shown on the map: the device name is case-sensitive. If you want to locate a device by name, that device name must be in either the seed file or the database. There is no domain-name lookup provided.
If you enter an IP address, it can be any IP address configured on the device.

Step 4 Click Locate.

RSRB displays the part of the map that contains the selected device and highlights the device.

Adding and Deleting Devices on an RSRB Map

If a set of devices on any map is not up-to-date because automatic update is disabled or is 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(s) or Delete Device(s).

When you add or delete a device, RSRB 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 places a new device on 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, 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.

Note The device appears on the RSRB map only if the RSRB protocol is running on the router and is at the prerequisite Cisco IOS release, and if it is appropriate to that view.

Displaying Popup Menus on an RSRB Map

Each icon on the RSRB map has an associated popup menu. To activate the menu, click the icon with the right mouse button. Table 5-1 lists the popup menus associated with each map icon.

Icon	Popup Menu Items
Router	Focus View---When selected from a known router in the global view, displays the focus view for the selected router. In the focus view for a known router, there is no popup menu for the router that is in focus. Peer Info---When selected from the focus view of a peer router, displays information about the focus router's peer router.
Real Ring (an oval)	Ring Info---When selected in the focus view for a router, displays information about the selected ring, such as bridge number, ring type, MAC address. PU List---Displays a dependency list of PU names: a list of PUs that are dependent on the selected ring.
Virtual Ring (a circle)	Virtual Ring View---When selected from the global view, displays a virtual ring view of the network: the routers and real rings that together make up the virtual ring. Global View---When selected from the virtual ring view, displays the global view.

Table 5-1: Popup Menus on the RSRB Map

Icon Popup Menu Items

Router

Focus View---When selected from a known router in the global view, displays the focus view for the selected router. In the focus view for a known router, there is no popup menu for the router that is in focus.

Peer Info---When selected from the focus view of a peer router, displays information about the focus router's peer router.

Real Ring (an oval)

Ring Info---When selected in the focus view for a router, displays information about the selected ring, such as bridge number, ring type, MAC address.

PU List---Displays a dependency list of PU names: a list of PUs that are dependent on the selected ring.

Virtual Ring (a circle)

Virtual Ring View---When selected from the global view, displays a virtual ring view of the network: the routers and real rings that together make up the virtual ring.

Global View---When selected from the virtual ring view, displays the global view.

Viewing the Network Devices

RSRB presents a global (high-level) view of the applicable network devices. The global view presents an up-to-date view of virtual rings (displayed as circles), physical rings (displayed as ovals), pseudo-rings (displayed as dotted ovals), RSRB-enabled peers and their status, physical links (displayed as solid lines), and virtual links (displayed as dashed lines). Dashed lines also show connections to non-RSRB rings.

Displaying the Global View of the Network

The global view is displayed when you start the RSRB application. To display the global view at any other time, select View>Global from the RSRB menu bar. The global view is displayed, as shown in Figure 5-1.

Figure 5-1: RSRB Global View

Displaying a Focus View of a Router

The focus view displays a subset of the network from the viewpoint of a single router, called the focus router. The following sections describe the ways you can display the focus view for a router. Figure 5-2 shows the focus view for router cwb-c8.cisco.com.

Figure 5-2: RSRB Focus View of a Router

Displaying the Focus View from a Popup Menu

To display the focus view for a 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.

Displaying the Focus View from the View Menu

To display the focus view for a router from the View menu, use the following procedure:

Step 1 From the RSRB menu bar select View>Focus. The Focus View Prompt window is displayed.

Step 2 In the Focus View Prompt window, enter the device name of the router.

Step 3 Click OK.

Displaying the Focus View from the View Menu with a Router Selected

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 from the menu bar. The Focus View Prompt window is displayed.

Step 4 In the Focus View Prompt window, click OK.

Displaying Information about a Peer

Once you locate a router on the map, you can find and display information about that router's peer routers in the network using the following procedure:

Step 1 Locate the router in the main window.

Step 2 Click the router with the left mouse button.

Step 3 Select View>Focus.

Step 4 Click OK in the Focus Peer Prompt window.

Step 5 In the focus view, select a peer router with the right mouse button.

Step 6 From the popup menu, select Peer Info.

Displaying a Virtual Ring View

A virtual ring is a defined combination of RSRB routers, the connections between them, and the real Token Rings attached to the routers. There are three ways to display the virtual ring view. You can display the virtual ring view from the popup menu or from the View menu, with or without the virtual ring selected.

Displaying the Virtual Ring View from a Popup Menu

To display the virtual ring view from a popup menu, use the following procedure:

Step 1 Locate a virtual ring (virtual rings are round) in the main window.

Step 2 Click the ring with the right mouse button.

Step 3 From the popup menu, select Virtual Ring View.

Displaying the Virtual Ring View from the View Menu

To display the virtual ring view from the View menu, use the following procedure:

Step 1 Select View>Virtual Ring. The Virtual Ring Prompt window is displayed.

Step 2 In the Virtual Ring Prompt window, enter the virtual ring's number.

Step 3 Click OK.

Displaying the Virtual Ring View from the View Menu with the Virtual Ring Selected

You can also display the virtual ring view from the View menu using the following procedure:

Step 1 Locate the virtual ring in the main window.

Step 2 Click the ring with the left mouse button.

Step 3 Select View>Virtual Ring. The Virtual Ring Prompt window is displayed.

Step 4 In the Virtual Ring Prompt window, click OK.

Displaying Token Ring Information

You can display information about each Token Ring in the network. The ring information includes the following items:

Bridge number
Ring type
MAC address of the router interface to the Token Ring
Local Token Ring indicator
Interface index
Number of packets transmitted

Before you display the ring information, you must display the focus view for the router to which the Token Ring is attached. To display the ring information, use the following procedure:

Step 1 In the main window, locate the router to which the Token Ring is attached.

Step 2 Click the router with the right mouse button.

Step 3 From the popup menu, select Focus View. The focus view is displayed.

Step 4 From the focus view, select the ring.

Step 5 Click the right mouse button.

Step 6 From the popup menu, select Ring Info. The Ring Information window is displayed.

Viewing Dependent PUs and LUs

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 them. 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.

Note PUs connecting to the mainframe using the RSRB protocol and a CIP or 3172 connection to the mainframe will not benefit from the correlation feature of Maps. Consequently, Maps will not be able to determine which routers these PUs are dependent on for connectivity to the mainframe.

If you know the PU or LU name, and you want a quick path to the dependency view, you can select PU or LU from the View menu. This method is explained in the section "Viewing PUs and LUs from the View Menu."
Select PU or LU from the Tools menu and use the Filter window to select a PU or LU to view; you need not remember the PU or LU name. This method, which is explained in the sections "Viewing PUs from the Tools Menu" and "Viewing LUs from the Tools Menu," lets you display dependency views, as well as activate and deactivate the LUs and PU.
If you do not know the PU or LU name, and want to display just the PUs that depend on a specific Token Ring, you can display all the PUs on a ring. This method is explained in the section "Viewing PUs from the Map Ring Icons."

Viewing PUs and LUs from the View Menu

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 an LU or a PU from the View menu, use the following procedures:

Step 1 From the RSRB 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 5-3.

Figure 5-3: PU/LU Prompt Window

Step 3 In 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.

Viewing PUs from the Tools Menu

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 Maps application's menu bar, select Tools>PU to display the PU Filter window, as shown in Figure 5-4.

Figure 5-4: PU Filter Window

Filtering the PU List

The PU Filter window (Figure 5-4) lets you configure a filter that is used to select the PUs to display in a PU List window. Select PUs the following ways:

By VTAM Info to configure the filter to select PUs based on VTAM criteria.
By Dependency to configure the filter based on the routers on which the PUs are dependent.
Get All PUs to get all discovered PUs.

The PU List window is displayed, showing all the PUs filtered as you requested. The PU List window is described in the section "Using the PU List Window."

Filtering PUs by VTAM Information

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 Information.

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:

Use NAME.DOMAIN to search for a specific PU in a specific domain.
Use NAME.* or NAME to get a list of PUs with the same name in all domains.
Use NAM* to get a list of PU names that start with the same characters (NAM, in this case) in all domains.

Step 3 In the PU State field, select one or more PU states. The PU 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 window will contain PUs whose type matches one of the PU types that you select.

Step 5 Click Apply.

Filtering PUs by Dependency

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 or Token Rings.

Getting all PUs

You can select Get All PUs to display a PU List that contains all PUs discovered by SNA View.

Viewing PUs from the Map Ring Icons

You can view the list of all PUs that depend on a specific Token Ring in your network. You must know which Token Ring supports the PU, and you must first display the focus view for the router to which that Token Ring is attached. Then you can use the Token Ring's popup menu to display a PU List window. To display the PU List window from a Token Ring, use the following procedure:

Step 1 In the global view, select the router to which the Token Ring is attached.

Step 2 Click the router with the right mouse button.

Step 3 From the popup menu, select Focus View.

Step 4 In the focus view, select the Token Ring (an oval) whose PUs you want to view.

Step 5 Click the right mouse button.

Step 6 From the Token Ring's popup menu, select PU List. The PU List window is displayed as described in the section "Using the PU List Window."

Using the PU List Window

This section describes how to use the functions of the PU List window, shown in
Figure 5-5. The PU List window shows a list of all the PU names that satisfy a set of PU filter criteria.

The PU List window is static; select View>Refresh to update the status.

Note Some nodes may appear in the PU list with an unknown type and status. This happens when VTAM returns the IST453I message in response to the D NET,ID command for a node. Message IST453I indicates that the node is unknown to VTAM, and can occur when a major node is inactivated or when a node is activated, but VTAM is not ready to return information for the node when Maps queries it. This situation should not occur for switched PUs, unless the switched PU major node is inactivated.

Figure 5-5: PU List Window

From the PU List window, you can perform the following tasks:

Activate a PU, as described in the section "Activating a PU."
Deactivate a PU, as described in the section "Deactivating a PU."
List the LUs dependent on a PU, as described in the section "List the LUs Dependent on a PU."
Display a dependency view from a PU to the VTAM host, as described in the section "Displaying a Dependency View for an LU."
Choose another set of PUs to display in a PU List window, as described in the section "Choosing Another PU Set."
Update the current filter information by selecting View>Refresh.

Activating a PU

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.

Note Before you activate a PU, you must enable PU activation. An SPO subtask must be running in the mainframe, as described in the CiscoWorks Blue Maps and SNA View Workstation Installation Guide. Notify your network administrator. After you enable PU and LU activation, select a PU or LU to activate the menu. Otherwise it remains inactive.

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:

Default activates the PU as if you had issued the VTAM VARY NET,ACT,SCOPE=COMP,ID=PU_name.
All activates the PU and its LUs regardless of the ISTATUS value, which is the status with which the PU was configured through VTAM.
Only activates the selected PU but no LUs regardless of their ISTATUS values, the status with which the LU was configured through VTAM.

Deactivating a PU

You can deactivate an active PU from the PU List window. This action is comparable to issuing the VTAM command VARY NET,INACT,ID=PU_name. To activate 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:

Quiesce deactivates the PU and any subordinate resources when all current sessions are terminated.
Immediate deactivates the PU and any subordinate resources immediately, disrupting active sessions.
Forced deactivates the PU forcibly; this action is recommended for PUs that do not respond to other deactivation methods.

List the LUs Dependent on a PU

From the PU List window, display a list of LUs attached to a PU using 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.

Displaying a Dependency View for a PU

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 5-6.

Step 3 The PU dependency view is static. Select View>Refresh to update the status.

Figure 5-6: PU Dependency View

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 5-6 includes the following network components, from the top down:

Host network connection
Ring between the peer router and the host network connection
First peer router
Virtual ring
Second peer router
Ring between the PU and the peer router
PU (NIMPU2.CPAC)

Choosing Another PU Set

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.

Select By VTAM Info to configure the filter to select PUs based on VTAM criteria.
Select By Dependency to configure the filter based on the routers on which the PUs are dependent.
Select Get All PUs to get all discovered PUs.

Step 3 Click Apply.

Viewing LUs from the Tools Menu

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 Maps application's menu bar, Tools>LU to display the LU Filter window, as shown in Figure 5-7.

Figure 5-7: LU Filter Window

Filtering the LU List

The LU Filter window (Figure 5-7) 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:

By VTAM Info to configure the filter to select LUs based on VTAM criteria.
By Dependency to configure the filter to select LUs based on the routers on which the LUs are dependent.
Get All LUs to get all the discovered LUs.

Filtering LUs by VTAM Information

You can filter the LU List based on the LU name, PU name, or LU state.

Step 1 From the LU Filter window, select By VTAM Information.

Step 2 In the LU Name field, enter all or part of an LU name (and wildcards). The LU List contains LUs with LU names that match the filter criteria:

Use NAME.DOMAIN to search for a specific LU in a specific domain.
Use NAME.* or NAME to get a list of LUs with the same name in all domains.
Use NAM* to get a list of LU names that start with the same characters (NAM, in this case) in all domains.

Step 3 In the LU State field, select one or more LU states. The LU 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 window will contain LUs whose type matches one of the LU types that you select.

Step 5 Click Apply.

Filtering LUs by Dependency

You can filter the LU List based on the router or Token Ring dependency. From the LU Filter window, select By Dependency. Then select one or more routers from the Routers field in the LU Filter window, or select one or more Token Rings from the Token Ring box. The LU List window will contain the LUs dependent on the selected routers or Token Rings.

Getting all LUs

You can select Get All LUs to display an LU List that contains all LUs discovered by SNA View.

Using the LU List Window

This section describes how to use the functions of the LU Filter window, shown in
Figure 5-8. The LU List window shows a list of all the LU names that satisfy the same LU filter criteria.

The LU List window is static; select View>Refresh to update the status.

Figure 5-8: LU List Window

From the LU List window, you can perform the following tasks:

Activate an LU, as described in the section "Activating an LU."
Deactivate an LU, as described in the section "Deactivating an LU."
Display a dependency view from an LU to the VTAM host, as described in the section "Displaying a Dependency View for an LU."
Choose another set of LUs to display in an LU List window, as described in the section "Choosing Another LU Set."
Refresh the current filter information by selecting View>Refresh.

Activating an LU

You can activate an inactive LU from the LU List window. This action is comparable to issuing the VTAM command VARY NET,ACT,ID=LU_name.

Note Before you can activate an LU, enable LU activation. An SPO subtask must be running in the mainframe, as described in the CiscoWorks Blue Maps and SNA View Workstation Installation Guide. Notify your network administrator. After you enable PU and LU activation, select a PU or LU to activate the menu. Otherwise it remains inactive.

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:

Default to activate an LU as if issuing the VTAM command VARY NET,ACT,SCOPE=COMP,ID=LU_name.
All to activate the LU regardless of its ISTATUS value.

Deactivating an LU

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, use the following procedure:

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:

Quiesce deactivates the LU when all current sessions are terminated.
Immediate deactivates the LU immediately, disrupting active sessions.
Forced deactivates the LU forcibly; this action is recommended for LUs that do not respond to other deactivation methods.

Displaying a Dependency View for an LU

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 5-9.

Step 3 Because the LU dependency view is static, select View>Refresh to update the status.

Figure 5-9: LU Dependency View

The LU dependency view shows the network components from the LU, back toward the mainframe to the host network connection. The LU dependency view shown in Figure 5-9 includes the following network components, from the top down:

Host-connected Token Ring
First router
Virtual ring
Second router
Ring between the PU and the second router
PU (NIMPU2.CPAC)
LU (NIM2L1.CPAC)

Choosing Another LU Set

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 one of the following filtering options:

By VTAM Info to configure the filter to select LUs based on VTAM criteria.
By Dependency to configure the filter based on the routers on which the LUs are dependent.
Get All LUs to see all discovered LUs.

Step 3 Click Apply.

Interpreting Colors and Symbols on a Map

The colors and symbols on an RSRB map have the following meanings:

Green---Device or link is up and running
Red---Device or link is down
Yellow---Device or link performance is degraded or pending
Black---Physical link; no status is reported
Blue---Status of device or link is unknown
Solid line---Physical link
Dashed line---Logical link

RSRB Icons

Table 5-2 shows the icons that can appear on an RSRB map.

**Table 5-2: RSRB Icons**
Icon	Description
	Virtual ring
	Token Ring
	Unknown ring
	Pseudo-ring
	Peer router managed by CiscoWorks Blue Maps
	Focus router in a focus view
	Peer router not managed by CiscoWorks Blue Maps
	PU in a dependency view
	LU in a dependency view
	Physical connection
	Logical connection

Table of Contents

Using the RSRB Application

Filtering PUs by Dependency

Getting all PUs

Filtering LUs by VTAM Information

Filtering LUs by Dependency

Getting all LUs