Tivoli Header

Tivoli Storage Manager Using the Application Program Interface

Perform a Partial Object Restore or Retrieve

The application client can receive only a portion of the object. This is called a partial object restore or a partial object retrieve.

Note:
If your application plans to use a partial object restore or retrieve, you cannot compress the data while sending it. To enforce this, set ObjAttr.objCompressed to bTrue.

To perform a partial object restore or retrieve, associate the following two data fields with each object GetList entry:

offset
The byte offset into the object from which to begin returning data.

length
The number of object bytes to return.

Use DSM_MAX_PARTIAL_GET_OBJ to determine the maximum number of objects that can perform a partial object restore or retrieve for a specific dsmBeginGetData list.

The following data fields, used on the dsmBeginGetData call, determine what portion of the object is restored or retrieved:


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]