Using the CiscoWorks Blue Home Page

This chapter provides information about how to display network map information from a web browser, such as the Netscape Navigator or Microsoft Internet Explorer. The web interface provides, in tabular format, functions similar to those provided by the standard Motif interface. You can access Maps information from any web browser on any workstation platform, such as a PC running Microsoft Windows or a UNIX workstation.

This chapter includes the following main sections:

Accessing CiscoWorks SNA View and Maps with a Web Browser

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

Note After the CiscoWorks Blue web server is started, there may be a brief initialization period before the 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 JavaScript 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 CiscoWorks Blue 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 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 starting the web browser, review the /opt/CSCOcb/etc/runweb script to verify 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/SNASw 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, as shown in.Figure 2-1

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

Figure 2-1 CiscoWorks Blue Maps and SNA View 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 the "Using the SNA Resource Information Page" section. The SNA View web page requires a license for CiscoWorks Blue SNA View.
APPN/SNASw displays the APPN/SNASw page, with which you can view APPN/SNASw network and local topology, as described in the "Displaying APPN/SNASw Networks on the Web (Maps)" section. The APPN/SNASw 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 the "Displaying DLSw Networks on the Web (Maps)" section. 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 the "Displaying RSRB Networks on the Web (Maps)" section. 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 the "Using the CiscoWorks Blue Home Page" section.
APPN/SNASw displays the APPN/SNASw page, with which you can view APPN/SNASw network and local topology, as described in the "Displaying APPN/SNASw Networks on the Web (Maps)" section. 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 (Maps)" section. This selection requires a Maps license.
RSRB displays the RSRB page, with which you can view the RSRB network devices, as described in the "Displaying RSRB Networks on the Web (Maps)" section. 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 the "Using the SNA Resource Information Page" section. 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 the "Using the Utilities Page" section.
Options displays the Options page, as described in the "Using the Options Page" section.
Help displays the online help.

Web Browser Conventions

This section 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 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:

Optionally, begin the value with 0x or 0X; all remaining characters must be hexadecimal characters or periods (.)
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 uppercase 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

This section describes SNA Resource Information and shows the screens used to manage SNA resources.

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

Network Session Connectivity Path

SNA View is illustrates a network session connectivity path from a physical unit (PU) or logical unit (LU), back through the SNA or TCP/IP network to an SNA mainframe computer. It prompts 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.

SNA View includes the mainframe as a path tool target for diagnosing IP connectivity problems on HPR/IP links. The path too allows you to view the IP network between the SNASw router and an HPR/IP mainframe.

SNA Resource Information

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 sections:

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 uniquely identifies 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 list of 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 IP devices exist in the network path, click Pathtool to see the hops between pairs of routers.

SNA Resource Information Page

On the SNA Resource Information page, you can select the Basic Search tab or the Advanced Search tab, as shown in Figure 2-2. These tabs are discussed in the following subsections:

Using either tab to 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.

For more information, see the "How Do I Search for Sessions" section.

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 a simple criterion, such as a PU or LU name, or LAN or TCP/IP address. For more information, see the "Basic Search Tab" section.
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/SNASw information. For more information, see the "Advanced Search Tab" section.

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

For more information, see the "How Do I Search for Sessions" section.

Basic Search Tab

The Basic Search tab allows network operators 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.

When you specify a PU or LU name in the Basic Search tab, and you want to specify a domain name, include a period (.) separator between the SNA resource name and the domain name (for example, PUC25.DOMAIN1). Include the period (.) separator even when you use wildcards in your search.

For example:

If you enter the string *.DOM* and search for PU names, you will find all the PUs in just those domains with domain names starting with DOM.
If you enter the string *DOM* and search for PU names, you will find all PUs with the characters DOM in their PU names, in all domains. This is the same as searching with the *DOM*.* string.

In the Name Type field, indicate the kind of name you entered in the Name field:

PU2/2.1 specifies a PU 2 or PU 2.1 name
LU specifies an LU name
CP specifies a CP name
IDBLK/IDNUM specifies an IDBLK/IDNUM pair
PU4/NODE specifies a PU 4 name. You can also enter a physical line name, a physical line PU name, a logical line name, a logical line PU name, a local FEP name, a remote FEP name, or a link station name.

