NetBackup™ DataStore SDK Programmer's Guide for XBSA 1.1.0

BSA_ObjectName

The BSA_ObjectName structure is the name assigned by an XBSA application to a NetBackup XBSA object. It is defined as follows:

typedef struct {
    char  objectSpaceName[BSA_MAX_OBJECTSPACENAME];
    char  pathName[BSA_MAX_PATHNAME];
} BSA_ObjectName;

The usage of the structure fields is defined as follows:

An objectSpaceName is an optionally defined, fixed-length character string. It identifies a logical space, called an object space, to which the object belongs. For example, an object space may be used to identify a storage volume (for example, a disk partition, or a floppy disk), or a database in the XBSA application's domain.

The NetBackup XBSA interface uses the concept of an object space to provide a primary grouping of NetBackup XBSA objects that can be used for an object search by a user and/or for object management. Additional groupings are provided by object attributes. Examples of an objectSpaceName are C: Drive and VolumeLabel=XYZ.

A pathName is a hierarchical character string that identifies a NetBackup XBSA object within an ObjectSpace. While the pathname does not need to correspond to an actual file path, NetBackup requires that the first character is a '/'. This is true for both UNIX and Windows.

An example of a pathName for the backup copy of a UNIX file can be its original path name and file name, for example, /x/y/z/xyx.c.

The value of the delimiter that is used to separate the name components can be obtained by calling BSAGetEnvironment().