IBM Enterprise Records, Version 5.1.+            

Moving a record

You can use the RM Java™ API to relocate a RecordInfo object from one location to another within the same file plan. When a record is moved to a new location, its associated metadata is also moved. An additional field that specifies the reason for moving the RecordInfo object is appended to the existing metadata fields of the moved RecordInfo object.

Note: Only the System Administrator and Records Manager are authorized to move a record.
To move a RecordInfo object, call the move method on the RecordInfo object. This method moves this RecordInfo object from its current parent container entity to the destination container entity. The parameters of this method specify the source and destination container entities, and the reason for moving the record. The following code snippet presents a scenario where a RecordInfo object is moved from the source to the destination record container.
// Moves a RecordInfo object from the source to the destination container, for the reason 
// provided in the method
loRecordInfo.move (loSourceContainer, loDestinationContainer, lsReasonToMove);

A precondition for moving the RecordInfo object is that the destination record folder, record category, or volume should already exist. In addition, the destination container should be able to hold the RecordInfo object that is to be moved.



Feedback

Last updated: August 2011


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