Tivoli Header

Tivoli Storage Manager Using the Application Program Interface

dsmQueryApiVersion

The dsmQueryApiVersion function call performs a query request for the API library version that the application client accesses.

All updates to the API are made in an upward-compatible format. Any application client with an API version or release less than, or equal to, the API library on the end user's workstation operates without change. Be aware before you proceed that should the dsmQueryApiVersion call return a version or version release older than that of the application clients, some API calls might be enhanced in a manner that is not supported by the end user's older version of the API.

The application API version number is stored in the dsmapitd.h header file as constants DSM_API_VERSION, DSM_API_RELEASE, and DSM_API_LEVEL.

Syntax

void dsmQueryApiVersion  (dsmApiVersion *apiVersionP);

Parameters

dsmApiVersion *apiVersionP (O)
This parameter is a pointer to the structure that contains the API library version, release, and level components. For example, if the library is version 1.1.0, then, after returning from the call, the fields of the structure contain the following values:
   dsmApiVersionP->version  = 1
   dsmApiVersionP->release  = 1
   dsmApiVersionP->level    = 0

Return Codes

There are no return codes that are specific to this call.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]