Troubleshooting
Problem
Use the Duplicate Media using BRM (DUPMEDBRM) command to copy the contents of a volume or set of volumes. You can copy a single volume, a list of volumes, or a media set.
Resolving The Problem
Use the Duplicate Media using BRM (DUPMEDBRM) command to copy the contents of a volume or set of volumes. You can copy a single volume, a list of volumes, or a media set.
Note: The OBJDTL parameter of the DUPMEDBRM command is ignored. Duplicated media will always result in duplicated object detail, if object detail information is available for the duplicated items on the input media. The object detail of the duplicated media is not actually copied, but is 'keyed' to the original saved object detail to minimize the storage BRMS requires to maintain the duplicated detail information.
Note: The OBJDTL parameter of the DUPMEDBRM command is ignored. Duplicated media will always result in duplicated object detail, if object detail information is available for the duplicated items on the input media. The object detail of the duplicated media is not actually copied, but is 'keyed' to the original saved object detail to minimize the storage BRMS requires to maintain the duplicated detail information.
- Before you use the command, however, you should keep the following information in mind:
| o | You must have two devices to use this command, unless duplicating from or too a virtual device. If the devices are shared non-MLB devices, BRMS varies the devices on for you. If your device is not a shared device, you must vary it on. |
| o | The media or media set that you are copying must be members of the media inventory. |
| o | When you duplicate volumes using the DUPMEDBRM command, BRMS does not automatically save the media information updates associated with the duplicated volumes. Follow the steps outlined below after duplicating volumes to assure the media information updates are saved and the recovery reports reflect the most current information - Saving Media Information for Duplicate Volumes. |
| o | When supplying volume serial numbers to the DUPMEDBRM commands as values for the To volume identifier field, you must provide more expired volume serial numbers to receive output copies. This is in case of any length variations between physical volumes. |
| o | You cannot duplicate saved items saved to TSM servers using the DUPMEDBRM command. Duplication of TSM server media is managed by the TSM administrator using TSM operations. |
| o | When duplicating internal virtual media to physical media, BRMS will then treat the physical media as the original save when the virtual media is expired. This is only on the first duplication to physical media. Remote DUPMEDBRM is not supported for IBM i internal virtual media. |
| o | If a volume is marked for duplication, BRMS will not move the volume when movement is run. You should refer to "Allow volumes that are marked for duplication to be moved" for Exceptions. |
| o | To duplicate a list of volumes, specify *LIST on the From volume identifier (VOL) parameter in conjunction with the volumes to be duplicated on the Input volume list (FROMVOL) parameter. BRMS may not duplicate the volumes in the order specified by the user. BRMS sorts the history items by the command start time (BKCMDT field in the QA1AHS file). The volume with the earliest command start time will be duplicated first. |
| o | When duplicating media that is part of a set, all media in the set needs to be at the location of tape library or tape drive. If all media is not at the correct location, users will see a BRM1565, BRM4137, and BRM4138, and the BRMS flight recorders will show the following: q1aMS q1aLogMessage::log send to other message queueBRM1565 q1aMS q1aLogMessage:: don't need to send to additional message queueBRM1565 q1aOB (E) q1aMediaFileList::duplicate - Volumes not at the same location. |
| o | BRMS requires an active volume and saved history for the volume(s) in order to use the DUPMEDBRM command. Use WRKMEDIBRM VOL(xxxxxx) to verify there is saved history on the volume(s) |
Notes:
Copying Volumes with DUPMEDBRM
To use the DUPMEDBRM command, you should do the following:
Note: When saving the recovery information (SAVMEDINF), a media policy needs to be specified (MEDPCY). *NONE for the MEDPCY parameter on the DUPMEDBRM will cause the item to not have an expiration date.
Examples
Duplicating all media marked for duplication:
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAP01) TODEV(TAP02) MEDPCY(FULL)
Duplicating all media marked for duplication that was saved with a specific control group:
DUPMEDBRM VOL(*SEARCH) FILEGRP(FULLSAVE) FROMDEV(TAP01) TODEV(TAP02) MEDPCY(FULL)
Duplicating a list of media:
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAP01) TODEV(TAP02) FROMVOL(BRM001 BRM002) MEDPCY(FULL)
Duplicating Multiple True Parallel-Parallel Saves to a Single Volume:
In this example, a parallel save was done to volumes VOL001, VOL002, and VOL003. The DUPMEDBRM is done to VOL004.
DUPMEDBRM VOL(VOL001) FROMDEV(TAPMLBxx) TODEV(TAPMLBXX) MEDPCY(media_class) FROMVOL(VOL001) FROMENDOPT(*UNLOAD) TOENDOPT(*LEAVE) TOSEQNBR(1) TOVOL(VOL004)
DUPMEDBRM VOL(VOL002) FROMDEV(TAPMLBxx) TODEV(TAPMLBXX) MEDPCY(media_class) FROMVOL(VOL002) FROMENDOPT(*UNLOAD) TOENDOPT(*LEAVE) TOSEQNBR(*END) TOVOL(VOL004)
DUPMEDBRM VOL(VOL003) FROMDEV(TAPMLBxx) TODEV(TAPMLBXX) MEDPCY(media_class) FROMVOL(VOL003) FROMENDOPT(*UNLOAD) TOENDOPT(*LEAVE) TOSEQNBR(*END) TOVOL(VOL004)
Notes:
Saving Media Information for Duplicate Volumes
Note: The following steps are for V5R3 and earlier. Beginning at V5R4, the parameter SAVMEDINF is available on the DUPMEDBRM command; however, it should not be used for remote duplications.
You should do the following to save media information for duplicate volumes:
Example
Duplicating all media marked for duplication:
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAP01) TODEV(TAP02) MEDPCY(FULL) SAVMEDINF(*LIB)
To do remote media duplication, refer to technote N1015081, How Remote DUPMEDBRM Works.
| 1. | The devices do not have to support the same media classes. You specify the media policy in the DUPMEDBRM command. |
| 2. | To use DUPMEDBRM to copy a file group, the output media assumes the group number of the input media. An exception to this is a SETMEDBRM command that overrides the value for file group and type for the output volumes. |
| 3. | The easiest approach to duplicate volumes of a parallel set is to mark the volumes for duplication and use VOL(*SEARCH) on the DUPMEDBRM command. |
| 4. | If running DUPMEDBRM commands on different systems in a BRMS network at the same time, BRMS may not always update the duplicate volume information (WRKMEDBRM Option 15) correctly on all systems. |
| 5. | If duplication fails, message BRM4137, Media duplication restart recovery, should be logged in the joblog. The recovery portion of the message will provide a resume key to resume the failed duplication. The recommended way to recover from a failed DUPMEDBRM is to restart the DUPMEDBRM with the resume key. For example: DUPMEDBRM VOL(*RESUME) RSMKEY(XXXXXX). If the failed duplication was for a volume that is part of a media set, the dupmedbrm needs to be restarted with the resume key or the entire media set needs to be reduplicated. |
Copying Volumes with DUPMEDBRM
To use the DUPMEDBRM command, you should do the following:
| 1. | Type DUPMEDBRM at a command line and press F4 to prompt the display. |
| 2. | At the Duplicate Media using BRMS (DUPMEDBRM) display, press F9 to prompt the remaining parameters. |
| 3. | The From volume identifier parameter works in conjunction with the Input volume list parameter to identify the volumes to be duplicated: o To duplicate a single volume, specify *LIST for the from volume identifier prompt, and the volume to be duplicated for the Input volume list prompt. If the volume is part of a serial media set, then you need to specify the sequence numbers from the volume you want duplicated. If the sequence numbers specified span from or to another volume, those volumes will also be requried. o To duplicate a volume set, specify a volume identifier of any volume in the set for the From volume identifier prompt, and either *SET or *VOL for the Input volume list prompt. Note: You must use this method when duplicating the volumes of a media set in a batch job. Alternatively, you can type the name of any volume in the media set in the From volume identifier parameter, and then press Enter. BRMS will find all other volumes in the set and list these in the Input volume list parameter. o To duplicate a list of volumes, specify *LIST for the From volume identifier prompt, and the volumes to be duplicated for the Input volume list prompt. You can use the + field to provide the additional fields in which to list the volumes you want BRMS to duplicate. o To duplicate all volumes marked for duplication, specify *SEARCH for the From volume identifier prompt, and either *SET or *VOL for the Input volume list prompt. |
| 4. | In the From device field, specify the name of the device from which BRMS will make the duplicate. This device contains the original volume. |
| 5. | In the To device field, specify the name of the device that contains the volume that will receive the duplicated information. |
| 6. | Review the other parameters carefully and change as needed. Note: The From sequence number and To sequence number fields are ignored for optical media. |
| 7. | Press Enter to process the command. |
Examples
Duplicating all media marked for duplication:
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAP01) TODEV(TAP02) MEDPCY(FULL)
Duplicating all media marked for duplication that was saved with a specific control group:
DUPMEDBRM VOL(*SEARCH) FILEGRP(FULLSAVE) FROMDEV(TAP01) TODEV(TAP02) MEDPCY(FULL)
Duplicating a list of media:
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAP01) TODEV(TAP02) FROMVOL(BRM001 BRM002) MEDPCY(FULL)
Duplicating Multiple True Parallel-Parallel Saves to a Single Volume:
In this example, a parallel save was done to volumes VOL001, VOL002, and VOL003. The DUPMEDBRM is done to VOL004.
DUPMEDBRM VOL(VOL001) FROMDEV(TAPMLBxx) TODEV(TAPMLBXX) MEDPCY(media_class) FROMVOL(VOL001) FROMENDOPT(*UNLOAD) TOENDOPT(*LEAVE) TOSEQNBR(1) TOVOL(VOL004)
DUPMEDBRM VOL(VOL002) FROMDEV(TAPMLBxx) TODEV(TAPMLBXX) MEDPCY(media_class) FROMVOL(VOL002) FROMENDOPT(*UNLOAD) TOENDOPT(*LEAVE) TOSEQNBR(*END) TOVOL(VOL004)
DUPMEDBRM VOL(VOL003) FROMDEV(TAPMLBxx) TODEV(TAPMLBXX) MEDPCY(media_class) FROMVOL(VOL003) FROMENDOPT(*UNLOAD) TOENDOPT(*LEAVE) TOSEQNBR(*END) TOVOL(VOL004)
Notes:
| 1. | When restoring from the new single volume , the minimum/maximum parallel resources must be changed: RSTLIBBRM SAVLIB(XXXXXXX) DEV(TAPMLB01) PRLRSC(1 1) or WRKMEDIBRM Option 7 , then F9 Parallel device resources: Minimum resources. . . . . . . . 1 1-32, *NONE, *AVAIL Maximum resources. . . . . . . . 1 1-32, *AVAIL, *MIN If the minimum resources is not changed to 1 when restoring from the new single volume, the restore may fail with message CPF387C, Device resources not available. |
| 2. | When doing a WRKMEDIBRM, the library will still list as being saved in parallel and Option 5 will list the same volume x number of times (where x is the number of resources used for the original save) |
Saving Media Information for Duplicate Volumes
Note: The following steps are for V5R3 and earlier. Beginning at V5R4, the parameter SAVMEDINF is available on the DUPMEDBRM command; however, it should not be used for remote duplications.
You should do the following to save media information for duplicate volumes:
| 1. | Run the BRMS backup on the original volume and specify that you want to save the media information. |
| 2. | Create the duplicate volumes with the DUPMEDBRM command. |
| 3. | Run media movement by using the Move Media using BRM (MOVMEDBRM) command so that the two sets of volumes (original and duplicate) go to different locations. |
| 4. | Perform another save of the media information by using the Save Media Information using BRM (SAVMEDIBRM) command. |
| 5. | Move the volumes that SAVMEDIBRM command creates in the previous step to the same location as the duplicate volumes. |
| 6. | Create the recovery report by specifying the location of the duplicate volumes in the STRRCYBRM LOC (duplicate-volume-location). |
Example
Duplicating all media marked for duplication:
DUPMEDBRM VOL(*SEARCH) FROMDEV(TAP01) TODEV(TAP02) MEDPCY(FULL) SAVMEDINF(*LIB)
To do remote media duplication, refer to technote N1015081, How Remote DUPMEDBRM Works.
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z000000cwpBAAQ","label":"Save Restore-\u003EBRMS"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Historical Number
511528595
Was this topic helpful?
Document Information
More support for:
IBM i
Component:
Save Restore->BRMS
Software version:
All Versions
Operating system(s):
IBM i
Document number:
643149
Modified date:
07 November 2024
UID
nas8N1018659
Manage My Notification Subscriptions