TRRT entry for subtrace tree (Part 1)
- Entry:
- TRRT
- VIT option:
- SSCP
- Subtrace type:
- TREE
- Event:
- APPN route computation
- VIT processing module:
- ISTITCAB
- Control is returned to:
- Module invoking the INTRACE TYPE(TRRT) macro.
This record is generated when:
- Subtrace TREE under SSCP trace option is active
- TRS accesses a routing tree to satisfy a request for an APPN route
- Byte (hex)
- Contents
- 00–03
- Record ID: C"TRRT"
- 04
- ID is the primary address space ID (ASID). This field is 0 if the ASID is greater than X'FF'.
- 05
- 0
- 06
- Trace entry instance
- 07
- Status on tree record for current node:
- Code
- Meaning
- C"C"
- Tree record is clean, no changes on this tree record.
- C"I"
- Tree record is incomplete, a change was detected on a descendant of this tree record but the tree has not been updated.
- C"D"
- Tree record is dirty, a change was detected on this tree record but the tree has not been updated.
- 08–0B
- Node record pointer of the node described by the current tree record
- 0C–0F
- Node record pointer of the node described by the child tree record
- 10–13
- Node record pointer of the node described by the sibling tree record
- 14–17
- Node record pointer of the node described by the parent tree record
- 18–19
- Weight of the TG from parent node to this node
- 1A–1B
- Weight of the current node
- 1C–1F
- Request parameter header (RPH) address
Note: An APPN route is comprised of TGs and network nodes.
To compute the optimal route, TRS assigns a weight to each TG and
network node by comparing the resource's characteristics against the
characteristics required to set up the route. By adding up all weights,
a route weight can be calculated and the optimal route with the least
weight can be chosen.
TRRT entry for subtrace tree (Part 2)
- Entry:
- TRR2
- VIT option:
- SSCP
- Subtrace type:
- TREE
- Event:
- APPN route computation
- VIT processing module:
- ISTITCAB
This record is a continuation of the TRRT trace record.
- Byte (hex)
- Contents
- 00–03
- Record ID: C"TRR2"
- 04–05
- Total path weight from the root of routing tree to the current node
- 06
- Trace entry instance
- 07
- 0
- 08–0F
- CP name of the current node
- 10–17
- CP name of the child node
- 18–1F
- CP name of the sibling node
TRRT entry for subtrace tree (Part 3)
- Entry:
- TRR3
- VIT option:
- SSCP
- Subtrace type:
- TREE
- Event:
- APPN route computation
- VIT processing module:
- ISTITCAB
This record is a continuation of the TRR2 trace record. TRR3 is generated only if any CP names in the TRR2 record have a different network ID than the local node.
- Byte (hex)
- Contents
- 00–03
- Record ID: C"TRR3"
- 04–07
- 0
- 08–0F
- Current node network ID
- 10–17
- Parent node network ID
- 18–1F
- Sibling node network ID
TRRT entry for subtrace tree (Part 4)
- Entry:
- TRR4
- VIT option:
- SSCP
- Subtrace type:
- TREE
- Event:
- APPN route computation
- VIT processing module:
- ISTITCAB
This record is generated if the current routing tree hop (tree record) described by the TRRR and TRR2 pair contains any TGs. If the current hop contains multiple equal-weights TGs, TRR4 is generated for each TG on the hop.
- Byte (hex)
- Contents
- 00–03
- Record ID: C"TRR4"
- 04–05
- 0
- 06
- Trace entry instance
- 07
- 0
- 08–0F
- CP name of the TG destination node
- 10–13
- Resource sequence number
- 14–15
- RSCV counter
- 16–17
- Resource usage counter
- 18
- TG number
- 19
- TG descriptor flags
- 1A
- TG status flags
- 1B
- 0
- 1C–1F
- TG record pointer
TRRT entry for subtrace tree (Part 5)
- Entry:
- TRR5
- VIT option:
- SSCP
- Subtrace type:
- TREE
- Event:
- APPN route computation
- VIT processing module:
- ISTITCAB
This record is a continuation of the TRR4 trace record. TRR5 is generated only if the destination CP name in the TRR4 record has a different network ID than the local node.
- Byte (hex)
- Contents
- 00–03
- Record ID: C"TRR5"
- 04–07
- 0
- 08–0F
- Destination node network ID
- 10–1F
- 0
Note:
- The group TRRT, TRR2, TRR3, TRR4, and TRR5 describes a single hop (represented by a tree record) on a routing tree. If the hop contains multiple equal-weight TGs, multiple TRR4 trace records are generated (one for each TG on that hop).
- When a routing tree is accessed to satisfy a route request and the TREE subtrace is active, the whole routing tree will be traced. Each hop (tree record) on the tree will generate the group TRRT, TRR2, TRR3, TRR4, and TRR5. The processing module ISITCAB is called when the INTRACE TYPE (TRRT) is issued. ISTITCAB will traverse the routing tree to trace every tree record on the tree.
- After every tree record on the tree has been traced, control will be returned to the module that invoked the INTRACE macro.