IBM Enterprise Records, Version 5.1.+            

Close/Reopen

The Close operation closes the state of a container object to prevent the addition of child objects. For example, if a RecordFolder object is closed, you cannot add records to this object. At the time of creation, the state of a container object is open. In the open state, you can add child objects to container objects.

You can close an object using the ClosableObject interface, which defines the behavior of any container object that can be closed or reopened. To close a ClosableObject object, you call the Close method on a ClosableObject object. You must specify a reason for closing an object. The following code fragment closes a RecordCategory object using the Close method.
//Closes a RecordCategory object
public void close(ClosableObject aoObj, String asReasonForClose)
{
   aoObj.close(asReasonForClose);
}
Note: If a parent object is closed, all the child objects within the parent object are also closed. For example, if you close a RecordCategory object, all the RecordFolder and Volume objects created within the record category are also closed.

Once an object is closed, you cannot add any child object to it. To add child objects to a closed object, you need to reopen the closed object using the reOpen method in the ClosableObject interface. However, the state of the object does not change, that is, the state remains closed. For example, if a closed volume is reopened, the close date for the volume will not change.

Note: Even if a closed parent object is reopened, all the child objects within the parent object remain closed.

For information about simultaneously closing 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)