Isode ATN Directory Service Client API

ATN Directory Service Client Library API Specification

Version 1.0

(c) 2005-2006, Isode Limited, London, England.

Introduction

This document is a specification of the Isode ATN Directory Service Library API.

Note that this API requires and operates in conjunction with the Isode Simple Directory Service Library API, which is documented separately.

The ATNDS (Aeronautical Telecommunications Network Directory Service) API contains utility functions to:

  • Convert AFTN addresses to the corresponding AMHS address. See ATNds_AFTN2AMHS().
  • Convert AMHS addresses to the corresponding AFTN address. See ATNds_AMHS2AFTN().
  • Get the AMHS terminal directory entry name associated with AFTN or AMHS addresses.

The ATN DS API works in conjunction with the DSAPI and simple directory operations (bind, read an entry, etc.) are performed using this.

Using ATNDS

The API works in conjunction with DSAPI. As such, clients will need to use DSAPI functions to bind and unbind from the directory and perform any necessary additional queries (for example reading the entry of an AMHS terminal in order to determine its capabilities). The session handle returned from the bind functions is necessary for calls to ATNDS API functions.

Example

This example converts between AFTN (both XF and CAAS style) and AMHS addresses, and prints the results out to the console. The example shows how DSAPI is used to establish a connection to the directory.

Please send any comments on the API to support@isode.com

Copyright © 2008 Isode privacy   feedback Subscribe to our rss newsfeed