IBM Enterprise Records, Version 5.1.+            

Creating a volume

A Volume object represents a logical subdivision of a record folder into a smaller, more easily-managed unit. A Volume object has no existence independent of the record folder. A record folder always contains at least one volume. However, you can create multiple volumes in a record folder. When a record folder is created, the first volume is automatically created by default. The first volume remains open unless a second volume is created. When the second volume is created, the first volume is closed and the second volume remains open.

Note: In a file plan, only one volume can be open at any given time and all other volumes must be closed. By default, the most recently created volume is open.

The name of a volume consists of a prefix and a suffix separated by a hyphen (-). The prefix is the parent record folder name, and the suffix is an incremental number, which is configured as VolumePatternSuffix in the system configuration. For example, if the record folder name is RF1 and the VolumePatternSuffix value is set as 0000, the volume name will be RF1-0001. However, a volume cannot be categorized as physical, electronic, or hybrid. The type of the volume is determined by the type of its parent record folder.

To create a Volume object, call the addVolume method on a RecordFolder object. You must pass in the Properties and Permissions collections. The following code fragment illustrates the creation of a Volume object using the addVolume method:
//Creates a Volume object 
public void createVolume(String asName, Properties aoProps, Permissions aoACLs, 
   RecordFolder aoParentRF)
{
   Volume loVol = aoParentRF.addVolume(aoProps, aoACLs); 
}

Retrieving Volume objects

You can retrieve Volume objects in the following ways:



Feedback

Last updated: August 2011


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