Bourne and Korn shell scripts API

Developer's Topics
Chapter 12, Custom Distribution Mastering Toolkit

The Bourne and Korn shell script API is similar to the ``Tcl scripts API'', except that it depends upon the ssoPathMap(CDMT) utility program, instead of a built-in shell function.

Include a patch area definition in the shell script using the API. For example:

   # patch area definition
   id="_SSO_ID_ST@vendorCode:componentCode:version     @SSO_ID_END_"
   
   ssoPathMap [-f relPath] [ -s segmentId] -i ssoIdObject

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 ssoPathMap utility is used to interpret the patch area. If you omit the -f relPath argument, ssoPathMap returns the path to the root of the SSO (SSOroot).