IBM Enterprise Records, Version 5.1.+            

Relocate

The Relocate operation enables you to move the contents and metadata of a container object to a different location in the file plan hierarchy. You can relocate only a record category or record folder within a file plan. In addition, when a record category or a record folder is relocated, all the record categories, record folders, volumes, and records under that record category or record folder are also moved to the specified destination. When relocating a record category or a record folder, you should keep the following points in mind:
  • You can relocate a record category only to a category that does not have any record folders under it and vice versa, because you cannot have a record category and a record folder at the same level in the hierarchy.
  • You cannot relocate a record folder under another record folder, because you cannot create a record folder within a record folder.
  • You cannot relocate a record folder under the classification scheme, record folders can exist only under record categories and not directly under the classification scheme.
  • The destination container should be open and active to allow relocation to this container. However, the source object can be inactive or closed.
  • You cannot relocate container objects across file plans.
To relocate a record category or record folder, call the move method on a RecordCategory or RecordFolder object, respectively. You must specify the destination where the object will be relocated and the reason for the relocation. The following code snippet relocates a record folder from its parent container to a destination container.
//Relocates a RecordFolder object
public void move(RecordFolder aoRF, RMFolder aoDestination,
   String asReason, DispositionSchedule aoDS)
{
   aoRF.move(aoDestination, asReason, aoDS);
}

For information about simultaneously relocating multiple objects, refer to Performing bulk operations.



Feedback

Last updated: August 2011


© Copyright IBM Corporation 2011.
This information center is powered by Eclipse technology. (http://www.eclipse.org)