This section describes the following XOpen functions and how to use them
with TSM.
- BSAChangeToken. Only the root session owner, or
TSM-Authorized session owner can run this function.
- BSACreateObject. Multiple CreateObject calls within a
single transaction must be for the same objectspaceName. Tivoli Storage
Manager considers all fields in the ObjectDescriptor to be input
fields and does not alter them.
The ObjectDescriptor.resourceType field is used as the
TSM filespace fsType value, and is also stored in the TSM objInfo area.
The ObjectDescriptor.Owner.bsaObjectOwner value
must match that value that is used on the BSAInit.
The ObjectDescriptor.Owner.appObjectOwner value
must match that which was used on the BSAInit if it was not root
(blank). If BSAInit starts a session with the root owner, then the
object owner can be any value. The following fields from the
ObjectDescriptor are used:
- owner.bsaObjectOwner
- owner.appObjectOwner
- objName.objectSpaceName
- objName.pathName
- copyType
- lGName (management class)
- Size
- resourceType
- objectType ( For backup, this can be FILE, DIRECTORY, DATABASE (which is
treated like FILE). For archive, this can be FILE, or DIRECTORY.
- desc
- objInfo
For CreateObject, TSM has a limit on the number of objects that
can be created in a single transaction. TSM returns the value on the
BSAGetEnvironment call with the TSMMAXOBJ keyword.
- BSADeleteObject. With TSM, this call is only meaningful
for archive objects. For backup objects, use
BSAMarkObjectInactive.
- BSAGetEnvironment. TSM returns the server name and
maximum objects per transaction. See Figure 21 for an example.
- BSAGetObject. The following fields from
objectDescriptor are used:
The object name fields are not used. Preceed the
GetObject call with a QueryObject call to obtain the
copyid value.
- BSAInit. The BSAObjectOwner field is used as
the TSM node name. The AppObjectOwner field is used as the
TSM session owner name.
Tivoli Storage Manager has two modes, prompt or generate, to handle
passwords. For the prompt mode, the node/owner/password values must be
supplied. For the generate mode, the password is saved in a file that
the root or TSM-Authorized user must start. Thereafter,
node/owner/password values should not be passed on the BSAInit. Values
passed on the environmentPtr are ignored.
- BSAQueryObject. The
ObjectDescriptor.Owner.bsaObjectOwner value must
match that which was used on the BSAInit. The
ObjectDescriptor.Owner.appObjectOwner value must
match that which was used on the BSAInit if it was not root
(blank). If BSAInit started a session with the root owner,
then the object owner can be any value.
For copyType Backup, the following fields are used:
- owner.bsaObjectOwner
- owner.appObjectOwner
- objName.objectSpaceName
- objName.pathName
- objectType (DATABASE is treated as FILE)
- status
For Archive, the following fields are used:
- owner.bsaObjectOwner
- owner.appObjectOwner
- objName.objectSpaceName
- objName.pathName
- createTime
- expireTime
- objectType
- desc