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