You can specify all of these fields with or without the domain name. If you specify a domain name, the named resource must have been discovered from the VTAM with the specified domain or there will not be a match.

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.

Note If you enter a MAC and SAP for a PU 4, you must also enter the node name in the PU4/NODE 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 3 In the Specify TCP/IP Information field, 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 TCP/IP 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 with host names beginning 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 with host names beginning with the characters CWBC, and are in the CISCO.COM domain.

Note If you enter TN3270 information, do not enter a name in the PU4/NODE field. If you enter TN3270 information and a PU 4 name, the query is invalid.

In the Port field, enter the port number. (If you enter a port number, you must also enter an internet address in the TN3270 Client TCP/IP Host Name 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 check Show only exact matches to display only those sessions that exactly match your criteria. If you uncheck this check box, you will see a list of sessions that match any of your criteria.

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

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

Note Keep the session limit less than1500. You could experience problems viewing query results if the session limit is greater than1500.

Step 6 Click go. The SNA Filter Results Page is displayed.

Continue with the "SNA Filter Results Page" section.

Advanced Search Tab

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

Figure 2-3 Advanced Search Tab

Step 1 In the Specify Basic Search Information field, enter the PU or LU name of an SNA resource in one or more of the following fields:

In the PU2/2.1 Name field, enter the PU name of a PU 2 or PU 2.1.
In the LU Name field, enter an LU name.
In the PU4/NODE Name field, enter the name of the PU 4. Optionally, you can enter a physical line name, a physical line PU name, a logical line name, a logical line PU name, a local FEP name, a remote FEP name, a link station name, a switched major node name, an XLA major node name, or an NCP major node name.

You can specify all these fields with or without the domain name. If you specify a domain name, the named resource must have been discovered from the VTAM with the specified domain or there will not be a match.

The values you enter in the Name fields determine what results are displayed:

If you enter an asterisk (*) in the PU2/2.1 Name field and a switched major node name in the PU4/NODE Name field, you will get all the PU 2s and PU 2.1s associated with the switched major node.
If you enter an asterisk (*) in the PU2/2.1 Name field and a PU name in the PU4/NODE name field, you will get all the PU 2s and PU 2.1s associated with the named PU 4.
If you enter an * in the LU Name field and a name in the PU2/2.1 Name field, you will get all the LUs associated with the named PU.
If you enter a FEP name in, you will get all the PU 4s at that FEP.
If you enter a part of a PU 4 name and wildcards, you will get all the PU4s that match the name pattern you specify.

The MAC Address/SAP Address field and the Status field apply to a PU 2 or a PU 4, depending on the node names you enter:

If you enter a PU 4 name, or part of a PU 4 name and wildcards, you get a list of PU 4-PU 4 sessions. The MAC/SAP field and the Status field apply to the PU 4.
If you enter a PU 2 name, or part of a PU 2 name and wildcards, you get a list of PU 2 sessions. The MAC Address/SAP Address field and the Status field apply to the PU 2.
If you enter both a PU 2 name and a PU 4 name, you get a list of PU 2 sessions that depend on the specified PU 4s. The MAC Address/SAP Address field and the Status field apply to the PU 2.

When you specify a PU or LU name in the Advanced Search screen, and you want to specify a domain name, include a period (.) separator between the SNA resource name and the domain name (for example, PUC25.DOMAIN1). Include the period (.) separator even when you use wildcards in your search.

For example:

If you enter the string *.DOM* and search for PU names, you will find all PUs in just these domains with domain names beginning with DOM.
If you enter the string *PU1* and search for PU names, you will find all PUs that have the characters PU1 in their PU names, in all domains. This is the same as searching with the *PU1*.* string.

In the MAC Address/SAP Address field, enter the MAC and SAP of the SNA resource. The MAC should match the node (PU 2 or PU 4) in the name field or be the destination MAC.
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 TN3270 Client Host Name/Port field, enter the client host name or IP address and port number of the SNA resource.

Use wildcard characters in the PU2/2.1 Name, LU Name, PU4/NODE Name, CP Name, and TN3270 Client Host Name fields.

Use an asterisk (*) in place of any number of valid characters. For example, C*.CISCO.COM displays all resources with host names beginning 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 with host names beginning with the characters CWBC, and are in the CISCO.COM domain.

Step 2 In the Specify PU Status field, select one or more 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 In Windows, to specify more than one status condition, hold down the Ctrl key while selecting subsequent items.

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 or more of the following protocols:

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

Note In Windows, to specify more than one protocol, hold down the Ctrl key while selecting subsequent protocols.

Step 4 In the Specify Router Dependencies field, enter either 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. 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/SNASw Criteria field, enter the following values:

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

Step 6 Optionally check 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.

Continue with the "SNA Filter Results Page" section.

How Do I Search for Sessions

This section gives you some tips on how to search for various SNA sessions.

How do I find LU sessions?

All LUs associated with a PU 2 or 2.1? Enter an * in the LU Name field and a name in the PU2/2.1 Name field.

One specific LU? Enter the LU name. Optionally, you can enter PU qualifiers such as the MAC address or IDBLK/IDNUM in the appropriate field.

A TN3270 LU? Enter the TN3270 Client TCP/IP Host Name or address for the LU in TN3270 Client Host Name/Port field.

How do I find PU 2 or 2.1 sessions?

One specific PU 2 or 2.1? Enter the PU2/2.1 name, MAC address, CP name, or IDBLK/IDNUM for the session in the appropriate field.

A list of PU 2 or 2.1 sessions going through a FEP/NCP? Enter an * in the PU2/PU2.1 Name field and enter the name of the NCP in the PU4/Node field.

A list of PU 2 or 2.1 sessions going through an XCA? Enter an * in the PU2/2.1 Name field and enter the name of the XCA node in the PU4/Node field.

A list of PU 2 or 2.1 sessions defined in a switched major node? Enter an * in the PU2/2.1 Name field and enter the name of the switched major node in the PU4/Node field.

A list of PU 2 or 2.1 sessions passing through a particular router? Enter the router name or address in the Router IP Address or Name field.

A list of PU 2 or 2.1 sessions using the DLSw protocol? Select only the DLSW protocol.

A list of APPN/SNASw sessions associated with a DLUR or DLUS? Enter the DLUR or DLUS name in the associated field.

A list of PU 2 or 2.1 sessions in all domains whose domain names start with DOM? Enter the string *.DOM* in the PU2/2.1 Name field.

A list of PU 2 or 2.1 sessions, in all domains, that have PUs with the characters PU1 in their PU names? Enter the string *PU1*.* in the PU2/2.1 Name field.

How do I find PU 4 sessions?

A list of PU 4-PU 4 sessions associated with a FEP/NCP? Enter just a FEP name in the PU4/NODE Name field.

A particular PU4-PU4 session? Enter one of the NCP names, a physical or logical line name, or a link station name in the PU4/Node field, or enter one of the MAC/SAP addresses in the MAC Address/SAP Address field.

A list of PU4-PU4 sessions passing through a particular router? Enter an * in the PU4/Node field and enter the router name or address in the Router IP Address or Name field.

SNA Filter Results Page

The SNA Filter Results page displays all the SNA sessions that matched the criteria 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 Filter Results menu bar lets you select from the options, as described in the "Filter Results Menu Bar" section.
The Filter Criteria table displays a summary of the filter criteria you entered on the SNA Resource Information Page, as described in the "Filter Criteria Table" section.
The Summary table displays a summary of the state of all sessions selected by your search criteria, and is described in the "Summary Table" section.
The Sessions table display detailed information about any sessions that exactly match your search criteria, and all sessions that match some of your search criteria depending on whether you select Show only exact matches. The Sessions table is described in the "Sessions Table" section.

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 "Using the CiscoWorks Blue Home Page" section.
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.

Filter Criteria Table

On the SNA Filter Results page, the Filter Criteria table displays a list of the criteria you selected, as shown in Figure 2-4.

Figure 2-4 Filter Criteria Table

Fields

The Filter Criteria table contains some the following fields depending on the type of SNA resource:

Field	Description
PU 2/2.1 Name	Name of the PU 2/2.1.
Status	Displays the states of the sessions you selected in the basic or Advanced table that matched your criteria.
Protocols	Displays the protocols you selected in the Basic or Advanced tab that matched your criteria.
Exact Matches Only	Displays whether the criteria you selected on the Basic or Advanced tab resulted in exact matches.

Summary Table

On the SNA Filter Results page, the Summary table displays a summary of the state of all sessions selected by your search criteria, as shown in Figure 2-5.

Figure 2-5 Summary Table

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 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.
Number of sessions	The number of sessions in the selected connection state that meet the specified criteria.
Total number of sessions	The total number of sessions in all the connections states that meet the specified criteria.

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

Number of sessions

The number of sessions in the selected connection state that meet the specified criteria.

Total number of sessions

The total number of sessions in all the connections states that meet the specified criteria.

Sessions Table

On the SNA Filter Results page, the Sessions table displays details of all sessions selected by your search criteria, as shown in Figure 2-6. 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.

Figure 2-6 Session Table

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 contain some the following fields depending on the type of SNA resource:

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.
PU2 Name.Domain	PU 2 name and domain name for each session that meets your criteria.
Remote FEP Name	Remote front-end processor, which is the control unit that handles the remote PU 4 and that might be a 3745 running NCP.
Logical Line PU	Local PU definition for the remote connection, which is the local VTAM's defined name for the remote PU 4. The remote PU 4 becomes active when the connection to the remote FEP is activated.
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/SNASw control point name of the device that provides the DLUR services to the LU.
DLUS Name	APPN/SNASw control point name of the VTAM host.
TN3270	Name of the TN3270 server for this PU session (for TN3270 sessions only).
IDBLK/IDNUM	Name of the SNA resource.
Node Name	Name of the major node under which the PU is defined.

1If 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).

