Using the Web Browser

CiscoWorks Blue Maps includes an interface that you can use to display network map information from a web browser such as the Netscape Navigator or Microsoft Internet Explorer. This interface provides, in tabular format, functions similar to those provided by the standard Motif interface. Access Maps information from any web browser on any workstation platform, such as a PC running Microsoft Windows, or a UNIX workstation.

The Maps and SNA View web pages are described in the following topics:

Accessing Maps with a Web Browser

This topic describes how to access the CiscoWorks Blue Maps web interface with a web browser.

Note After the CiscoWorks Blue web server is started, there may be a brief initialization period before web browsers can successfully access the web server.

Preparing to Start the Web Browser

To use your web browser with the CiscoWorks Blue web page, configure your web browser as follows:

Enable Java Script for your web browser.
If you want the web browser to remember settings from the Maps and SNA View pages, configure your web browser to accept cookies.
Set your web browser's cache to a minimum of 4 MB (4069 KB).

Accessing the CiscoWorks Blue Server

To access the CiscoWorks Blue Maps web server, use the following URL:

http://workstation[:port_number]

Where:

workstation is the IP address or host name of the workstation on which you installed CiscoWorks Blue Maps.

port_number is the CiscoWorks Blue web server port. The default is port 80. However, if port 80 is already in use, the CiscoWorks Blue web server uses backup port 8080. If the server is using port 80, you can omit this option. If the server is using another port, for example port 8080, you must specify it with this option. For example, if you installed Maps on a workstation with the address wwwblue.company.com, using port 8080, you would set your browser to the following URL:

http://wwwblue.company.com:8080

Using the Maps Web Browser from the Maps Motif Tools Menu

Start a a web browser from the Maps Tools menu. To start the Maps web browser, select Tools>Web Browser from the Maps application menu bar.

If you have problems, review the /opt/CSCOcb/etc/runweb script to ensure that the setting of environment variables, the name of the web browser, and the path to the web browser match the directory structure on your workstation. You can modify the
/opt/CSCOcb/etc/runweb file with any editor, such as vi:

vi /opt/CSCOcb/etc/runweb

Creating Bookmarks

You can create a bookmark for any of the CiscoWorks Blue web pages, such as the SNA View page, the APPN page, or the DLSw page. In Netscape, when you are at a page you want to mark, select Bookmarks>Add Bookmark.

Using the CiscoWorks Blue Home Page

When the web browser finds the CiscoWorks Blue URL, it displays the CiscoWorks Blue home page (Figure 2-1).

Figure 2-1: CiscoWorks Blue Home Page

Using the Links on the Home Page

Use the links on the Maps home page to start one of the Maps or SNA View applications.

Note Depending on whether you have licensed Maps or SNA View, the appropriate icons are active. For any program you have not licensed, its icons are inactive.

SNA View displays the SNA Resource Information page, with which you can display and manage the PUs and LUs, as described in "Using the SNA Resource Information Page." The SNA View web page requires a license for CiscoWorks Blue SNA View.
APPN displays the APPN page, with which you can view APPN network and local topology, as described in "Displaying APPN Networks on the Web." The APPN web page requires a license for CiscoWorks Blue Maps.
DLSw displays the DLSw page, with which you can view the DLSw network devices, as described in "Displaying DLSw Networks on the Web." The DLSw web page requires a license for CiscoWorks Blue Maps.
RSRB displays the RSRB page, with which you can view the RSRB network devices, as described in "Displaying RSRB Networks on the Web." The RSRB web page requires a license for CiscoWorks Blue Maps.

Using the Menu Bar

The menu bar provides links to the Maps applications:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
APPN displays the APPN page, with which you can view APPN network and local topology, as described in "Displaying APPN Networks on the Web." This selection requires a Maps license.
DLSw displays the DLSw page, with which you can view the DLSw network devices, as described in "Displaying DLSw Networks on the Web." This selection requires a Maps license.
RSRB displays the RSRB page, with which you can view the RSRB network devices, as described in "Displaying RSRB Networks on the Web." This selection requires a Maps license.
SNA View displays the SNA Resource Information page, with which you can display and manage the PUs and LUs, as described in "Using the SNA Resource Information Page." This selection requires a SNA View license.
Utilities displays the Utilities page, which lets you verify your installation and log into NetView, as described in "Using the Utilities Page."
Options displays the Options page, as described in "Using the Options Page."
Help displays the online help.

Web Browser Conventions

This topic presents some conventions that apply to all Maps and SNA View web pages.

Changing the Size of Dialogs

When you resize a dialog for a Maps or SNA View web page, the browser remembers the size for the next time you display that dialog. For example, if the Options dialog is too small, just drag it to a more convenient size. The browser remembers the setting the next time you display that dialog.

Using the Save, Reset, and Clear Buttons on Each Page

You can use the following buttons at the bottom of most Maps web pages. (Cookies must be enabled for these to work correctly.)

Save saves the settings of the current web page as default settings for that page. When you next visit that page, or select Reset, your default settings are displayed.
Reset resets fields of the current web page to their default settings.
Clear clears all selections and entries on the current web page but does not change the default settings.

Using Hypertext Links

The hypertext links on Maps pages help you find your way through the network information. Configure your web browser to underscore hypertext links so you will more easily see them. Because many of the hypertext links are unique to the specific protocol-based applications, they are described in the remaining topics. The following two hypertext link types are common to all the applications:

Click an IP address to display a view for the device with that IP address.
Click a host name to display a view for the device with that host name.

Reloading Static Pages

All pages displayed by the web interface are static pages. They are not updated dynamically. To update the information on a web page, do one of the following:

Click the Reload button on your web browser.
Click Reload at the bottom of most Maps and SNA View web pages.

When you click Reload, the web server collects its data from the database or from the network devices, depending on which web page you are displaying. For example, when you click Reload on the DLSw Peer Statistics page, the web server collects data from the network topology agent in the network.

Entering Values into Web Pages

This topic explains some conventions for entering values such as IP addresses, node names, and MAC and SAP addresses.

