async
Issue an asynchronous request
Index > Books > Declarative Development Guide > Reference Library > Accessor Listing > async

Rate this page:
Really useful
Satisfactory
Not helpful
Confusing
Incorrect
Unsure
Extra comments:


Module

urn:org:ten60:netkernel:ext:sys

Definition

Active URI Base

active:async

Format

<instr>
  <type>async</type>
  <uri>active:log</uri>
  <operand>
    <message>I'm logged</message>
  </operand>
  <target>var:requestHandle</target>
</instr>

Syntax

ArgumentRulesDescription
typeMandatory async
uriMandatory the base URI of the request to issue asynchronously
additionOptional any addition arguments will be passed through to the subrequest
targetOptional a handle which may be passed to the join accessor

This accessor is useful when developing in DPML- it allows you to issue asynchronous requests. If you are developing an accessor or using a scriping language you may find it easier to use the underlying asynchronous request methods in the NKF API.

The request that is issued is based upon the URI supplied in the uri argument. Additional arguments can be passed by placing them onto the async request.

The resulting resource returned by this request is not the result of the subrequest- this may not be available yet. It is a handle which can be passed to the join accessor if you want to wait for the result.

© 2003-2005, 1060 Research Limited. 1060 registered trademark, NetKernel trademark of 1060 Research Limited.