Selecting a region layout

Regions overview is the central monitoring and control hub for C\Prof Web UI. Whilst navigating C\Prof Web UI, you can return to this screen at any time by clicking the home button (). From Regions overview you can monitor and record trace data from your CICS regions using either the card layout or the table layout. Each layout provides a similar functionality but presents the status of your CICS regions in different ways.

Card layout

The card layout displays your monitored CICS regions as cards containing a graph of transaction activity. When you start the C\Prof web user interface, the card layout is selected by default. If you are in the table layout, you can switch back to the card layout by clicking the card layout button ().

The CICS region card

A card displays the following information:

The CICS region's application ID (APPLID)
Collection status (both written and color-coded)
CICS region information, including the CICS version, the LPAR that the CICS region is executing on, the job name, and the job ID.
A graph showing the number of transactions attached and the number of transactions collected in the CICS region, or, if no graph is displayed, a message containing additional information. For a complete list of error messages and codes, see Messages and Codes.
Snapshot, transaction analysis, and recording buttons.

Color coding

The color coding beneath the action buttons on a card indicates the current collection status. The card can display one of the following colors:

Clear (white): The CICS region is eligible for profiling. No collection is taking place.
Green: Record for profiling is active.
Yellow: A collection warning message has been reported on this CICS region. Review the error messages for more information.
Red: A collection error message has been reported on this CICS region. Review the error message for more information.

Groups

Cards are organized into groups defined in your C\Prof collection server configuration file. Actions that apply to all members of a group are displayed in the group action bar at the top of the group.

$Recording CICS trace for an MRO group and showing transaction collection rate in the C\\Prof Web UI$ C\Prof card layout

Note: To limit the performance impact on your web browser, the C\Prof Web UI places a limit on the number of CICS regions it will display. Use filtering to drill down to the regions you are interested in. For more information, see Using the region filter.

Table layout

The table layout displays your monitored CICS regions in a more compact form by organizing them in a table. To open the table layout, click the table layout button (). To access the trace collection and transaction analysis action buttons for a CICS region, find the region you are interested in and then click the expand button (). To hide the action buttons, click the collapse button ().

$C\\Prof Web UI regions overview table layout$ C\Prof table layout

Columns available in the table layout

The following columns are available in table layout. See Column configurations to configure your column settings.

Column name	Meaning
CICS APPLID	CICS region generic application ID
Attached	Total number of transactions attached by CICS
Buffers	The number of trace buffers processed (collected) during trace collection
Collected	Number of transactions collected
Version	CICS version
Error Code	Displays C\Prof collector message codes. Refer to Messages and Codes for more information.
Error Message	Message associated with the completion of the last request
Group	Group that the CICS region belongs to as defined in your C\Prof configuration file
Group ID	The ID number of the group
Unique ID	The C\Prof Unique ID for the CICS region
JobID	CICS region Job ID
Jobname	CICS region Job name
Levels	Trace domain levels set in the CICS internal trace
LPAR	LPAR where the CICS region is executing
Monitor	The C\Prof collection server that is monitoring this CICS region
MRO	Indicates if this region belongs to a multiregion operation (MRO) group
Size	Size of the CICS internal trace table
Snap Count	Number of snapshots attempted in the CICS region
Status	Current status of C\Prof activity against the region: READY The CICS region is eligible for profiling PENDING A collection request is about to start PROFILING Recording for profiling is active SNAPPED The internal trace has been snapped. WARNING The most recent request ended with a warning ERROR The most request ended with an error
Sysplex	Sysplex that the LPAR belongs to
Trace	Current status of the CICS internal trace table. STARTED Internal Trace Status is STARTED STOPPED Internal Trace Status is STOPPED OFF Master System Trace Flag is OFF
Uptime	The time (in seconds) since the system was started
Wrap Time	Estimated time for the internal trace to wrap

Using the region filter

Use the region filter in either the card layout or the table layout to restrict the display and show only those CICS regions of interest to you. To filter CICS regions, enter your filtering criteria beside the search icon ().

Filters can be specified using one of the following formats:

id=GROUP:APPLID

Show CICS regions by group and application id.

The GROUP parameter may one of the following:
- The name of the group. Group names are defined in your C\Prof configuration file.
- A single asterisk (*) to indicate all groups.
- A name pattern containing one or more asterisks (*) that may match multiple groups.
- To filter the display to show only UNGROUPED CICS regions, simply omit the GROUP parameter entirely (leave it blank).
The APPLID may be one of the following:
- The application ID of the CICS region
- A single asterisk (*) to indicate all CICS regions.
- A name pattern containing one or more asterisks (*) that may match multiple CICS regions.

lpar=LPAR

Show CICS regions on the specified LPAR. You can use the lpar filter as a single statement, or you can append it to the end of an id filter using an ampersand (&).

The following examples demonstrate how to use the filter:

To display a CICS region named CICSDEV1 in a group named DEV1, enter the following:

id=DEV1:CICSDEV1
To show all CICS regions in a group named PROD:

id=PROD:*
To show all CICS regions in a group named PROD that begin with SYS:

id=PROD:SYS*
To display all CICS region named CICSDEV1 in any group, enter the following:

id=*:CICSDEV1
To show all the ungrouped CICS regions:

id=:*
To show the CICS regions in LPAR SYS1 enter the following:

lpar=SYS1
To show a CICS region named CICSTEST in group TEST on LPAR SYS1, use the following:

id=TEST:CICSTEST&lpar=SYS1

To reset the display, simply remove your search criteria from the filter box.

Actions available from Regions overview

You can perform the following actions from Regions overview:

Record the CICS internal trace for transaction profiling by clicking the record button (). For more information, see Recording CICS transactions.
Conduct detailed analysis of transactions recorded by C\Prof by clicking the zoom button (). For more information, see Analyzing recorded transactions.
Take a snap of the CICS internal trace to an auxiliary trace data set by clicking the snap button (). For more information, see Taking a snap of the CICS internal trace.