You can enter wildcard values in the web fields. The wildcard values are the asterisk (*) and the question mark (?). The * replaces any number of consecutive characters. The wildcard value ? replaces one character.
In fields that expect a device name or
TCP/IP address:
- Enter any character except a space
- Enter up to 100 characters (the maximum length)
- All characters are valid. For example, if you have a device named cwb*c4, queries using that name will also match cwb-c4 because the * is a wildcard character
- TN3270 supports wildcard addresses.
In fields that expect a
ring number:
- Enter only digits
- Enter no more than 4 characters (maximum length)
In fields that expect an IDBLK/IDNUM (
XID):
- Enter exactly 8 hexadecimal characters plus an optional 0X and separator character A valid XID is either 8 or 10 characters long
- Use as a separator any non-alphanumeric character (perhaps a slash or comma).
- Both 0x12345678 and 12345678 are valid
- 123/45678 and 123-45678 are valid
- 0X123,45678 is valid
- 0x1234.56 is invalid
In fields that expect a
port number:
- Enter only digits
- Port number must be in the range 0 through 65535
In fields that expect a MAC address:
- The MAC address must be exactly 12 hexadecimal characters. For example, 123456789012, 1234.5678.1234, 0xabcdefABCDEF, and 0xabcdef.abcdef are valid. The addresses 0x123456 and 123456 are invalid.
In fields that expect a
SAP Address:
- Optionally, begin the value with 0x or 0X.
- All remaining characters must be hexadecimal.
- The SAP must contain exactly 2 hexadecimal characters. For example, 04 and 0X04 are valid, but 041 is invalid.
In fields that expect an
SNA Name:
- Enter alphanumeric characters, a single period, and the following special characters ($,#,@).
- Enter no more than one period.
- Do not start or end the name with a period.
- Do not exceed 8 characters to the left or right of a period.
- Do not exceed 8 consecutive alphanumeric or special characters.
- Do not exceed 17 characters in the entire name (using 8.8 format).
- Enter uppercase or lowercase characters, although lowercase characters are forced to upper-case internally.
- If you use wildcards, names can contain more than one wildcard. For example, the following are valid: AAAA*BBB.CCCCDDDD, AAAABBBB*CCCC*DDD, *.*, NETA.*, and *.DOMAIN.

Using the SNA Resource Information Page

Note You must have a license for CiscoWorks Blue SNA View to view the SNA Resource Information page. Ask your Network Administrator for details.

The SNA Resource Information page displays SNA resources (PUs and LUs) and sessions in the network using the SNA Resource Information page from a web browser. It contains the following topics:

The intent of SNA View is to show you a picture of a network session connectivity path from a PU or LU, back through the SNA or TCP/IP network to an SNA mainframe computer. It asks you to enter as much information as you know about an end user device, then searches a database to find all the sessions that match your criteria. From this list you can select a single session to display. SNA View then displays the path for that session.

Select SNA View from the CiscoWorks Blue home page to display one or more SNA sessions based on a set of search criteria. The SNA Resource Information page is displayed. Enter your search criteria on the SNA Resource Information page, then click go. Enter as much information as you can to identify an SNA resource. The more information you enter, the more focused the resulting list of sessions will be. You may even be able to identify a single session.

If your search does uniquely identify a session, you will then see the network path taken by that session from the end user device to the SNA mainframe computer.

If your search results in more than one session, you will see a listof those sessions in the SNA Filter Results Page. Scroll through the session list to find the one session you want. Click Session Path to see the network path taken by that session from the end user device to the SNA mainframe computer.

The Session Connectivity Display Page displays a picture of the network showing your selected session from the end user device to the SNA mainframe. Each device in the path has its own network icon. When there are IP devices in the network path, click Pathtool to see the hops between pairs of routers.

SNA Resource Information Page

On the SNA Resource Information page (Figure 2-2), you provide as much information as you can to identify an SNA resource. For example, when a network user calls in with an outage, you can get such information as the MAC address, the LU name, or the PU name. For example, from a computer running Windows 95 the user can enter the winipcfg command to display the current IP address. The web server displays either a unique SNA resource, when you provide enough information, or a list of SNA resources with similar characteristics.

Figure 2-2: SNA Resource Information Page

Use one of the following search methods:

Use the Basic Search tab to display a list of SNA resources based on some simple criteria, such as a PU or LU name, or LAN or TCP/IP address information.
Use the Advanced Search tab to display a list of SNA resources based on more complex criteria, such as the status of a resource, its router dependency and APPN information.

The result of either search can be the single session that matches the criteria, or a list of sessions that match the criteria.

Using the SNA Basic Search Tab

The Basic Search tab is intended for network operators to be able to display network information commonly provided by an end user.

Step 1 In the Specify SNA Information field, enter the following values:

In the Name field enter an LU name, PU name, CP name, or IDBLK/IDNUM pair that identifies one or more SNA resources. You can use wildcards in this field, except with IDBLK/IDNUM. Use one of the following name formats:
- CWB*.DOMAIN1 displays all resources in the DOMAIN1 domain whose names begin with the characters CWB.
- CWB* or CWB*.* displays all resources in all domains whose names begin with the characters CWB.
- CWBC6 or CWBC6.* displays all resources named CWBC6 in all domains.
In the Name Type field select whether the name is an LU name, a PU name, a CP name, or an IDBLK/IDNUM pair.

If you enter nothing in this field, you must enter a value in one of the other fields on this tab in order to get a list of resources.

Step 2 In the Specify LAN Information field, identify an SNA resource by its MAC and SAP address.

In the MAC Address field enter the MAC address of the SNA resource.
In the SAP Address field enter the SAP address of the SNA resource. If you enter a SAP, you must also enter a MAC.

If you enter nothing in this field, you must enter a value in one of the other fields on this tab in order to get a list of resources.

Step 3 In the Specify TCP/IP Information field, you identify one or more SNA resources by their TCP/IP attributes. For example, from a computer running Windows 95 the user can enter the winipcfg command to display the current IP address.

In the TN3270 Client Host Name field enter the internet address or host name associated with the SNA resource.
- Use an asterisk (*) in place of any number of valid characters. For example, C*.CISCO.COM displays all resources whose host names begin with the character C and are in the CISCO.COM domain.
- Use a question mark (?) in place of any single valid character. For example, CWBC?.CISCO.COM displays all resources whose host names begin with the characters CWBC, and are in the CISCO.COM domain.
In the Port field enter the port number. (If you enter a port number, you must also enter an internet address in the Client TCP/IP Name or Address field.)

If you enter nothing in this field, you must enter a value in one of the other fields on this tab in order to get a list of resources.

Step 4 Optionally select Show only exact matches to display only those sessions that exactly match your criteria. If you deselect this field, you will see a list of sessions that match any of your criteria.

Deselect Show only exact matches when you are not certain of identifying a specific session. You can then scan the displayed sessions to find the one you want.
Select Show only exact matches when you are certain of your session identification and want to narrow the search.

Step 5 In the Max Sessions field enter the maximum number of sessions that you want displayed on the Filter Results page. If you do not enter a value, a maximum of 100 sessions will be displayed.

Step 6 Click go.

The SNA Filter Results Page is displayed.

Using the SNA Advanced Search Tab

Use the Advanced Search page to display a list of sessions based on their naming convention, PU or LU status, protocol, router dependency, or APPN attributes.

Step 1 In the Specify Basic Search Information field, enter the following values:

In the PU Name field enter the PU name of the SNA resource.
In the LU Name field enter the LU name of the SNA resource.
In the MAC Address/SAP Address field enter the MAC and SAP of the SNA resource.
In the CP Name field enter the CP name of the SNA resource.
In the IDNUM/IDBLK field enter the IDNUM/IDBLK values for the SNA resource.
In the Client IP Name or Address/Port field enter the client host name or IP address and port number of the SNA resource.

Use wildcard characters in the PU Name, LU Name, CP Name, and Client IP Name or Address fields.

Use an asterisk (*) in place of any number of valid characters. For example, C*.CISCO.COM displays all resources whose host names begin with the character C and are in the CISCO.COM domain.
Use a question mark (?) in place of any single valid character. For example, CWBC?.CISCO.COM displays all resources whose host names begin with the characters CWBC and are in the CISCO.COM domain.

Step 2 In the Specify PU Status field, specify one of the following values:

Inactive returns PUs whose VTAM status is INACT.
Active returns PUs whose VTAM status is ACTIV.
Connectable returns PUs whose VTAM status is CONCT.
Pending returns PUs whose VTAM status is a PENDING status.
Never active returns PUs whose VTAM status is NEVAC.
Other returns PUs with some other VTAM status.
Unknown returns PUs with no reported status.

Note

Ctrl

If you select all states or no states, state filtering is bypassed and PUs in any state are displayed.

Step 3 In the Specify Session Protocols field, select one of the following protocols:

DLSw displays sessions associated with DLSw routers.
RSRB/SRB displays sessions associated with RSRB or SRB routers.
APPN displays sessions associated with APPN routers.
TN3270 displays connections to TN3270 service.
Other displays sessions running standard SNA or other protocols.

Note

Step 4 In the Specify Router Dependencies field, either enter the IP addresses or host names of one or more routers (separated by commas) on which the SNA resource depends. Use the Browse button to select a router from the displayed list of routers that match the protocols selected in Step 3 above. Use wildcard characters in Router Dependency field.

Use this option to see which sessions depend on a router and would be affected by a router problem.

Step 5 In the Specify APPN Criteria field, specify the following values:

In the DLUR name field enter the DLUR name.
In the DLUS field enter the DLUS name.

Step 6 Optionally select Show only exact matches to display only sessions that exactly match your criteria.

Step 7 In the "Max Sessions" field enter the maximum number of sessions you want displayed on the Filter Results page. If you do not enter a value, a maximum of 100 sessions will be displayed.

Step 8 Click go.

The SNA Filter Results Page is displayed.

SNA Filter Results Pa ge

The SNA Filter Results page displays all the SNA sessions that matched the criteria that you entered in the Basic or Advanced search on the SNA Resource Information Page. The SNA Filter Results page displays information in the following areas:

The menu bar lets you select from the options, as described in "Filter Results Menu Bar."
The Filter Criteria table displays a summary of the filter criteria that you entered on the SNA Resource Information Page.
The Summary table displays a summary of the state of all sessions selected by your search criteria, and is described in "Summary Table."
Depending on whether you select Show only exact matches, the Sessions tables display detailed information about any sessions that exactly match your search criteria, and all sessions that match some of your search criteria. The Sessions table is described in "Sessions Tables."

Filter Results Menu Bar

The menu bar on the Filter Results page provides links to other applications:

Home displays the Maps home page, as described in the topic "Using the CiscoWorks Blue Home Page."
SNA View displays the SNA Resource Information page.
NetView displays the NetView for OS/390 web page, which lets you issue NetView commands.

: The NetView item appears on the menu bar only after you have successfully configured the NetView web interface from the Options item on the menu bar of the SNA Resource Information page. If you have configured more than one NetView web URL on the Options page, the NetView item on the menu bar displays a list of URLs from which you select the URL you want to use.

Help displays the online help.

Summary Table

The Summary table displays a summary of the state of all sessions selected by your search criteria.

Fields

The Summary table contains the following fields:


Field	Description
PU/LU States	Inactive---Total number of sessions whose VTAM status is INACT. Active---Total number of sessions whose VTAM status is ACTIV. Connectable---Total number of sessions whose VTAM status is CONCT. Pending---Total number of sessions whose VTAM status is a PENDING status. Never active---Total number of sessions whose VTAM status is NEVAC. Other---Total number of sessions with some other status. Unknown---Displays the total number of sessions with no reported status. Pending Active---Total number of sessions whose status is pending active. Pending Inactive---Total number of sessions whose status is pending inactive.
Total # of sessions	Number of sessions in this connection state that meet the criteria that you specified.

Sessions Tables

The Sessions table displays details of all sessions selected by your search criteria. There can be one or two Sessions tables:

The Sessions (Exact match) table displays those sessions that exactly match your search criteria. The sessions are ordered, alphabetically, by PU Name.
The Sessions table shows those sessions that match only some of your search criteria. The sessions are grouped according to the number of search criteria they satisfy. For example, all sessions that match three criteria are grouped together, just above all the sessions that satisfy two criteria.

Note Not all fields are displayed in every Sessions table. You will see only those fields that apply to the sessions in the table.

Fields

The Sessions tables might contain the following fields:


Field	Description
Session Path	Click Session Path to see a Session Connectivity view for the session, as described in "Session Connectivity Display Page."
LU Name.Domain	LU name and domain name for each session that meets your criteria.
PU Name.Domain	PU name and domain name for each session that meets your criteria.
State	Shows the state of each session: Active---VTAM status is ACTIV. Inactive---VTAM status is INACT. Connectable---VTAM status is CONCT. Pending---VTAM status is one of the pending statuses. Never active--- VTAM status is NEVAC. Other---Session has some other status; often used for a session, such as a DLSw circuit, that could not be correlated to a PU. Unknown---No reported status. Pending Active --- Status is pending active. Pending Inactive --- Status is pending inactive.
Client IP	IP address of the client PU.
Client MAC/SAP¹	MAC and SAP addresses of the PU.
Destination MAC/SAP²	MAC and SAP addresses of the host network connection.
XID	Exchange identification.
CPNAME	CPNAME of the PU.
DLUR Name	APPN control point name of the device that provides the DLUR services to the LU.
DLUS Name	APPN control point name of the VTAM host.
TN3270	Name of the TN3270 server for this PU session (for TN3270 sessions only).

¹If no sessions on this page have PUs, this field is labelled MAC1/SAP1. If some sessions on this page do not have PUs, this field is labelled MAC1/SAP1 (Client).
²If no sessions on this page have PUs, this field is labelled MAC2/SAP2. If some sessions on this page do not have PUs, this field is labelled MAC2/SAP2 (Destination).

Session Connectivity Display Page

The Session Connectivity Display page shows the path that a session takes from an end user device back to the SNA mainframe computer. The Session Connectivity view (Figure 2-3) is displayed when you do one of the following:

Enter the search criteria on the Basic tab or Advanced tab of the SNA Resource Information Page that results in only one session.
Click Session Path in any row in the Session table on the SNA Filter Results Page.

Figure 2-3: Session Connectivity Page

The Session Connectivity page shows you the paths of one SNA session:

The end-user device appears at the bottom of the page.
The SNA mainframe computer appears at the top of the page if VTAM is being monitored.
Between the end-user device and the SNA mainframe are devices in the session path between the end user device and the SNA mainframe. Most of the icons on this view are selectable.
- If you select a router, the CW2000 and CiscoView menu items are activated on the menu bar. CiscoView is launched as a Motif application. You can launch these applications by selecting their menu items. If you are using the CiscoWorks Blue web page from a remote workstation, you must be running an X-Windows server to view the display.
- If you select an SNA device, the NetView menu item is activated on the menu bar.

Next to each device on the page, the following information is provided:

SNA or TCP/IP name of the device
Status of that device
Red arrow, indicating the first inactive device in the path
Routing information field for a host connection
Protocols a router is running: DLSw, RSRB, SRB, APPN, or TN3270

There are a variety of links on this page:

Click on the protocol name to see a closer view of that router (requires Maps license):
- DLSw Focus View page for a DLSw router
- RSRB Focus View page for an RSRB router
- APPN Node Details page for an APPN router
- TN3270 Monitor for a TN3270 router
If the word Pathtool appears next to a router name, click Pathtool to start the Pathtool application, which shows the network hops between routers.
For a TN3270 device, there may be a link to TN3270 Monitor. TN3270 Monitor is launched as a Motif application. If you are using the CiscoWorks Blue web page from a remote workstation, you must be running an X-Windows server to view the display.

Session Connectivity Menu Bar

The menu bar on the Session Connectivity Display page provides links to other applications:

Home displays the Maps home page, as described in the topic "Using the CiscoWorks Blue Home Page."
SNA View displays the SNA Resource Information page.
NetView displays the NetView for OS/390 web page and performs a DIS on the selected device.

: The NetView item appears on the menu bar only after you have successfully configured the NetView web interface from the Options item on the menu bar of the SNA Resource Information page. If you have configured more than one NetView web URL on the Options page, the NetView item on the menu bar displays a list of URLs from which you can select the URL you want to use.

CiscoView launches CiscoView for the selected device. CiscoView is launched as a Motif application: if you are using the CiscoWorks Blue web page from a remote workstation, you must be running an X-Windows server to view the display.
CW2000 launches CiscoWorks 2000 RME Device Center for the selected device.
Help displays the online help.

Pathtool Page

The Pathtool page displays the hops between two selected devices using the same techniques used by the CiscoWorks Path tool. It contains the Pathtool table, which displays information about each hop in the path.

Step 1 In the Session Connectivity Display Page, click Pathtool next to the node for which you want to see the session path.

Step 2 If the Select Routers window is displayed, because there are more than two routers in the Session Connectivity Display, select the two routers for which you want a path.

Step 3 Select whether to include intermediate routers.

Select Compute path through intermediate routers to show the IP path from source to destination, including any intermediate routers.
Deselect Compute path through intermediate routers to show the IP path from source to destination, not including any intermediate routers.

Step 4 Click OK.

The Pathtool page displays the Pathtool table.

Fields

The Pathtool table contains the following fields:


Field	Description
Hop	Number of the hop, starting with the origin node.
Device Name	Device name of the device at this hop.
IP Address	IP address of the device at this hop.
Interface (In)	Identifies the type of network interface into the device for this hop.
Interface (Out)	Identifies the type of network interface out from the device for this hop.

Displaying APPN Networks on the Web

Note You must have a license for CiscoWorks Blue Maps to view the APPN page. Ask your Network Administrator for details. Ask your Network Administrator for details.

This topic describes how to display the APPN page from a web browser and how to view the nodes and transmission groups that make up the APPN network topology. It contains the following topics:

APPN Pa ge

This topic describes how to use the APPN page. From the CiscoWorks Blue home page, click APPN. The APPN page is displayed (Figure 2-4).

Note If the APPN poller is not running when you display the APPN main page, you will receive an error message. Notify your network administrator to use Process Manager to stop the AppnPollerServer process, ensure that cwbsnamapsd dependends on AppnPollerServer, and restart cwbsnamapsd.

Figure 2-4: APPN Page

You can perform the following on the APPN page:

Click Network Topology to display the Network Topology page.
Enter the IP address (host name) and the read community string, or just the CP name, of a network node to display the Node Details page for that node.

Note To display the Network Topology page, you must first have a network topology agent identified in the /opt/CSCOcb/etc/cwbinit file, as described in the CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide.

Click one of the buttons in the Request field to review the following information.

Network Topology displays the Network Topology page, which shows the summary information about the APPN network nodes and transmission groups. Use this selection to display a list of all nodes or all TGs that have the same status. See the "Network Topology Page" for more information.
Node Details displays the APPN Node Details page, which shows information about a specific node and the node's network connections. Use this selection to display detailed information about one node. See the "Node Details Page" for more information

Click go to display the requested page.

Using APPN Hypertext Links

The APPN web pages contain several kinds of hypertext links to help you navigate through the topology information. When you click a hypertext link, APPN displays more information about the item that you clicked. The APPN pages use the following hypertext links:


When you click this...	APPN displays this...
Link Name	Link Properties page
NETID.CPNAME	APPN Node Details page
Port Name	Port Properties page
Node State	List of nodes in that state
TG Number	TG Properties page
Intermediate Session	Intermediate session page, including session route

Network Topology P a ge

This topic explains how to display a summary of all nodes and TGs that have the same status. When you select Network Topology from the APPN page, the Network Topology page displays the summary information about the nodes and transmission groups (TGs). It lists the number of nodes in each node state and the number of TGs in each TG state. The Network Topology page contents are described in the following topics:

When you display the Network Topology page, the box in the upper-right corner displays the name of the topology agent. If no topology agent was found, the box displays the message "No topology agent."

APPN Node Topology Menu Bar

The menu bar provides the following links:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
APPN displays the APPN page, as described in "Displaying APPN Networks on the Web."
Help displays the online help.

Node Summary Table

The Node Summary table displays the number of nodes in each node state.

Fields

The Node Summary table has the following fields:


Field	Description
Node States	Status of each node.
Number of Nodes	Total number of APPN nodes reported by the topology agent in each node state.
Details	Click Details to display the Node table for the selected node state, as described in "Node Details Page."

TG Summary Table

The TG Summary table displays the number of TGs in each TG state.

Fields

The TG Summary table has the following fields:


Field	Description
TG States	Status of each transmission group.
Number of TGs	Total number of APPN transmission groups (TGs) reported by the topology agent in each state.
Details	Click Details to display the detailed table for the selected TG state, as described in "TG Properties Page."

Node List Page

The Node List page includes a list of all nodes that have the same state. For each node state present in the network (unknown, degraded, active, and virtual routing nodes) there is a Node page that shows all the nodes in the specified state. There are up to four node pages, one for each possible node state:

Unknown Node page---A node is unknown when the node state cannot be determined because the node is not managed and there is either no network topology agent or no active CP-CP session path from the network topology agent to the node.
Degraded Node page---Degraded nodes are in the quiescing or congested state. A node has a degraded state if DLUR is configured but there is no DLUS session, or the node is reporting congested traffic.
Active Node page---Active nodes are enabled for APPN and are either being managed directly, or have an active CP-CP session path to the network topology agent.
Virtual Routing Node page---A virtual routing node is a representation of a set of node's connectivity to a connection network, such as a Token Ring, displayed as a single node.

When you display a Node List page, the box in the upper-right corner displays the name of the topology agent. Each Node List page contains a menu bar and a Node table.

Node List Page Menu Bar

The menu bar on each Node List page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
APPN displays the APPN page, as described in "Displaying APPN Networks on the Web."
Unknown displays the Unknown Node page.
Degraded displays the Degraded Node page.
Active displays the Active Node page.
Virtual displays the Virtual Router Node page.
Summary displays the APPN Global View Summary page.
Help displays the online help.

Node Table

The Node table lists all the nodes with the same state.

Fields

The Node table has the following fields:


Field	Description
Node Name	Name of the selected node. Click the node name to display the Node Details page, as described in the "Node Details Page."
TG Number	TG number for each TG on the selected node. Click the TG number to display the TG Information page, as described in the "TG Properties Page."
Destination Node	Name of the destination node that is connected to the selected node by this TG. Click the node name to display the Node Details page, as described in the "Node Details Page."
CP-CP Sessions	Indicates whether there are CP-CP sessions on the selected connection.

TG List Page

The TG List page contains a list of all TGs that have the same status. For each TG state present in the network there is a TG page that shows all the TGs in the specified state. There can be up to three TG pages, one for each possible state:

Unknown TG page---TG state cannot be determined because the node that owns the TG is not managed, and there is either no network topology agent or no active CP-CP session path from the network topology agent to the node that owns the TG.
Active TG page---TG is available for APPN sessions, as reported by either the node that owns the TG or the network topology agent.
Inactive TG---TG is not available for APPN sessions, as reported by either the node that owns the TG or the network topology agent.

When you display a TG List page, the box in the upper-right corner displays the name of the topology agent.

TG Table Menu Bar

The menu bar on each TG page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
APPN displays the APPN page, as described in "Displaying APPN Networks on the Web."
Unknown displays the Unknown TG page.
Active displays the Active TG page.
Inactive displays the Inactive TG page.
Summary displays the APPN Global View Summary page.
Help displays the online help.

TG Table

For each TG state present in the network, the summary page shows a table that displays the source node and destination node for each TG in a TG state. There are up to three TG tables, one for each possible TG state:

Unknown
Active
Inactive

Fields

The TG table has the following fields:


Field	Description
Node Name	Name of the selected node. Click the node name to display the Node Details page, as described in the "Node Details Page."
TG Number	TG number for each TG on the selected node. Click the TG number to display the TG Information page, as described in the "TG Properties Page."
Destination Node	Name of the destination node that is connected to the selected node by this TG. Click the node name to display the Node Details page, as described in the "Node Details Page."
CP-CP Sessions	Indicates whether there are CP-CP sessions on the selected connection.

Node D etails Pag e

You can display detailed information about one specific node. When you select Topology Agent Details from the APPN page, or when you click a node or device name or IP address from any APPN web page, the APPN Node Details page displays information about the selected node in a series of tables described in the following topics:

Menu Bar

The menu bar provides links to the following applications:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
APPN displays the APPN page, with which you can view APPN network and local topology, as described in "Displaying APPN Networks on the Web."
Telnet starts a Telnet client to connect to the selected router. Enter the password to complete the connection.
HTTP establishes an HTTP connection with the router.
Help displays the online help.

General Table

The General table identifies the selected APPN node.

Fields

The General table has the following fields:


Field	Description
SNMP Device Name	Name of the device.
CP Name	CP name in the format network_ID.CP_name.
APPN Node State	Status of the node.
Node Type	Type of the node.

IP Addresses Table

The IP Addresses table displays all the IP addresses and their subnet masks configured for the node.

Fields

The IP Addresses table has the following fields:


Field	Description
IP Address	All IP addresses configured for the node.
Net Mask	Subnet mask for each IP address.
Interface Type	Interface type configured for each IP address.

Ports and Links Table

The Ports and Links table displays all the ports and links configured for the node.

Fields

The Ports and Links table has the following fields:


Field	Description
Link	Link name of each link configured on the node. Click the name to display the Port Properties page, as described in the "Link Properties Page."
Port	Port name of each port configured on the node. Click the name to display the Port Properties page, as described in the "Port Properties Page."
TG Number	TG name of each transmission group configured on the node. Click the number to display the TG Properties page, as described in the "TG Properties Page."
Adjacent Node	Name of the adjacent node. Click the node name to display the Node Details page, as described in the "Node Details Page."

DLUS/DLUR Table

The DLUS/DLUR table displays the DLUS/DLUR information configured for the node. It lists all PUs served by the DLUR function at the selected node, and displays the PU connection state, the name of the DLUS node, and the DLUS-DLUR state for each PU.

Fields

The DLUS/DLUR table has the following fields:


Field	Description
PU Name	Name of each PU served by the DLUR function at the selected node. Click PU Name to link to the SNA Resources Session Connectivity web page for this PU (requires SNA View license).
PU State	Status of each PU.
DLUS Node Name	Name of the DLUS node. Click the node name to display the Node Details page for that node.
DLUR-DLUS State	Status of the DLUS/DLUR control session.

Directory Table

The Directory table lists the directory information for the selected network node, which shows all the local LUs, all the LUs served by attached end nodes and LEN nodes, and all the LUs cached as a result of directory searches.

Fields

The Directory table has the following fields:


Field	Description
LU Name	Name of each LU supported by the selected node.
Owning CP Name	Network name of the owning CP. Click the node name to display the Node Details page, as described in the "Node Details Page."
Serving NN Name	Name of the network node that supports the LU. Click the node name to display the Node Details page, as described in the "Node Details Page."

Intermediate Sessions Table

The Intermediate Sessions table displays all the intermediate sessions that pass through the selected node.

Fields

The Intermediate Sessions table has the following fields:


Field	Description
Primary LU	Name of the primary LU in each session.
Secondary LU	Name of the secondary LU in the session.
Mode Name	Name of the VTAM mode table used by the session.
PCID CP Name	CP name of the node that assigned the Procedure Correlation Identifier (PCID) for the intermediate session.
FQPCID	Unique identifier assigned by the PCID CP name.
Details	Links to the Intermediate Sessions page, as described in the "Intermediate Sessions Page."

TG Properties Page

The TG Properties page contains detailed information about one specific TG. When you select a TG, the TG Properties page displays the TG information as perceived by each node that owns this TG. This information is taken from the topology database and might not reflect actual TG properties if a network outage is preventing this information from being reported to the network topology agent. In this case, the TG connection is displayed in blue on the map to reflect unknown status.

When you display a TG Properties page, the box in the upper-right corner displays the names of the nodes at each end of the TG.

The TG Properties page contains a General table and a Details table.

General Table

The General table displays two columns of information. Each column describes the properties of the TG in the direction from the node in that column to the node in the other column ("N/A" means that the information for that field is unavailable.)

Fields

The General table has the following fields:


Field	Description
CP Name	CP name of device owning the TG.
TG Number	Number that identifies this TG and the two CP names.
Status	Indicates whether this TG is available for inclusion in an APPN route.
CP-CP Sessions	Indicates whether CP-CP sessions are supported in this TG.
Virtual Node	Indicates whether the node that supports this TG is a virtual node.
Quiescing	Indicates whether this TG is in the process of being shut down.

Details Table

The Details table displays two columns of information. Each column describes the properties of the TG in the direction from the node in that column to the node in the other column ("N/A" means that the information for that field is unavailable).

Fields

The Details table has the following fields:


Field	Description
Security Level	Security level of this link; values include Non-Secure, Public Switched Network, Underground Cable, Secure Conduit, Guarded Conduit, Encrypted, and Guarded Radiation.
Propagation Delay	Relative length of time it takes a signal to travel the length of this link; values include minimum, negligible, terrestrial, packet, long, and maximum.
Effective Capacity	Capacity of the TG, in kilobits per second.
Cost/Connect Time	Relative cost per unit of time to use this TG, in the range 0 to 255, where 0 is low cost.
Cost/Byte	Relative cost of transmitting a byte over this link, in the range 0 to 255, where 0 is low cost.
Days Until Deletion	Number of days until this TG is deleted from the network topology agent's database. This value is meaningful only when this TG is not operational.
User-defined 1	User-defined route calculation constraint number 1, in the range 0 to 255.
User-defined 2	User-defined route calculation constraint number 2, in the range 0 to 255.
User-defined 3	User-defined route calculation constraint number 3, in the range 0 to 255.

Port Properties Page

The Port Properties page displays information about a port that is configured on a node. To see port properties, select a port on a Node Details page. The Port Properties page displays information about that port.

Fields

The Port Properties page has the following fields:


Field	Description
Port Name	Name of the port as configured at the owning node.
Status	State of this port; values include Inactive, Pending-Inactive, Active, or Pending-Active), according to the owning node.
Owning CP Name	Network name of the owning node.
Maximum BTU Size	Maximum basic transmission unit size that a link station on this port can receive, in the range 0 to 32767.
Maximum I-Frame Size	Maximum number of I-frames that can be received by the XID sender before an acknowledgment is received.
Port Type	Type of line used by the port (Leased, Switched, or Shared Access Facility).
Link Station Role	Initial role for link stations activated through this port (Primary, Secondary, Negotiable, or Asynchronous Balance Mode).
DLC Type	Data-link control type of the port (SDLC, Ethernet, Token Ring, or Other). Other includes RSRB, DLSw, and Frame Relay.
Local Address (Shown only if DLC=token ring)	Local MAC address used by this port (if the DLC type is Token Ring).
SAP (Shown only if DLC=token ring)	Service access point used by this port (if the DLC type is Token Ring).
SIM/RIM Supported	Indicates whether Set Initialization Mode and Receive Initialization Mode are supported.

