Documentation

Establishes a connection to the Tile Set Manager.

tsmOpen opens a TSM session handle and must be the first call to the Tile Set Manager. N.B. this function is part of the old style server-centric interface to tsmApi. You should really start using the new leaner, cleaner, and sexier connection-based interface (see tsmConnect). This function is now just an emulation layer on top of the relevant connection-based function(s).

The dbUrl is the "base" location of the Pyramid databases. That is, unless over-ridden explicitly by a call to tsmLoadPyramidDatabase, the Pyramid database is expected to be in dbUrl/Pyramid.

If dbUrl is NULL or an empty string then you must explicitly call tsmLoadPyramidDatabase with a fully specified database URL in order to use names in the calls to tsmGet...Pyramid. (This lets you use different locations for the Pyramid databases). If you don't explicitly call the tsmLoad...Database functions, then you will only be able to access tile sets by URL.

Upon success, tsmOpen returns a "Tile Set Manager Session Handle". All further calls to the Manager require this handle.

NOTES:

o Your program may have more than one TSM session open at the same time (The DSM and ISS now allow multiple seesions.)

o The database specified by the URL is not actually opened until a call to a function requiring the database contents (like getPyramid) is actually made . In particular, the DSM is not contacted until then.

Valid database URLs are of the form:

• file://localhost/path/a/b/ where /path/a/b is the local directory containing the pyramidUrls file

  Paths beginning with "~", like "~foobar" are translated to "/homedir/foobar/public_html".

• x-dsm://hostname/
• http:://hostname/path/a/b/