Using the data storage library services module

After you complete the installation steps described in Installing the OCEP code, the following OCEP Data Storage Library service provider files are available for use on your system.

Function	Name	Directory Location
Header File	ibmocepdl.h	`/user/lpp/ocsf/include`
Executable Module	ibmocepdl.so	`/user/lpp/ocsf/addins`

To use the OCEP Data Storage Library Services, an application must explicitly attach this service provider module. To do so, the application must use CSSM_ModuleAttach, which is an API provided by OCSF, to attach the specific GUID for the service provider module. In turn, CSSM_ModuleAttach returns a handle that uniquely represents the pairing of the OCEP service provider module and the calling application.

The following GUID identifies the OCEP Data Storage Library service provider module; this GUID and other related constants are defined in the ibmocepdl.h header file:

// {5E43B2A3-1C38-11d2-8688-0004ACF320BC}
static const CSSM_GUID IBMOCEPDL_GUID =
{ 0x5e43b2a3, 0x1c38, 0x11d2, { 0x86, 0x88, 0x0, 0x4, 0xac, 0xf3, 0x20, 0xbc } };

For more information about the CSSM_ModuleAttach function and developing security applications, see the z/OS Open Cryptographic Services Facility Application Programming.