gsk_get_update

Gets the database update code.

Format

   #include <gskcms.h>

   gsk_status gsk_get_update_code ( 
                                    gsk_handle           db_handle,  
                                    gsk_uint32 *         update_code)

Parameters

db_handle: Specifies the database handle returned by the gsk_create_database() routine, the gsk_open_database() routine, or the gsk_open_keyring() routine.
update_code: Returns the current update code for the database.

Results

The function return value will be 0 if no error is detected. Otherwise, it will be one of the return codes listed in the gskcms.h include file. These are some possible errors:

[CMSERR_BAD_HANDLE]: The database handle is not valid.
[CMSERR_NO_MEMORY]: Insufficient storage is available.

Usage

The gsk_get_update_code() routine returns the current update code for the database. For a file-based database or z/OS® PKCS #11 token, this is the modification timestamp. For a SAF key ring, this is the ring sequence number. If an update has occurred, the application can close and then re-open the database to pick up the updates.