Link Properties Page

The Link Properties page displays information about a link that is configured on a node. To see link properties, select a link on a node's focus view. The Link Properties page displays information about that link. The Link Properties page contains the General table and the Details table.

General Table

The General table lists each link station.

Fields

The General table contains the following fields:


Field	Description
Link Name	Name of the link as configured at the owning node.
Status	State of this link station (Inactive, Pending-Inactive, Active, or Pending-Active), according to the owning node.
Owning CP Name	Network name of the owning node.
Destination CP Name	Network name of the destination node.
Port Name	Name of the port under which this link station is defined.
DLC Type	Data-link control type of the port (SDLC, Ethernet, Token Ring, or Other). Other includes RSRB, DLSw, and Frame Relay.
CP-CP Support	Indicates whether CP-CP sessions are supported on this link.

Details Table

The Details table lists detailed information about each link.

Fields

The Details table contains the following fields:


Field	Description
TG Number	Number of the TG associated with this link station.
Max Send BTU Size	Numeric value between 0 and 32767, inclusive, indicating the desired number of bytes in a basic transmission unit that can be sent on this TG.
Dynamic Link	Indicates whether a link definition for this link station was created dynamically as a result of an incoming link activation request.
Limited Resource	Indicates whether this link station will be deactivated when all sessions using it have ended.

