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 (Return to Region overview). 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 (Card layout).

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 (Table layout). 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 (Expand). To hide the action buttons, click the collapse button (Collapse).

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 (Table layout).

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:

results matching ""

    No results matching ""