gsk_get_cms_vector()

Obtains the address of the Certificate Management Services function vector.

Format

   #include <gskcms.h>

   void gsk_get_cms_vector (
                            gsk_uint32 *                 function_mask,
                            gsk_cms_vector **            function_vector)

Parameters

function_mask: Returns a bit mask indicating the Certificate Management Services level.
function_vector: Returns the address of the Certificate Management Services function vector.

Usage

Certificate Management Services (CMS) functions can be called using either static binding or runtime binding. Static binding is performed when the application is compiled while runtime binding is performed when the application is run.

In order to use static binding, the CMS sidefile is specified as input to the binder. This causes all CMS functions to be resolved at bind time and will cause the CMS DLL to be implicitly loaded when the application is run.

In order to use runtime binding, the CMS DLL must be explicitly loaded by the application and the CMS functions must be called using indirect addresses. The gsk_get_cms_vector() routine allows an application to obtain the address of the CMS function vector containing an entry for each CMS API routine. This eliminates the need for the application to build the function vector through repeated calls to the dllqueryfn() routine.

The function mask indicates the capabilities of the version of the CMS DLL. These values have been defined:

GSKCMS_API_LVL1: CMS functions provided as part of z/OS® Version 1 Release 4 are available.
GSKCMS_API_LVL2: CMS functions provided as part of z/OS Version 1 Release 6 are available.
GSKCMS_API_LVL3: CMS functions provided as part of z/OS Version 1 Release 8 are available.
GSKCMS_API_LVL4: CMS functions provided as part of z/OS Version 1 Release 9 are available.
GSKCMS_API_LVL5: CMS functions provided as part of z/OS Version 1 Release 10 are available.
GSKCMS_API_LVL6: CMS functions provided as part of z/OS Version 1 Release 11 are available.
GSKCMS_API_LVL7: CMS functions provided as part of z/OS Version 1 Release 12 are available.
GSKCMS_API_LVL8: CMS functions provided as part of z/OS Version 1 Release 13 are available.
GSKCMS_API_LVL9: CMS functions provided as part of z/OS Version 2 Release 1 are available.