Session example
The following example sets up a session and begins a transaction. It sets up the XBSA environment, a BSA_ObjectOwner structure, and a BSA_SecurityToken. The security token is NULL because the NetBackup XBSA interface does not use this security method. The session is initiated by a BSAInit() call that returns a BSA_Handle. This handle is then used when a transaction begins and for all XBSA function calls within the session. Within the session, the XBSA environment is modified to change the NBBSA_CLIENT_HOST. Lastly a transaction is started.
BSA_Handle BsaHandle;
BSA_Obje ctOwner BsaObjectOwner;
BSA_SecurityToken *security_tokenPtr;
BSA_UInt32 Size;
char *envx[3];
char ErrorString[512];
char msg[1024];
int status;
/ * Allocate memory for the XBSA environment variable array. */
envx[0] = malloc(40);
envx[1] = malloc(40);
/ * Populate the XBSA environment variables for this session.
* Normally the BSA_SERVICE_HOST would not be hard coded like this but
* would be retrieved via a parameter or environment variable.
*/
strcpy(envx[0], "BSA_API_VERSION=1.1.0");
strcpy(envx[1], "BSA_SERVICE_HOST=server_host");
envx[2] = NULL;
/ * The NetBackup XBSA Interface does not use the security token. */
security_tokenPtr = NULL;
/ * Populate the object owner structure. */
strcpy(BsaObjectOwner.bsa_ObjectOwner,"XBSA Client");
strcpy(BsaObjectOwner.app_ObjectOwner,"XBSA App");
/ * Initialize an XBSA session. */
status = BSAInit(&BsaHandle,NULL,&BsaObjectOwner,envx);
if (status != BSA_RC_SUCCESS) {
Size = 512;
NBBSAGetErrorString(status, &Size, ErrString);
printf("ERROR: BSAInit failed with error: %s\n", ErrString);
exit(status);
}
/ * Set the hostname of the client for the next transaction. */
NBBSASetEnv(BsaHandle, "NBBSA_CLIENT_HOST", "client_host");
/ * Begin a transaction. If it fails, terminate the session. */
status = BSABeginTxn(BsaHandle);
if (status != BSA_RC_SUCCESS) {
Size = 512;
NBBSAGetErrorString(status, &Size, ErrorString);
sprintf(msg, "ERROR: BSABeginTxn failed with error: %s",
ErrorString);
NBBSALogMsg(BsaHandle, MSERROR, msg, "Backup");
BSATerminate(BsaHandle);
exit(status);
}