Integration Toolbox
for IBM® TIVOLI® Storage Manager

package archive_retrieve; import hu.user.toolbox.tsm.IArchiveObject; 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.IArchiveQuery; import java.util.ArrayList; import java.util.List; /** * <b>Function:</b><br> * Deletes all archived objects from the server. * <p> * Before executing this program send some objects to the server using * the ArchiveSingleObject, ArchiveSingleObjectManagementClassOverride or * ArchiveMultipleObjects sample. * <p> * The following operations are performed: * <ol> * <li>Initializing a single-threaded TSM API environment.</li> * <li>Creating a new TSMSession instance with the default connection options. * Connecting to the server using * the node name "TOOLBOX" and password "PASSWORD".</li> * <li>Retrieving the filespace named "/ARCHIVEFS"</li> * <li>Querying archive bjects with the parameters: * high-level name "/ARCHIVE", low-level name "/* and object type "ANY_TYPE".</li> * <li>Iterating through the returned ResultSet, adding each object * to the list, then closing the result set.</li> * <li>Deleting each archive object from the list.</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 archive_retrieve/DeleteArchiveObjects.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 archive_retrieve.DeleteArchiveObjects * </pre> */ public class DeleteArchiveObjects { private static final String NODE_NAME = "TOOLBOX"; private static final String PASSWORD = "PASSWORD"; private static final String LOW_LEVEL_NAME = "/*"; private static final String HIGH_LEVEL_NAME = "/ARCHIVE"; private static final String FILESPACE_NAME = "/ARCHIVEFS"; public static void main(final String args[]) throws 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; } IArchiveQuery archiveQuery = filespace.createArchiveQuery(); IResultSet archives = null; List<IArchiveObject> archiveObjects = null; boolean hasObjects = false; try { // Querying all archive objects of the filespace matching the specified criteria archives = archiveQuery .highLevelNameMatches(HIGH_LEVEL_NAME) .lowLevelNameMatches(LOW_LEVEL_NAME) .ownerMatchesAny() // Matches any owner name .descriptionMatchesAny() // Matches any description .filesAndDirectories() // Query for both files and directories .execute(); // Execute the query archiveObjects = new ArrayList<IArchiveObject>(); // Iterating over the returned result set while (archives.next()) { hasObjects = true; archiveObjects.add((IArchiveObject) archives.get()); } if (!hasObjects) { System.out.printf("The filespace '%s' does not contain any archive objects.\n", FILESPACE_NAME); } } catch (Exception e) { e.printStackTrace(); }finally{ // Result set must be closed. archives.close(); } // Beginning a transaction session.beginTransaction(); try { for (IArchiveObject archive : archiveObjects) { // Deleting archive object archive.delete(); System.out.printf("The archive %s%s%s has been deleted.\n", archive.getFilespaceName(), archive.getHighLevelName(), archive.getLowLevelName()); } session.commit(); } catch(ToolboxException e) { // Rolling back the current transaction session.rollback(); } } catch (ToolboxException e) { e.printStackTrace(); } finally { // Disconnecting session.disconnect(); // Cleaning up the environment Toolbox.cleanUp(); } } }