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
Query about the XBSA object copies.
int BSAQueryObject(BSA_Handle bsaHandle, BSA_QueryDescriptor *queryDescriptorPtr,
The BSAQueryObject() call initiates a request for information on NetBackup XBSA object copies from the NetBackup XBSA interface. The results of the query are determined by the search conditions specified in the query descriptor. The XBSA object descriptor for the first XBSA object satisfying the query search conditions is returned in the BSA_ObjectDescriptor (referenced by the objectDescriptorPtr parameter). The application can obtain the other XBSA object descriptors found by the query by successive calls to BSAGetNextQueryObject().
BSA_Handle bsaHandle (I)
This parameter is the handle that associates this call with a previous BSAInit() call.
BSA_QueryDescriptor *queryDescriptorPtr (I)
This parameter is a pointer to a structure that contains the search conditions for the query.
BSA_ObjectDescriptor *objectDescriptorPtr (O)
This parameter is a pointer to a structure that is used to return the XBSA object descriptor for the first XBSA object that satisfies the search condition specified in the query.
This function may only be used as part of a retrieval transaction.
A limited wildcard capability is available as follows:
"*" matches 0 or more characters "?" matches exactly one character "\*" matches a literal "*" "\?" matches a literal "?" "\\" matches a literal "\"
String matching is performed without any interpretation of the string contents. There is no implied knowledge of the structure of the string contents.
Zero value = any time
ANY value matches any value
Defaults to value specified at session initialization
The following examples illustrate wildcard string matching:
BSA_ObjectName.pathName = /server/*
Matches all NetBackup XBSA objects for this server
BSA_ObjectName.pathName = /server/rootdbs/*
Matches all levels of rootdbs
BSA_ObjectName.pathName = /server/????
Matches all levels whose name is exactly four characters long
The following return codes are returned by this function:
System detected error, operation aborted.
Access to the requested NetBackup XBSA object descriptor is not permitted.
The sequence of API calls is incorrect.
The handle used to associate this call with a previous BSAInit() call is invalid.
The BSA_QueryDescriptor was invalid.
No NetBackup XBSA objects matched the given query.
A NULL pointer was encountered in one of the arguments.
The function succeeded.