Custom Distribution Mastering Toolkit

Tcl scripts API

The SSO Path Mapping API functionality is built into the Tcl interpreter.

To use path mapping with Tcl scripts, include a patch area definition in the script. For example:

# Patch area definition

set lclPatchArea {_SSO_ID_ST@vendorCode:componentCode:version	@SSO_ID_END_}

proc SSO_GetSegmentRootPath [SHARED | CLIENT] $lclPatchArea

The patch area definition must appear in the actual script being patched (not in a library). The string between the ``@'' symbols can be any length, but in practice should be no shorter than 35 characters. Set vendorCode, componentCode, and version to initial defaults, similar to the fields in the SSO_ALLOC_ID_OBJECT macro in the ``C and C++ programs API''.

The Tcl SSO_GetSegmentRootPath function returns an absolute path to the root of the SSO (SSOroot). Use the SHARED keyword for the read-only (/opt) SSO and CLIENT for the read-write (/var/opt) SSO.