Integration Toolbox
for IBM® TIVOLI® Storage Manager

package backup_restore; import hu.user.toolbox.tsm.IBackupObject; import hu.user.toolbox.tsm.IBackupObjectList; import hu.user.toolbox.tsm.IFilespace; import hu.user.toolbox.tsm.IResultSet; import hu.user.toolbox.tsm.ITSMSession; import hu.user.toolbox.tsm.Toolbox; import hu.user.toolbox.tsm.exception.ToolboxException; import hu.user.toolbox.tsm.query.IBackupQuery; import java.io.FileOutputStream; import java.io.IOException; /** * <b>Function:</b><br> * Restores part of the backed-up object data that was previously * sent to the server using the BackupSingleObject.java example. * <p> * Before executing this program send an object to the server using * the BackupSingleObject sample. * <p> * The following operations are performed: * <ol> * <li>Initializing a single-threaded TSM API environment.</li> * <li>Creating a new TSMSession instance. * Setting default connection options. Connecting to the server using * the node name "TOOLBOX" and password "PASSWORD".</li> * <li>Retrieving the filespace named "/BACKUPFS".</li> * <li>Querying backup objects with parameters: * high-level name "/BACKUP", low-level name "/OBJECT1 and object type "FILE".</li> * <li>Iterating through the returned ResultSet, adding each object * to the restore list, then closing the result set. </li> * <li>Setting the offset and the length of the the first object "/OBJECT1" * then restoring to the folder "results".</li> * <li>Disconnecting from the server and cleaning up the resources.</li> * </ol> * <p> * <b>Compile:</b> * <pre> * javac -d bin -cp ../lib/toolboxfortsm.jar * backup_restore/PartialRestoreSingleObject.java * </pre> * <p> * <b>Execute:</b><br> * You should first set the environment variables to point to the correct * files/directories. * <pre> * set DSMI_CONFIG={Full path of your dsm.opt} * set DSMI_DIR={Tivoli Storage Manager API installation directory} * set DSMI_LOG={Any arbitrary directory} * </pre> * Then use the java command to execute the program: * <p> * <pre> * java -cp bin:../lib/toolboxfortsm.jar:../lib/ext/log4j-1.2.17.jar:../config * -Djava.library.path=../lib backup_restore.PartialRestoreSingleObject * </pre> */ public class PartialRestoreSingleObject { private static final String NODE_NAME = "TOOLBOX"; private static final String PASSWORD = "PASSWORD"; private static final String OUTPUT_FILE_NAME = "results/partialRestored.txt"; private static final String LOW_LEVEL_NAME = "/OBJECT1"; private static final String HIGH_LEVEL_NAME = "/BACKUP"; private static final String FILESPACE_NAME = "/BACKUPFS"; public static void main(final String args[]) throws IOException, ToolboxException { ITSMSession session = null; try { // Initializing a single-threaded environment Toolbox.initSingleThreading(); // Connecting to the server with the default connection options session = Toolbox.createSession(NODE_NAME, PASSWORD); // Retrieving the existing filespace from server IFilespace filespace = session.retrieveFilespace(FILESPACE_NAME); // Checking if filespace exists if (filespace == null) { System.out.printf("Warning: '%s' does not exists.\n", FILESPACE_NAME); return; } IBackupObjectList objectList = session.createBackupObjectList(); IBackupObject currentObject = null; IResultSet backups = null; IBackupQuery backupQuery = filespace.createBackupQuery(); try{ // Querying all backup objects of the filespace matching the specified criteria backups = backupQuery .highLevelNameMatches(HIGH_LEVEL_NAME) .lowLevelNameMatches(LOW_LEVEL_NAME) .ownerMatchesAny() // Matches any owner name .files() // Object type = File .allVersions() // Query both active and inactive versions .execute(); // Execute the query // Iterating over the returned result set while (backups.next()) { currentObject = (IBackupObject) backups.get(); break; } }catch (Exception e) { e.printStackTrace(); }finally{ // The result set must be closed. backups.close(); } // Check if object has been backed up. if (currentObject == null) { System.out.printf("The object '%s%s%s' doesn't exist on the server.\n", FILESPACE_NAME, HIGH_LEVEL_NAME, LOW_LEVEL_NAME); return; } // Restoring 84 bytes beginning at offset 0 currentObject.setPartialOffset(0); currentObject.setPartialLength(84); // Starting the partial restore operation objectList.add(currentObject); objectList.beginPartialRestore(); FileOutputStream out = new FileOutputStream(OUTPUT_FILE_NAME); // Doing the actual restore try { currentObject.restore(out); System.out.printf("The object '%s%s%s' has been restored to file '%s'.\n", FILESPACE_NAME, HIGH_LEVEL_NAME, LOW_LEVEL_NAME, OUTPUT_FILE_NAME); } catch (Exception e) { e.printStackTrace(); } finally{ // The restore operation in each case must be finished objectList.endRestore(); } } catch (ToolboxException e) { e.printStackTrace(); } finally { // Disconnecting session.disconnect(); // Cleaning up the environment Toolbox.cleanUp(); } } }