Intermediate S essions Page

The Intermediate Sessions page displays information about an intermediate session. To display an intermediate session, select Details from the Intermediate Sessions table of the Node Details page for a router. The Intermediate Sessions page is displayed. The Intermediate Sessions page contains a set of tables of APPN information about a node through which APPN sessions pass. There are three areas on the Intermediate Sessions page:

General table
Details table
Session Route list

General Table

The General Table identifies the nodes and LUs of the intermediate session. The General table contains the following fields:


Field	Description
Intermediate Node Name	Name of the intermediate node; this is the node that was queried.
Session PCID Originator Node Name	Node name for the originating node.
PCID	Procedure correlation ID of the intermediate session, as assigned by the session PCID originator node.
Primary LU Name	Name of the primary LU.
Secondary LU Name	Name of the secondary LU.
Mode Name	Name of the APPN mode.
Class Of Service Name	Class of service name associated with the mode name.
Transmission Priority	Transmission priority of the intermediate session.
Session Up Time	Time this intermediate session has been active.

Details Table

The Details Table provides the detailed information about the intermediate session.

Fields

The Details table contains the following fields:


Field	Description
Adjacent CP Name	CP name for the adjacent network node for primary and secondary side of the session.
Adjacent TG Number	TG number to the adjacent network node for primary and secondary side of the session.
Max BTU Size	Maximum basic transmission unit that can be carried by Send and Receive values for primary and secondary side of the session.
Pacing Type	Type of pacing used (fixed or adaptive) for Send and Receive values for primary and secondary side of the session.
Residual Pacing Count	APPN residual pacing count for Send and Receive values for primary and secondary side of the session.
Next Window Size	Window size, in bytes, of the next pacing window for the session for Send and Receive values for primary and secondary side of the session.

