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
- How to build an XBSA application
- 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
NetBackup XBSA environment
The NetBackup XBSA environment is created when an XBSA application calls BSAInit() to initiate a session. This environment only exists between the NetBackup XBSA interface and the XBSA application. The XBSA environment variables are used to pass specific NetBackup information in both directions between the XBSA application and the NetBackup XBSA interface. The environment variables are generally set or modified by the XBSA application, but the NetBackup XBSA interface creates and modifies some variables to pass information back to the XBSA application. Setting platform environment variables (getenv or setenv) has no effect on the NetBackup XBSA environment.
There are restrictions when some of the variables can be set or modified. Most of them can be set on the call to BSAInit(), which initiates a session. Some can also be modified within a session but outside of a transaction. And a few can be modified within a transaction. These limitations are outlined in the following descriptions for each of the variables.
Each XBSA environment variable is defined as a keyword that is followed by an "=" and followed by a null-terminated value. No spaces are allowed around the "=". "BSA_API_VERSION=1.1.0" is valid while "BSA_API_VERSION = 1.1.0" is not.
The functions used to create, modify, and view these environment variables are:
BSAInit()
BSAGetEnvironment()
NBBSAUpdateEnv()
NBBSASetEnv()
NBBSAGetEnv()