Browsing trace entries

Auxiliary trace data sets are displayed in a tabular format that presents a list of events contained within the trace. Use PF7 and PF8 to scroll up and down through the list. Use PF10 and PF11 to move left and right through the columns of the display. You can also jump to a particular time period if you know when the problem occurred by overwriting the value above the Time column.

Browsing a list of events in the trace

Navigation and filtering

The following options allow you to navigate, filter and adjust the display to assist in identifying potential problems.

Options used to browse auxiliary trace data sets

Options	Description
Time	Use to jump to a particular time in the trace. To set the desired time, overtype the underlined value above the Time column and then press Enter. The time is specified in hh:mm:ss.ssssss format.
Level	Level in conjunction with the FILTER command helps to control which point IDs are included and excluded in the display. Increasing the level increases the amount of filtering that takes place. For additional information, see the FILTER command in Commands.
Gap	Use to identify significant time gaps in the trace. Entries that show a jump in time are highlighted. The gap is specified in seconds, fractions of seconds, or both. Examples: Identify gaps of one second: Use 1, 1.0, or 001.000000 Identify gaps of 200 milliseconds: Use .2, 0.2, or 000.200000 Identify gaps of one microsecond: Use 0.000001 (this is the smallest value you may enter)
Format	Controls how long lines are displayed on the screen. Format may be one of the following values: SNGL: Display the event on a single line. Scroll right (PF11) to see more of the formatted trace entry. WRAP: Wrap long lines onto the next line.

Commands

The following commands can be entered on the Command line:

Commands and function keys used to browse the auxiliary trace data set

Command	Description
RESET	Remove outstanding line actions. For a list of line actions, see Line actions.
FIND string	Search for a specified character string in the current view. Press the Repeat Find function key (F5) to find the next occurrence. Additional options include: FIND*F string* [ NEXT PREV FIRST LAST ] PREFIX SUFFIX WORD**
TIME	Set the format of the Time column. The following options are available: TIME W: Wall-clock time. TIME R: Elapsed time relative to the record at the top of the display (base). TIME E: Elapsed time between each record. TIME N: Switch between microsecond and nanosecond precision when displaying relative and elapsed times. Enter TIME without parameters to see additional options.
.x	Assign label command. Assign the 1-7 character label x to "remember" the current position in the log file. You can relocate to this position using the LOCATE command.
LOCATE	Without parameters, the LOCATE command displays the currently assigned labels. To position the display at a particular label, use LOCATE .x, LOCATE x, or specify the record number using LOCATE n.
LABELS	Controls the display of labels. The following options are available: LABELS ON: Shows all assigned labels LABELS OFF: Hides all labels from the display LABELS RESET: Removes all labels.
TIMEOUT	Set a time limit on delays caused by long data set scans caused by filtering, scrolling, or FIND commands. When the timeout value (in seconds) is reached, control is returned back to the terminal and the file position is updated to where the scan was interrupted.
FINDLIM n	Set the maximum number of records to process when using primary commands FIND and line actions TX and TU. The Repeat Find function key (F5) recommences the search from the start of the next block of records.
FILTER	Filter by point ID. Use FILTER in conjunction with the Level field to control which point IDs are included and excluded in the display. Increasing the level increases the amount of filtering that takes place. See the example below.

FILTER example

Consider the following filter:

Exc  Level  Point IDs
  *     0    DD *      MN *      SM *     ...Always excluded       
        1    XM 1102                      ...Task attach                       
        2    XS 070A   AP 0741            ...Security/abend                
        3    AP 0500   PG 1101            ...Program load                      
        4    AP E160   AP E161            ...EXEC CICS                         
        5    AP 3250   AP 3251   AP 3281  ...DB2 SQL                           
        5    AP A090   AP A091            ...IBM MQ                            
        5    AP 0328   AP 0329   AP 0311  ...IMS DLI                           
        5    AP 21E0                      ...JCICS

With this filter in place, the following point IDs are displayed for the specified Level:

Level 0: All point IDs except for the DD, MN and SM domains
Level 1: Task attach events only
Level 2: Security, abend and level 1
Level 3: Program load and levels 1 and 2
Level 4: EXEC CICS and levels 1, 2 and 3
Level 5: DB2, MQ, IMS, JCICS and levels 1, 2, 3 and 4

Function keys

The following function keys are available in the trace viewer. Function keys available in the trace viewer

Function key	Description
F1	Access online help
F3	Exit
F4	Switch between Formatted mode, and ISPF Browse mode. You can also switch mode by selecting Mode in the action bar.
F5	Repeat the last FIND command.
F6	Alternate between displaying the CICS Region and Task number columns, and the Time column.
F7	Scroll up.
F8	Scroll down.
F10	Scroll left.
F11	Scroll right.
F12	Cancel.

Line actions

The following line actions may be entered next to an event in the trace.

Controlling the time

Line actions used to control the time display in the C\Prof trace viewer

Line action	Description
W	Display wall-clock time.
R	Display relative times. For each record this is the elapsed time from the selected baseline record.
E	Display the elapsed time between each record.
N	Switch to nanosecond precision. Use N again to switch back to microsecond precision. Display relative or elapsed time in nanosecond precision.
T	Reset the display to position the selected record at the top of the display.

Filtering and level options

The following line actions filter the display to include required trace entries only. You can filter by domain or by individual point IDs. Use the FILTER command to view and edit the current filter settings.

Line actions used for filtering and level display in the C\Prof trace viewer

Line action	Description
I	Only include this point ID in the display.
ID	Include all point IDs for this domain in the display.
X	Exclude this point ID from the display.
XD	Exclude all point IDs for this domain from the display.

Additional options

Additional line actions used to analyze an auxiliary trace data set

Line action	Description
/	Display the selection list of valid line actions.
S	Display the formatted record. Formatted records can be displayed in standard format (STD) or dump format (DUMP). Press PF4 to switch between the two formats.
L	Assign a label to a record. Labels have the format .Znnnnnn and are assigned sequentially from .Z000000 to .Z999999.
TX	Track the transaction. Show only entries with the same task number. Enter the RESET command to stop tracking and restore records that were excluded from the transaction. See also the FINDLIM command.