2If 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, shown in Figure 2-7, 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 of the Session table on the SNA Filter Results Page.

Figure 2-7 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 Window System 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/SNASw, or TN3270

There are various 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/SNASw Node Details page for an APPN/SNASw 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 Window System 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" section.
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 configured more than one NetView web URL on the Options page, the NetView item on the menu bar displays a list 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 Window System 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. The Pathtool page contains the Pathtool table, which displays information about each hop in the path, as shown in Figure 2-8.

Figure 2-8 Pathtool Page

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 there are more than two routers in the Session Connectivity Display, the Select Routers window is displayed. 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.

Using the Utilities Page

This topic describes how to use the web-based utilities on the Utilities page. Select Utilities from the CiscoWorks Blue home page. The Utilities page is displayed, as shown in Figure 2-9.

Figure 2-9 Utilities Page

On the Utilities page, choose one of the following:

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

Verifying the Installation

Select Run verification from the Utilities page to verify that you correctly installed CiscoWorks Blue. The verification utility checks your configured protocols and tests the tables in the database. Review the displayed data, in the "Verification Results Page" section 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, as shown in Figure 2-10.

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

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

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 performs 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/SNASw    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/SNASw:     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:

Using the Options Page

Use the Options page to set up 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 is displayed, as shown in Figure 2-10.

