HP Open Source Security for OpenVMS Volume 1: Common Data Security ArchitectureCDSA API Functions
This reference section contains descriptions of the CDSA API functions. These descriptions are also available from online help. To access help, enter the HELP CDSA command at the system prompt. The MDSUTIL API functions are a special group of functions described in the following paragraphs. MDS Utility Library API FunctionsAlthough the MDS API is a required part of any CDSA implementation, the MDSUTIL functions are not. This library of functions was provided with the Intel CDSA reference implementation to encapsulate many common queries that applications typically make to MDS. CDSA on OpenVMS implements the Intel CDSA version of the MDS utility library. Other vendors may supply their own utility libraries built on top of MDS. To use the MDS utility library, you must include two header files, MDS_UTIL_API.H and MDS_UTIL_HELPER.H, which are in the CDSA_SYDIR:[INCLUDES] directory. You must also link with the library files CDSA$MDS300_SHR.EXE and CDSA$MDS_UTIL_API.OLB, which are located in SYS$SHARE. The MDS example program provides two special routines for deciphering CDSA error codes within a user program. Because the CDSA include file that specifies error codes (CDSA_SYSDIR:[INCLUDES] CSSMERR.H) does not allow for easy translation from the numeric code to the associated error string, these routines can make the job of debugging a CDSA application easier. These routines are Decode_CDSA_Error and Print_CDSA_Error. For further information, see the Intel Common Data Security Architecture Application Developer's Guide, Chapter 2 (Module Directory Services), under the heading MDS Utility Library. Table of Contents
|