gtpm1m41 | TPF V4R1 Migration Guide: 3.1 to 4.1 |
The path information unit (PIU) trace facility provides a detailed trace of the data, or PIUs, transferred between a TPF 4.1 system and channel-to-channel (CTC), adjacent link station (ALS), and Network Control Program (NCP) resources. Each time the TPF 4.1 system sends or receives a PIU, the transmission header (TH), request/response header (RH), and some or all of the request/response unit (RU) associated with that PIU are stored in the PIU trace table when the PIU trace facility is active.
The following enhancements were made to the PIU trace facility for the TPF 4.1 system:
You can use the ZNTRP command to activate and deactivate the PIU trace facility, and to specify which resources to trace. For example, you can trace the PIUs being transferred between a TPF system and all SNA resources a subset of SNA resources, or a single SNA resource. You must first specify a resource name and you can further qualify with a network ID or the name of the NCP, ALS, or CTC that the resource is using. You can also trace only the network control commands, virtual route (VR) pacing requests, and VR pacing responses for NCPs or CTCs.
You can now define the size of the PIU trace table and the length of the entries stored in the PIU trace table. To define the size of the PIU trace table, use the TRACSZ parameter in the SNAKEY macro. To define the length of the entries in the PIU table, use the ZNTRP command.
You can use the ZNTRP command to automatically write each 4 KB block of the PIU trace table to the real-time tape once the 4 KB block is full. If the length of the queue to real-time tape exceeds 20, the PIU trace facility stops writing the PIU trace table to tape until the queue becomes smaller.
You can use the ZNPIU command to view one of three formatted displays. The three displays are:
See TPF Operations for more information about the ZNPIU command and an example of these displays.