Search Rocket site

Browsing the transaction list

The Transaction List displays high-level information about transactions that have been captured by the C\Prof collection server. To access this panel, select a date range on the Transaction Selection Criteria panel and press Enter. Use PF7 and PF8 to scroll through the transaction list. Use PF10 and PF11 to move left and right through the columns.

The **Transaction List** panelThe Transaction List panel (ISFP)

Note: You can also use the C\Prof Web UI to browse lists of transactions. For more information, see Transaction list.

The following commands can be entered on the Command line:

The Transaction List panel - Command line options

Line action Description
FORM (PF4) Opens the Form panel where you can select which columns you wish to display in the Transaction List.
FILTER (PF6) Opens the Transaction Selection Criteria panel. Use this panel to include or exclude particular transactions from being displayed in the transaction list.
SORT name Sort the transaction list by the specified column name or abbreviation.
REFRESH Refresh the list by reapplying the active selection criteria.
FIND string Find and highlight a character string.

More information about each of these commands can be found in the following sections.

Applying a filter to the transaction list (FILTER command)

Use the Transaction Selection Criteria panel to identify transactions to include in (or exclude from) your analysis. To apply a filter, complete the following steps:

  1. On the Transaction List panel, enter the FILTER command (PF6).

    The **Transaction Selection Criteria** panelThe Transaction Selection Criteria panel

  2. Enter your selection criteria, and then press Enter to display the updated transaction list.

    Tip: Use the RESET command to clear all selection criteria.

Filtering criteria

The Transaction Selection Criteria panel has the following fields.

Date and time fields

Field Description
Relative Display the most recently processed transactions. For example, a value of 5 Minutes ago will select all transactions that have occurred in the last five minutes.
Absolute Display transactions that were wholly or partially processed within the date time range.

Identification fields

Names may be specified as a pattern using wildcard characters * (matching zero or more characters) and + (matching a single character)

Field Description
CICS region The CICS region or the CICS group name. The group name is specified in the collector configuration file using the GROUP control statement. For more information, see GROUP.
Transaction The CICS transaction ID.
Program Any program used by the transaction. Program can be the initial program, or any program used by the transaction.
User ID The security user identifier, typically the RACF user ID.
Task number The CICS task number.

Performance fields

Elapsed time threshold. Only transactions that exceed all of the times specified are shown.

Enter 0 to select all transactions in that category.

Field Description
Response time Response time, for example 2 or 2.0 represents 2 seconds.
Processing time The elapsed time processing in application code.
EXEC CICS The elapsed time processing the EXEC CICS calls.
VSAM file The elapsed time processing VSAM file calls.
Program Control The elapsed time spent in program control.
Transient data The elapsed time processing transient data calls.
Temporary storage The elapsed time spent processing temporary storage calls.
Web and services The elapsed time processing web and services.
DB2 The elapsed time processing EXEC SQL calls to DB2.
MQ The elapsed time processing EXEC MQ calls.
IMS The elapsed time processing EXEC DLI calls to IMS-DBCTL.
Syncpoint The elapsed syncpoint time (explicit and implicit).
Journaling The elapsed time spent processing journaling calls.
Interval Control The elapsed time spent in interval control.
ENQ/DEQ The elapsed time spent during enqueue and dequeue.
JCICS The elapsed time spent processing JCICS calls.

Abnormal termination fields

Field Description
Abend code Abend code: Enter * to indicate all codes.

Changing the columns in the transaction list (FORM command)

C\Prof collects a wide variety of information from the CICS internal trace. To change the columns displayed in the Transaction List panel to suit your analysis, complete the following steps:

  1. On the Transaction List panel, enter the FORM command (PF4). A list of all possible column headings is displayed in the order they will be displayed on screen:

    Changing the columns in the Transaction List using the Form panelChanging the columns in the Transaction List using the Form panel

    Each performance metric has a time and count file heading, for example EXEC CICS Time and EXEC CICS Count. The time component is the elapsed time that is accountable to this event. The count component is the number of times that the event occurred. The count fields are initially omitted.

    The Usage column indicates how a column is displayed. It can contain one of the following values:

    Values that may be entered in the Usage column

    Value Meaning
    (blank) Display this column.
    FIXED Display this column and fix it into position on the left side of the display. The column will not shift from its position, even when scrolling left and right through the columns on the transaction list.
    OMIT Do not display this column.
  2. Enter line action / next to a heading to display a selection list of possible line actions. The following line actions may be entered next to a column heading.

    Line actions used to control the display of columns in the transaction list

    Line action Description
    F Fix column. The column will be fixed into position on the left side of the display. A column that has been fixed into position will display the word FIXED in the Usage column.
    O Omit column. Remove the column from the transaction list. A column that has been omitted will display the word OMIT in the Usage column.
    M / MM Select a column or block of columns to move.

    Use line actions M or MM to select the column(s) and then enter either line action A (move after) or B (move before) to move the column(s) to the new location.

    To select a single column, use line action M. To move a block of columns, enter line action MM on the first and last events you wish to include.
    A Move After. Move the columns selected by line actions M or MM after the current column.
    B Move Before. Move the columns selected by line actions M or MM after the current column.

    Tip: You can also overtype values in the Usage column to adjust their display values. You can remove either the FIXED or OMIT values from the Usage column by simply deleting it.

  3. Make changes to the form, and then press PF3 to see the updated transaction list.

Sorting the transaction list (SORT command)

The transaction list can be sorted in one of the following ways:

  • Position the cursor on the separator line immediately below the column heading of the field you wish to sort, and then press enter. The cursor will remain positioned to allow you to press enter again to reverse the order.

  • Enter the SORT command, followed by the field name or alias of the column you wish to sort by. For example, to sort by program, enter SORT PROGRAM.

  • Longer column names may be sorted by using its abbreviation. For example, you can also sort by program by entering SORT P. To sort by response time, enter SORT RESPONSE, SORT RESP, or SORT R. A complete list of field abbreviations and aliases can be found by accessing the in-product help (PF1).

Finding a character string in the transaction list (FIND command)

To find and highlight a character string in the transaction list:

  1. On the Transaction List panel, enter the FIND command together with the string you wish to locate. For example, to find all instances of the word CICS, enter FIND CICS.

  2. To move between highlighted strings, press PF5.

  3. To clear all highlighting, enter RESET.

Additional options include:

FIND | F string [ NEXT | PREV | FIRST | LAST ] PREFIX | SUFFIX | WORD