Figure 2-10 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:

 
0x0a30410200a241000000.

Decimal displays RIFs in decimal format:

 
1040.2.10.2.1040.0.0.0

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 "Basic Search Tab" section.
Advanced Search displays the Advanced Search SNA window, as described in the "Advanced Search Tab" section.

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 "Changing the NetView Interface" section.

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 CiscoWorks Blue Home Page

Accessing CiscoWorks SNA View and Maps with a Web Browser

Preparing to Start the Web Browser

Accessing the CiscoWorks Blue Server

Using the Maps Web Browser from the Maps Motif Tools Menu

Creating Bookmarks

Using the CiscoWorks Blue Home Page

Using the Links on the Home Page

Using the Menu Bar

Web Browser Conventions

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

Using the SNA Resource Information Page

Network Session Connectivity Path

SNA Resource Information

SNA Resource Information Page

Basic Search Tab

Advanced Search Tab

How Do I Search for Sessions

How do I find LU sessions?

How do I find PU 2 or 2.1 sessions?

How do I find PU 4 sessions?

SNA Filter Results Page

Filter Results Menu Bar

Filter Criteria Table

Fields

Summary Table

Fields

Sessions Table

Fields

Session Connectivity Display Page

Session Connectivity Menu Bar

Pathtool Page

Fields

Using the Utilities Page

Verifying the Installation

Logging into NetView

Restoring Settings and Preferences

Verification Results Page

Verification Report

Using the Options Page

Changing the NetView Interface