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