trace

Home > Books > NetKernel API and Services Reference > Accessor Listing > Kernel Management and Development APIs > trace

Module

The trace accessor is exported by the urn:org:ten60:netkernel:ext:kernel module. Import this module to gain access to the accessor.

Syntax

URI

active:trace

Argument	Rules	Description
operand	Mandatory	the URI of a resource to trace resolution of.
operator	Optional	override default behaviour

Example Usage

DPML

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

NetKernel Foundation API

req=context.createSubRequest("active:trace");
req.addArgument("operand", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

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.