Session Route List

The Session Route list displays the nodes and TGs in the path of the overall APPN session.

Displaying DLSw Networks on the Web

Note You must have a license for CiscoWorks Blue Maps to view the DLSw page. Ask your Network Administrator for details.

This topic describes how to display the DLSw page from a web browser and how to view the routers and rings that make up the DLSw network. It contains the following topics:

Note For the DLSw web page to display current information, the DLSw poller and/or trap daemon must be running. See the CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide for information about starting the DLSw poller and trap daemons.

DLSw Pa ge

This topic describes how to use the DLSw page. To display the DLSw page (Figure 2-5), select DLSw from the CiscoWorks Blue home page.

Figure 2-5: DLSw Page

Click one of the buttons in the Request field and then click go.

Key Devices View displays the Key Devices View page, which shows the DLSw routers defined as key devices. For more information, see "Key Devices Page."
Global View displays the Global View page, which shows the summary and detail views for all DLSw routers. For more information, see "Global View Page."
Focus View for Router displays the Focus View page, which shows DLSw information for a specific DLSw router, including the router's IP addresses and peer routers. Enter the IP address or host name to select the router. For more information, see "Focus View Page."

Note

Rediscover Router updates the Maps database with the latest information for a specific DLSw router. For more information, see "Rediscover Router Page."

Using DLSw Hypertext Links

The DLSw web pages contain several kinds of hypertext links to help you navigate through the network information.

Links

The DLSw pages use the following hypertext links:


When you click this...	DLSw displays
Peer Statistics	Peer statistics for the selected router or peer connection.
Router name or IP address	DLSw Focus view for that router.
Details in a Router or Peer Connection State table	Routers or peer connections in that state.

Key Devi ces Page

This topic tells you how to display a list of routers that are considered key devices in your network. When you select Key Devices View from the DLSw page, the Key Devices View page displays the key routers in the network.

Fields

The Key Devices View page contains the following fields:


Field	Description
Name	Host name of each router identified as a key device. Click a router name or IP address to display a focus view for that router.
Inactive Connections	Number of peer connections with status Inactive.
Degraded Connections	Number of peer connections with status Degraded.
Unknown Connections	Number of peer connections with status Unknown.
Active Connections	Number of peer connections with status Active.

