Reporting ACF/TAP data using record numbers
When ACF/TAP processes trace data files, it sequentially numbers the records in several different ways. The numbering makes it easy to cross-reference the same record in different types of reports. Figure 1 shows an example of a VTAM® trace file with different types of trace records on it.
Notes:
- ACF/TAP sequentially numbers every record on a trace file, even if the record is a type that ACF/TAP does not process. This absolute sequence number appears only on the SYSPRINT log.
- ACF/TAP sequentially numbers every record that it processes (SUMMARY=EVERY) or can process (SUMMARY=YES or ALL) when it scans the file (INPUT=SCAN). ACF/TAP tests the count select limits (START=count; END=count) against this process number. See START and END parameters for more information.
- ACF/TAP sequentially numbers each PIU and buffer trace record that it can process. ACF/TAP tests the count select limits against the host trace record number. Every PIU that ACF/TAP analyzes is called a message and is assigned a message number.
- A line trace record consists of multiple NCP line trace events of variable length, depending on the type of communication scanner. ACF/TAP sequentially numbers each NCP line trace event and refers to it by an element number. A GPT record can consist of multiple events of variable length. ACF/TAP sequentially numbers each GPT event and refers to it by an element number.
- A line trace message can consist of multiple elements that can span one or more records. Each message that is assembled from the line trace data is assigned a message number. A line trace record can contain more than one message.
(VTAM Trace File, Recorded by GTF on MVS only)
|
|_____________________ Trace File ____________________________________________________________________________>
| SOURCE=GTF
___________ ___________ ___________ ___________ ___________ ___________ ___________ ___________ _____________>
| Absolute | Absolute | Absolute | Absolute | Absolute | Absolute | Absolute | Absolute | Absolute
1 | Sequence | Sequence | Sequence | Sequence | Sequence | Sequence | Sequence | Sequence | Sequence
| #1 | #2 | #3 | #4 | #5 | #6 | #7 | #8 | #9
|___________|___________|___________|___________|___________|___________|___________|___________|_____________>
| TYPE= | TYPE= | TYPE= | TYPE= | TYPE= | TYPE= | TYPE= | TYPE= | TYPE=
| GTF | RNIO | NCP Line | User Trace| VTAM | RNIO | NCP Line | GPT | GPT
2 | Header | Trace | Trace | (Not | Buffer | Trace | Trace | Trace | Trace
| | #1 | #1 | Processed)| Trace | #2 | #2 | #1 | #2
| | | | #1 | #1 | | | |
|___________|___________|___________|___________|___________|___________|___________|___________|_____________>
| | RNIO | | | VTAM | RNIO | | |
3 | | Message | | | Buffer | Message | | |
| | #1 | | | Message | #2 | | |
| | | | | #1 | | | |
|___________|___________|___________|___________|___________|___________|___________|___________|_____________>
| | | Multiple | | | | Multiple | Multiple | Multiple
4 | | | Line Trace| | | | Line Trace| GPT Trace | GPT Trace
| | | Elements | | | | Elements | Elements | Elements
|___________|___________|__ _ _ _ __|___________|___________|___________|__ _ _ _ __|__ _ _ _ __|_____________>
| | | #|#|#|#|# | | | | #|#|#| |# | #|#|#|#|# |
| | | 1|2|3|4|5 | | | | 6|7|8| |n | 1|2|3|4|5 |
4 | | | | | | | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | | | | | | |
| | | S| | | | | | | | | |E| | | | | | | |
|___________|___________|__|_|_|_|__|___________|___________|___________|__|_|_|_|__|__|_|_|_|__|_____________>
| A | A|
Start of ______|_| | End of Message (E) __||
Message (S) | Line Trace| |
| Elements | |
| #1 to #5 | |
|___________| |
|________________ Line Trace Message #1 _______________|
5