Starting the dsmBeginGetData call
After you select and sort the objects to receive, submit them to IBM® Storage Protect for either a restore or retrieve operation. The dsmBeginGetData call begins a restore or retrieve operation. The objects are returned to the application client in the order you requested.
Complete the information for these two parameters in these calls:
- mountWait
- This parameter tells the server whether the application client waits for offline media to be mounted in order to obtain data for an object, or whether that object should be skipped during processing of the restore or retrieve operation.
- dsmGetObjListP
- This parameter is a data structure that contains the objId field
which is a list of all object IDs that are restored or retrieved.
Each objId is associated with a partialObjData structure
that describes whether the entire objId or
only a particular section of the object will be retrieved.
Each objId is eight bytes in length, so a single restore or retrieve request can contain thousands of objects. The number of objects to request in a single call is limited to DSM_MAX_GET_OBJ or DSM_MAX_PARTIAL_GET_OBJ.