<instr>
  <type>trace</type>
  <operand>index.html</operand>
  <operator>
    <trace>
      <module>urn:mymodule</module>
      <inheritSuper />
    </trace>
  </operator>
  <target>var:result</target>
</instr>

Syntax

Element	Rules	Description
type	Mandatory	trace
operand	Mandatory	the URI of a resource to trace resolution of.
operator	Optional	override default behaviour
target	Mandatory	the result document

Description

Used to perform a resource resolution and report the resolution process. It is useful to find out what is happening when a resource isn't being resolved as expected or when it is not being resolved at all. The result is a line by line listing of the steps taken in resolving the resource until eventual success of failure.

Operator

The operator can optionally contain two elements:

module specify a module to start resolution at. If not specified the module that called the trace instruction is used.
inheritSuper if specified then the super stack of the request to the instruction is used allowing searching of any parent modules in context. The request is considered an internal request to the module and is not rewritten. If inheritSuper is not specified the starting location is treated as a fulcrum and the operator URI is rewritten as it enters the module.

1060 registered trademark, NetKernel trademark of 1060 Research Limited