NetBackup™ DataStore SDK Programmer's Guide for XBSA 1.1.0
- Introduction to NetBackup XBSA
- How to set up the SDK
- Using the NetBackup XBSA interface
- Getting help with the API
- NetBackup XBSA data structures
- NetBackup XBSA environment
- XBSA sessions and transactions
- Creating a NetBackup XBSA application
- How to build an XBSA application
- How to run a NetBackup XBSA application
- API reference
- Error messages
- Function calls
- Function specifications
- BSABeginTxn
- BSACreateObject
- BSADeleteObject
- BSAEndData
- BSAEndTxn
- BSAGetData
- BSAGetEnvironment
- BSAGetLastError
- BSAGetNextQueryObject
- BSAGetObject
- BSAInit
- BSAQueryApiVersion
- BSAQueryObject
- BSAQueryServiceProvider
- BSASendData
- BSATerminate
- NBBSAAddToMultiObjectRestoreList
- NBBSADeleteImage
- NBBSAEndGetMultipleObjects
- NBBSAFreeJobInfo
- NBBSAGetEnv
- NBBSAGetErrorString
- NBBSAGetJobId
- NBBSAGetJobInfo
- NBBSAGetMediaIds
- NBBSAGetMultipleObjects
- NBBSAGetServerError
- NBBSALogMsg
- NBBSASetEnv
- NBBSAUpdateEnv
- NBBSAValidateFeatureId
- Type definitions
- Process flow and troubleshooting
- How to use the sample files
- Support and updates
- Appendix A. Register authorized locations
- Index
NBBSAUpdateEnv
Update the current environment for the session.
SYNOPSIS
#include <nbbsa.h>
int NBBSAUpdateEnv(BSA_Handle *bsaHandle, char **envPtr)
DESCRIPTION
NBBSAUpdateEnv() resets the environment pairs in the current environment. It performs the same functionality as NBBSASetEnv() except it takes a string of multiple (keyword, value) pairs. The same restrictions apply to updating some of the restricted variables. If a variable exists in the environment but is not included in the list being updated, it remains in the environment.
The XBSA specifications do not provide a way for these XBSA environment variables to be reset after the session has been initiated with BSAInit().
PARAMETERS
BSA_Handle bsaHandle (I) | The handle that associates this call with a previous BSAInit() call. |
char **envPtr (I) | Pointer to a structure that contains the new environment variables (keyword, value) pairs, for the session. The environment consists of a pointer to an array of strings. |
RETURN VALUE
The following return codes are returned by this function:
BSA_RC_SUCCESS | The specified XBSA environment variable has been set. |