Global View Pa ge

The DLSw Global View page displays a summary of all the DLSw routers and all DLSw connections in your network. When you select Global View from the DLSw page, the DLSw Global View page is displayed. The Global View page contains the following items:

DLSw Global View Menu Bar

The menu bar on the Global View page provides the following links:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
DLSw displays the DLSw page, as described in "Displaying DLSw Networks on the Web."
Help displays the online help.

Router Summary Table

The Router Summary table displays summary views of the DLSw routers.

Fields

The Router Summary area contains the following fields:


Field	Description
Router States	Lists the possible router states.
Number of Routers	Shows the total number of routers in each state.
Details	Click Details to display the list of routers in the selected state. See the "Router Pages" topic for more information.

Connection Summary Table

The Connection Summary table displays summary views of the DLSw peer connections.

Fields

The Connection Summary area contains the following fields:


Field	Description
DLSw Peer States	Lists the possible DLSw peer-router states.
Number of Connections	Shows the total number of peer connections in each state.
Details	Click Details to display the list of connections in the selected state. See the "Connections Pages" topic for more information.

Router Pa ges

Each DLSw Router page displays a list of all DLSw routers that have the same state. There is a DLSw Router page for each router state in the network: Inactive, Degraded, Unknown, and Active. Each router page contains a menu bar and a Router table. The Router table lists all routers in the same state. The possible router pages are as follows:

Inactive Router page---Inactive routers are not responding to SNMP queries.
Degraded Router page---Degraded routers are in the Pending state.
Unknown Router page---Unknown routers are not managed or are not responding to SNMP queries.
Active Router page---Active routers are responding to SNMP queries.

Router Table Menu Bar

The menu bar on each Router page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
DLSw displays the DLSw page, with which you can view the DLSw network devices, as described in "Displaying DLSw Networks on the Web."
Inactive displays the Inactive Router page.
Degraded displays the Degraded Router page.
Unknown displays the Unknown Router page.
Active displays the Active Router page.
Summary displays the DLSw Summary page.
Help displays the online help.

Router Tables

There is a Router page for routers in each router state.

Fields

The fields in a router table apply to all router states. Click any router name or IP address to display DLSw peer information for that router. Each Routers table contains the following fields:


Field	Description
Local Router Name	Lists each local router by name or IP address.
Peer Connection State	Shows the total number of routers in each router state.
Peer Router	Shows the host name of the peer router.
Peer Statistics	Provides a Peer Statistics link to the DLSw Peer Statistics page for the peer router.

Connections Pa ge s

Each DLSw Connection page displays a list of all DLSw connections that have the same state. There is a DLSw Connection page for each connection state in the network: Inactive, Degraded, Unknown, and Active. Each Connection page contains a menu bar and a Connection table. The Connection table lists all connections in the same state. The possible Connection pages are as follows:

Inactive Connection page---For an inactive connection, the peer routers are not exchanging data.
Degraded Connection page---For a degraded connection, the peer routers are in a pending state.
Unknown Connection page---For an unknown connection, the peer routers are not responding to polling.
Active Connection page---For an active connection, the peer routers are exchanging data.

Each Connection page contains a menu bar and a connection table.

Connection Page Menu Bar

The menu bar on each Connection page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
DLSw displays the DLSw page, with which you can view the DLSw network devices, as described in "Displaying DLSw Networks on the Web."
Inactive displays the Inactive Connection page.
Degraded displays the Degraded Connection page.
Unknown displays the Unknown Connection page.
Active displays the Active Connection page.
Summary displays the DLSw Summary page.
Help displays the online help.

Connections Tables

Each Connection page has a Connection table for its state. The possible tables are as follows:

Inactive Connection table
Degraded Connection table
Unknown Connection table
Active Connection table

Fields

The fields apply to all connection states. Click any router name or IP address to display the Focus View table for that router. Each Connections table contains the following fields:


Field	Description
Router #1	For each peer connection, lists the name or IP address of router 1, and shows its state.
Router #2	Lists the name or IP address of router 2, and shows its state.
Peer Statistics	Provides links to the DLSw Peer Statistics page for the peer routers. The arrow indicates the direction. The icon #1-->#2 shows statistics from router 1 to router 2. The icon #2-->#1 shows statistics from router 2 to router 1.

Focus View Page

The DLSw Focus View page displays detailed information about a specific DLSw router. Display the focus view for a router in one of the following ways:

Select Focus View for Router from the DLSw page, type in the device name or IP address of the router, and click go.
Click a router name or the IP address of a router on a DLSw web page.

The Focus View page for a router displays the information described in the following topics:

When you display the Focus View, the box in the upper-right corner displays the name of the router.

Focus View Menu Bar

The menu bar on each Focus View page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
DLSw displays the DLSw home page, as described in "Displaying DLSw Networks on the Web."
Telnet starts a Telnet client so you can log in to the focus router.
HTTP starts a web client so you can browse web pages on the focus router.
Circuits displays a list of circuits for the focus router.
PU displays a list of PU names that are dependent on the focus router (requires SNA View license).
LU displays a list of LU names that are dependent on the focus router (requires SNA View license).
Rediscover rediscovers the focus router; collects current information for the database.
Help displays online help.

Connections Table

The Connections table displays the focus router's peer connections in each connection state.

Fields

The Connections table contains the following fields:


Field	Description
Peer Connection State	State of the selected peer connection.
Peer Router	Device name or IP address of the peer router for the selected peer connection. Click the address or name to display the focus view for that peer router.
Peer Router State	State of the selected peer router.
Peer Statistics	Click Peer Statistics to display the Peer Statistics page for the selected connection.
Attached Rings	List of rings attached to this peer router.

General Table

The General table displays the focus router's peer connections in each connection state.

Fields

The General table contains the following fields:


Field	Description
Device Name	Host name of the focus router.
Status	State of the focus router.
IOS Version String	Cisco IOS release running on the focus router (SNMP collects this information on demand).

Details Table

The Details table displays DLSw protocol and connection information for the focus router, such as the maximum frame size. SNMP collects this information on demand.

Fields

The Details table contains the following fields:


Field	Description
DLSw Version	Version of DLSw used by the router.
Vendor ID	Vendor identification.
Largest Frame Size	Largest frame supported by this router.
Pacing Support	Level of pacing supported by this router.
DLSw Up-Time	Length of time DLSw has been continuously active on this router.
Active Peer Connections	Number of active peer connections to this router.
Busy Connections Closed	Number of busy connection that have been closed on this router.
Circuits Created	Number circuits that have been created with this router.
Active Circuits	Number of currently active circuits.

IP Addresses Table

The IP Addresses table displays all the IP addresses, and their subnet masks, configured for the focus router as stored in the Maps database.

Fields

The IP Addresses table contains the following fields:


Field	Description
IP Address	IP addresses configured at the focus router.
Net Mask	Subnet mask for each IP address.
Interface Type	Interface type configured for each IP address.

Peer Statistics Page

The DLSw Peer Statistics page displays detailed information about one DLSw peer connection. To display the Peer Statistics page, click Peer Statistics in the Global View or Focus View page. The Peer Statistics page contains the information described in the following topics:

When you display the Peer Statistics page, the box in the upper-right corner identifies the peer connection.

Peer Statistics Menu Bar

The menu bar on each Peer Statistics page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
DLSw displays the DLSw home page, as described in "Displaying DLSw Networks on the Web."
Help displays online help.

General Table

The General table displays information about the selected peer connection.

Fields

The General table has the following fields:


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

Details Table

The Details table displays detailed information about the peer router.

Fields

The Details table has the following fields:


Data Packets In	Number of 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 that were not of type DGRMFRAME, DATAFRAME, or INFOFRAME.
Control Packets Out	Number of SSP messages transmitted on this transport connection that were not of type DGRMFRAME, DATAFRAME, or INFOFRAME.
CanUReach Xxpl In	Number of CanUReach_ex messages received on the transport connection.
CanUReach Expl Out	Number of CanUReach_ex messages sent on the transport connection.
ICanReach expl In	Number of ICanReach_ex messages received on the transport connection.
ICanReach Expl Out	Number of ICanReach_ex messages sent on the transport connection.
NETBIOS NQ In	Number of NetBIOS_NQ_ex messages received in the transport connection.
NETBIOS NR Out	Number of NETBIOS_NR_ex messages sent on this transport connection.
NETBIOS NR In	Number of NetBIOS_NQ_ex messages received in the transport connection.
NETBIOS NQ Out	Number of NetBIOS_NQ_ex messages sent on the transport connection.

