CL Command Reference - DUPMEDBRM
CL Command List > DUPMEDBRM Reference
Description:
The Duplicate Media using BRM (DUPMEDBRM) command copies the contents of a single volume, a single volume in a media set, media set, or set of marked saved items to other volumes. You can specify the volumes which are to be duplicated, or specify a search be performed to identify the volumes or saved items which are to be duplicated. You can also resume a previous duplication operation which ended with errors.
Note: The tape devices do not have to support the same media classes. The media policy is specified in the DUPMEDBRM command.
Note: The density field in the file header labels are changed to reflect the true density.
Note: If you are using DUPMEDBRM to copy a file group, the output media assumes the group number of the input media. An exception to this is if a Set Media Controls using BRM (SETMEDBRM) command overrides the value for file group and type for the output volumes.
To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
Restrictions:
1. The volumes to be copied must be active volumes, be members of the BRMS media inventory.
2. If you are copying a media set in batch mode by specifying a volume of the media set in the VOL parameter, you must use the special value *SET in the FROMVOL parameter.
3. You cannot duplicate TSM (ADSM) media using the DUPMEDBRM command.
4. Devices whose category is *APPC or *NET cannot be used to duplicate data using the DUPMEDBRM command.
5. You must have two tape drives to use this command. If the devices are shared devices, BRMS will vary the devices on for you. If the devices are not shared devices, you must vary them on.
6. If you are using devices with optimum block size enabled, the optimum block size supported by the output device must be greater than or equal to the optimum block size of the input device.
Examples:
Example 1: Copying a Single Volume
DUPMEDBRM VOL(T00001) FROMDEV(TAP01)
TODEV(TAP03) FROMVOL(T00001)
This command duplicates volume T00001 using TAP01 as the from device and TAP03 as the to device. Because T00001 is not a member of a media set, the input list (FROMVOL) contains only T00001.
Example 2: Duplicating a List of Volumes
DUPMEDBRM VOL(*LIST) FROMDEV(TAPMLB01) TODEV(TAPMLB02)
MEDPCY(FMT3570) FROMVOL(VOL001 VOL002 VOL003)
This command duplicates volumes VOL001, VOL002 and VOL003 using media library TAPMLB01 as the from device and media library TAPMLB02 as the to device using the media class in the FMT3570 media policy for the to volumes.
Example 3: Duplicating a Volume Set
DUPMEDBRM VOL(VOL002) FROMDEV(TAPMLB01) TODEV(TAPMLB02)
FROMVOL(*SET) MEDPCY(FMT3570)
This command duplicates all volumes in the volume set which contains VOL002 using media library TAPMLB01 as the from device and media library TAPMLB02 as the to device using the media class in the FMT3570 media policy for the to volumes.
Example 4: Duplicating All Marked Volumes for Another System
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAPMLB01) TODEV(TAPMLB02)
FROMSYS(SYSTEM_B)
If this command is run on SYSTEM_A, the command will search for all volumes marked for duplication owned by SYSTEM_B using media library TAPMLB01 as the from device and media library TAPMLB02 as the to device. SYSTEM_A and SYSTEM_B are in a BRMS network and share the media library resources.
Example 5: Resume a Previous Duplicate Media using
BRM DUPMEDBRM VOL(*RESUME) RSMKEY(123456)
This command resume a previous duplication operation which ended abnormally. The resume key 123456 was returned in message BRM4137 when the duplication operation ended with exception BRM4138.