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.
// 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.