Security plug-in API versioning

The Db2® database system supports version numbering of the security plug-in APIs. These version numbers are integers starting with 1 for Db2 UDB, Version 8.2.

The version number that Db2 passes to the security plug-in APIs is the highest version number of the API that Db2 can support, and corresponds to the version number of the structure. If the plug-in can support a higher API version, it must return function pointers for the version that Db2 has requested. If the plug-in only supports a lower version of the API, the plug-in should specify the function pointers for the lower version. In either situation, the security plug-in APIs should return the version number for the API it is supporting in the version field of the functions structure.

For Db2, the version numbers of the security plug-ins will only change when necessary (for example, when there are changes to the parameters of the APIs). Version numbers will not automatically change with Db2 release numbers.