Circuit Information Page

The DLSw Circuit Information page displays information about one DLSw circuit. From a focus view for a router, you can click Circuits on the menu bar to display information about all circuits on the focus router.

Fields

The Circuit Information page has the following fields:


Field	Description
Resource 1	PUNAME.DOMAIN¹ of SNA resource 1².
MAC1/SAP1	MAC address and SAP address of SNA resource 1.
Resource 2	PUNAME.DOMAIN of SNA resource 2.
MAC2/SAP2	MAC address and SAP address of SNA resource 2.
Status	Status of the circuit.
Details	Click Details to display a detailed DLSw Circuit Information page for the selected circuit.

¹The PU name and domain name are displayed only if SNA correlation was successful. Otherwise, dashes (---) are displayed.
²Resource 1 and Resource 2 refer to the PU and the host network connection, depending on your view of the network. If you are viewing the network from the host end, Resource 1 is the host network connection and Resource 2 is the PU on the circuit. If you are viewing the network from the PU end, Resource 1 is the PU on the circuit and Resource 2 is the host network connection.

Circuit Details Page

The DLSw Circuit Details page displays information about one DLSw circuit. It contains the following tables:

Circuit Information Table

The Circuit Information table displays summary information about a selected circuit.

Fields

The Circuit Information table contains the following fields:


Field	Description
Resource 1	PUNAME.DOMAIN¹ of SNA resource 1².
MAC 1 Address	MAC address of SNA resource 1.
SAP 1 Address	SAP address of SNA resource 1.
Resource 2	PUNAME.DOMAIN of SNA resource 2.
MAC 2 Address	MAC address of SNA resource 2.
SAP 2 Address	SAP address of SNA resource 2.
Status	Status of the circuit.

Circuit Details Table

The Circuit Details table displays detailed information about a selected circuit.

Fields

The Circuit details table contains the following fields:


Field	Description
Router Name	Host names of the local and remote routers.
IP Address	IP addresses of the local and remote routers.
Status	Status of the local and remote routers.
Circuit Identifier	Circuit identifier assigned by this DLSw node to this circuit. The first four octets are the DLC port ID. The second four octets are the data-link correlator.
DLC Type	DLC protocol in use between the DLSw node and the SNA resource. The possible values are QLLC, SDLC, LLC, NA, or Other.
Interface Index	Entry index of the local interface through which the SNA resource can be reached.
Route Information	For source-route bridging between the DLSw node and the SNA resource, the routing information field describing the path between the two devices. Otherwise, the value will be an octet string of zero length.
Transport Domain	Transport domain of the transport connection.
Max Messages Sendable	Number of paced 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.
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.
Send Window Size	Current window size that this DLSw peer 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 "repeat window."
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 "repeat window."
Send Largest Window	Largest Send Largest Window value (with respect to this DLSw router) granted by the partner DLSw router during the current activation of this circuit.
Receive Largest Window	Largest Receive Window Size value 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.
Halve Window Sent	Number of Halve window operations this DLSw 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 Sent	Number of Reset window operations this DLSw router has sent on this circuit in its role as a data receiver.
Reset Window Received	Number of Reset window operations this DLSw router has received on this circuit in its role as a data sender.

Rediscover Router Page

The Rediscover Router page lets you rediscover a router. Rediscovering a router reloads the Maps database with the SNMP information from the router. Click the router name to display the Focus View paage for that router. To rediscover a router, use the following procedure:

Step 1 Select Rediscover Router on the DLSw page.

Step 2 Enter the IP address or host name of the router as it appears in the database. (You can browse the DLSw Global View page to find the router and then select the Focus view for that router.)

Step 3 Click go.

When the router is discovered, the Rediscover Router page (Figure 2-6) is displayed.

Figure 2-6: Rediscover Router Page

Displaying RSRB Networks on the Web

Note You must have a license for CiscoWorks Blue Maps to view the RSRB page. Ask your Network Administrator for details.

This topic describes how to display the RSRB page from a web browser and how to view the routers, rings, and virtual rings that make up the RSRB network. It contains the following topics:

Note For the RSRB web page to display current information, the RSRB poller daemon must be running. See the CiscoWorks Blue Maps and SNA View Workstation Installation and Administration Guide for information about starting the RSRB poller daemon.

RSRB Page

To display the RSRB page (Figure 2-7), select RSRB from the CiscoWorks Blue home page.

Figure 2-7: RSRB Page

Click one of the buttons in the Request field and click go.

Global View shows the global view, which displays all RSRB routers.
Focus View for Router shows virtual rings, RSRB peers, and Token Rings for a specific RSRB router. Enter the IP address or host name for the router.
View Virtual Ring number shows all RSRB routers for a specific virtual ring. Enter the virtual ring number.

Links

The RSRB web pages contain the following hypertext links to help you navigate through the network information:


When you click this...	RSRB displays
Details in Router state field	In Focus view, list of active routers in that state. In Virtual Ring view, list of active virtual rings in that state.
Router name or IP address	RSRB Focus View page for that router.
Virtual ring number	Virtual Ring view for that virtual ring.

Global View Page

Select Global View on the RSRB page to display the RSRB Global View page, which contains the following areas:

Summary Area
Unknown Routers Area
Active Routers Area
Virtual Rings Area
Token Rings Area
Other Rings Area

Summary Area

The Summary area contains the Summary table, which displays the number of routers in each router state.

Fields

The Summary area contains the following fields:


Field	Description
Router States	Shows state for each router.
Number of routers	Number of routers in each router state.
Details	Click Details for a router state to see a list of routers in that state.

Unknown Routers Area

The Unknown Routers area lists the name or address of each unknown router. If there are no unknown routers, the Unknown Routers area is not displayed. Click a router name or address to display the Focus View page for that router.

Active Routers Area

The Active Routers area lists the name or address of each active router. If there are no active routers, the Active Routers area is not displayed. Click a router name or address to display the Focus View page for that router.

Virtual Rings Area

The Virtual Rings area lists all virtual rings discovered in the network; for each virtual ring there is a list of routers on that virtual ring. If there are no virtual rings, the Virtual Rings area is not displayed. Click a virtual ring number to display the Virtual Ring page for that ring.

Token Rings Area

The Token Rings area lists all Token Rings discovered in the network; for each Token Ring there is a list of routers on that ring and a link to the Ring Information page. If there are no Token Rings, the Token Rings area is not displayed. Click a Token Ring number to display the Ring Properties page for that ring.

Other Rings Area

The Other Rings area lists all discovered rings that are neither virtual rings nor Token Rings; for each ring there is a list of routers on that ring. If there are no other rings, the Other Rings area is not displayed. Click a router name to display the Focus View page for that router.

Focus View Page

Display the Focus View for an RSRB router in one of the following ways:

Select Focus View for Router from the RSRB page, enter the device name or IP address of the router, and click go.
Click a router name or IP address on the Global View page or on a Focus View page for another router.

When you display the Focus View, the box in the upper-right corner displays the name of the focus router.

Focus View Menu Bar

The menu bar on each Focus View page contains the following items:

Home displays the Maps home page, as described in "Using the CiscoWorks Blue Home Page."
RSRB displays the RSRB home page, as described in "Displaying RSRB Networks on the Web."
Telnet starts a Telnet client so you can log in to the focus router.
HTTP starts a web client so you can browse web pages on the focus router.
PU displays a list of PU names that are dependent on the focus router (requires SNA View license).
LU displays a list of LU names that are dependent on the focus router (requires SNA View license).
Help displays online help.

Focus View Fields

The RSRB Focus View page displays information about a specific router.

Fields

The Focus View page contains the following fields:


Field	Description
IP addresses	Lists all the IP addresses, their subnet masks, and their interface types, configured on the router.
Virtual Rings	Lists all the virtual rings configured on the router; click the virtual ring number to display the Virtual Ring View page.
Token Rings	Lists all the Token Rings configured on the router.
Other Rings	Lists all the other rings configured on the router.

Virtual Ring View Page

The RSRB Virtual Ring View page, displayed when you select a virtual ring number on the Focus View or Global View page, describes the virtual rings in the RSRB network. Click the Ring Information link to display the Ring Statistics page for that ring.

When you display the Virtual Ring view, the box in the upper-right corner displays the number of the virtual ring.

Fields

The Virtual Ring View page contains the following fields:


