Veritas 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
- NetBackup XBSA data structures
- NetBackup XBSA environment
- XBSA sessions and transactions
- Creating a NetBackup XBSA application
- Initiating a session
- Backup - creating an object
- Query - finding an object descriptor
- Restore - retrieving an object's data
- Delete - deleting an object or image
- Media IDs - obtaining media IDs
- How to build an XBSA application
- How to run a NetBackup XBSA application
- About How to run a NetBackup XBSA application
- API reference
- Function calls
- Function specifications
- Type definitions
- Process flow and troubleshooting
- How to use the sample files
- Support and updates
- Appendix A. Register authorized locations
Set the value of a single XBSA environment value.
int NBBSASetEnv(BSA_Handle bsaHandle, char *EnvVar, char *EnvVal)
NBBSASetEnv() gives the XBSA application the ability to set the value of a specific XBSA environment variable after the beginning of a session. If the variable does not exist in the environment, it is added. If the variable exists in the environment, the value is replaced. Some of the XBSA environment variables can only be set or updated at certain points in the session. See Environment variable definitions. If the variable cannot be set or updated, the original value remains.
The XBSA specifications do not provide a way for these XBSA environment variables to be reset after the session has been initiated with BSAInit().
BSA_Handle bsaHandle (I)
The handle that associates this call with a previous BSAInit() call.
char *EnvVar (I)
Pointer to a null-terminated string that specifies the XBSA environment variable whose value is being set.
char *EnvVal (I)
Pointer to a null-terminated string containing the new value of the specified XBSA environment variable. If this parameter is NULL, the variable is deleted from the current sessions XBSA environment.
The following return codes are returned by this function:
The specified XBSA environment variable has been set.
A required argument was passed as a NULL pointer.
Unable to increase the size of the session's XBSA environment block.
The variable is not a supported environment variable.