Field	Description
Routers	Lists the total number of RSRB-enabled routers, of each connection state, that make up the selected virtual ring. Click the router name to display the Focus View page for that router.
Token Rings	Lists the Token Rings connected to the selected virtual ring. Click the Ring Information link to display the Ring Statistics page for that ring.
Other Rings	Lists the other rings on the selected virtual ring. Click the Ring Information link to display the Ring Statistics page for that ring.

Peer Statistics Page

The RSRB Peer Statistics page provides information and statistics for the selected peer. The Peer Statistics page contains the General table and the Details table.

General Table

The General table provides information for the selected peer.

Fields

The General table contains the following fields:


Field	Description
State	Current status of the peer.
Source Router	Name of the source router.
Peer Router	Name of the peer router.
Virtual Ring Number	Number of the virtual ring.

Details Table

The Details table provides information for the selected peer.

Fields

The Details table contains the following fields:


Field	Description
Encapsulation Type	RSRB encapsulation: Serial, LAN, Fast-Sequenced Transport (FST), or Frame Relay.
Interface Index	Local interface index value of the RSRB remote peer.
Packets Received	Number of packets received from remote peer.
Packets Sent	Number of packets sent to remote peer.
Bytes Received	Number of bytes received from the remote peer.
Bytes Sent	Number of bytes sent to remote peer.
Explorers Received	Number of explorer packets received from the remote peer.
TCP Queue Length	Number of packets being held by the local router in the TCP output queue for the remote peer.
Packets Dropped	Number of received packets discarded by the local router (packets are dropped because of problems with the configuration, queue overflow, and protocol errors).
Local Acknowledgment	Indicates whether local acknowledgment is used for the sessions going to the remote peer.
RSRB Version	Version of RSRB used between local and remote peers.

Ring Properties Page

The RSRB Ring Properties page provides information and statistics for the selected ring.

Fields

The Ring Properties page contains the following fields:


Field	Description
Source Router	Peer router for which you queried ring information.
Ring Number	Number of the ring.
Bridge Number	Configured number of the bridge that connects this entry's ring to the virtual ring.
Ring Type	Ring type, which can be static, dynamic, SDLC, QLLC, or virtual.
MAC Address	MAC address of either the local router's interface to the ring for local ring entries or the remote peer's interface to the ring for remote ring entries.
Local Ring	Indicates whether the entry represents a local or remote ring: YES indicates a local ring; NO indicates a remote ring.
Interface Index	Local interface into the ring for local ring entries.
Packets Sent	Number of packets forwarded by the local router onto this ring.

Using the Utilities P age

This topic describes how to use the Maps web-based utilities on the Utilities page. Select Utilities from the CiscoWorks Blue home page. The Utilities page (Figure 2-8) is displayed.

Figure 2-8: Utilities Page

On this page, choose one of the following:

Run verification to verify the information in your CiscoWorks Blue installation and configuration, as described in "Verifying the Installation."
Login to NetView to login to the NetView application, as described in "Logging into NetView."
Restore default settings and preferences to restore your settings and preferences to their default values, as described in "Restoring Settings and Preferences."

Verifying the Installation

Select Run verification from the Utilities page to verify that you have installed CiscoWorks Blue correctly. The verification utility checks your configured protocols and tests the tables in the database. Review the displayed data, in the Verification Results Page, to verify that each table contains the correct number of entries.

Logging into NetView

You can access the NetView web page from a web browser. Use the following procedure.

Step 1 Select Utilities from the Maps home page.

Step 2 Select Options from the menu bar. The Options page is displayed (Figure 2-9).

Step 3 Complete the fields on the Options page, as described in "Using the Options Page."

Step 4 Select Login to NetView from the CiscoWorks Blue home page.

If you have not yet used the Options page to configure NetView for Maps, the web browser displays following message:

Please configure the NetView Web Interface using the Options dialog.

If you receive this message, configure the NetView options as described in "Using the Options Page."

Restoring Settings and Preferences

This topic describes how to restore the settings and preferences in your browser after you make changes on a Maps or SNA View web page. Select Restore settings and preferences from the Utilities page. The web browser restores your settings to their default values.

Verification Results Page

The Verification page does the following tasks:

Summarizes the applied licenses.
Summarizes the applications you configured.
Checks your configuration files.
Scans the CiscoWorks Blue database.
Displays a report .

Verification Report

The first section provides a time and date stamp.

=======================================================================
CiscoWorks Blue Verification
                           Mon Mar 15 09:10:14 1999 
                              cwb-aix11.cisco.com
Configuration File:/opt/CSCOcb/etc/cwbinit
=======================================================================

The next section describes the applied licenses.


------------------------------------------------------------------------
                              License Information
------------------------------------------------------------------------
 
    CiscoWorks Blue SNA View:  Licensed
    CiscoWorks Blue Maps:      Licensed

The next section tells you which processes you configured at installation, and whether they are ready for use.


-----------------------------------------------------------------------
Process Summary
-----------------------------------------------------------------------
 
Name       Configured      Ready
    ------     ------------    -------
     APPN          Yes           Yes
     Base          Yes           Yes
     DLSw          Yes           Yes
     RSRB          Yes           Yes
     SNA           Yes           Yes
    TN3270         Yes           Yes

The next section summarizes the devices in your database by protocol.

-----------------------------------------------------------------------
Database Summary
-----------------------------------------------------------------------
 
Total number of devices: 13
    APPN:     3
    DLSw:     8
    RSRB:     3
    TN3270:   2
 
DLSw Key Devices:  6
Physical Units:    7
Logical Units:     7

The last section reports any changes you should make to your installation.


-----------------------------------------------------------------------
Action Summary
-----------------------------------------------------------------------
 
Warnings:
 
1.  No APPN Network Topology Agent was specified in the cwbinit file.  
    Please specify a Network Topology Agent by editing the cwbinit file 
    (/opt/CSCOcb/etc/cwbinit) and setting the following parameters:
    
         nettopoagentdevname = [Agent IP address or name]
         nettopordcommstr = [Agent read community string]
    
              -OR-
    
         nettopoagentcpname = [Agent control point name]

Using the Options Page

Use the Options page to setup SNA preferences and to configure links to the NetView and CiscoWorks 2000 web pages.

Note The NetView item appears on the SNA Filter Results page or SNA Connectivity page only after you use the following procedure to configure a NetView web server from the Options page.

Step 1 Select Options from the menu bar. The Options page (Figure 2-9) is displayed.

Figure 2-9: Options Page

Step 2 In the field "Specify how you would like RIFs to be formatted," select one of the following choices:

Hexadecimal displays RIFs in hexadecimal format:

Decimal displays RIFs in decimal format:

Step 3 In the field "Specify how you would like MAC and SAP addresses to be formatted," select one of the following choices:

0x0123456789ab/0x04 displays MACs and SAPs in hexadecimal format (such as 0xabcdef123456 for a MAC and 0x04 for a SAP).
0123.4567.89ab/04 displays MACs and SAPs in dotted-hexadecimal format (such as abcd.ef12.3456 for a MAC and 04 for a SAP).

Step 4 In the field "Specify which SNA Resource Information tab you would like displayed by default," select one of the following choices:

Basic Search displays the Basic Search SNA window, as described in the topic "Using the SNA Basic Search Tab."
Advanced Search displays the Advanced Search SNA window, as described in the topic "Using the SNA Advanced Search Tab."

Step 5 Use the field "If present, specify the CiscoWorks 2000 Resource Manager Essentials URL" to contain a link to the CiscoWorks 2000 web interface. Enter the CiscoWorks 2000 URL in this field.

Step 6 Use the field "If present, specify the TME 10 NetView for OS/390 Web Interface(s)" to add, delete, or change a link to the NetView web interface.

Click New to add a new NetView web interface.

Select an interface from the list and click Delete to remove a NetView web interface.

Select an interface from the list and click Edit to change a NetView web interface. Go to the topic "Changing the NetView Interface."

Step 7 Click OK to accept the options and close the Options dialog.

Changing the NetView Interface

To change a NetView interface, use the following procedure after clicking Edit on the Options page:

Step 1 In the "Please specify the NetView Identifier" dialog, enter or change the name you want to associate with the NetView web interface.

Step 2 Click OK.

Step 3 In the "Please specify the URL" window, enter or change the URL for the NetView web interface.

Step 4 Click OK to return to the Options page.

Table of Contents

Using the Web Browser

Changing the Size of Dialogs

Using the Save, Reset, and Clear Buttons on Each Page

Using Hypertext Links

Reloading Static Pages

Entering Values into Web Pages

Fields

Fields

Session Connectivity Menu Bar

Fields

Fields

Fields

Node List Page Menu Bar

Fields

Fields

Menu Bar

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Links

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields

Fields