User Initiated Transfers of Media to Cloud Storage

Virtual media from an image catalog is transferred to the cloud when the media is moved to a cloud location. Media can be moved to a cloud location by using one of these methods:  

1. Change the location of the media to a cloud location using one of the following interfaces:

• WRKMEDBRM option 2=Change
• WRKMEDBRM option 8=Move
• use the BRMS GUI client to change the media location

1. Add an entry for a cloud location to a move policy, associate virtual media with the move policy and run movement for the move policy using one of the following commands:

• MOVMEDBRM
• MOVMEDBRM with a subsequent VFYMOVBRM
• STRMNTBRM MOVMED(*YES)

Example

A demonstration of this example is presented in the following videos:

BRMS_Manual_Cloud_Transfer.mp4 (~12MB)
BRMS_Additional_cloud_transfer_information.mp4 (~3MB)

This example requires that product IBM Cloud Storage Solutions for i is installed on the system and the following BRMS PTF(s) must be installed on a stand-alone BRMS system or on all the systems in a BRMS network:

• 7.3 - SI61153
• 7.2 - SI61152
• 7.1 - SI61151

NOTE: If a BRMS network contains a 6.1 system please contact a service representative before applying the PTF(s) to any of the systems in the BRMS network.

This example assumes Media and Storage Extensions (product 5770SS1 option 18) is installed on the system so it uses virtual tape media.  If Media and Storage Extensions is not installed on the system, virtual optical media can be substituted in the example.

This scenario will save a single empty library to virtual tape media, manually transfer the media to the cloud and then automatically transfer media back to the system during a restore.

1. Create a cloud resource named BRMSCLD by running one of the following commands:
   • CRTFPRICC
   • CRTSLRICC

Note: The following commands can be used to verify that the cloud resource is functioning correctly:

• CPYTOCLD
• CPYFRMCLD

1. Configure BRMS objects required to use the cloud resource:
   • INZBRM OPTION(*DATA)
2. Create a virtual tape device:
   • CRTDEVTAP DEVD(BRMSCLDTAP) RSRCNAME(*VRT)
3. Vary on the virtual tape device:
   • VRYCFG CFGOBJ(BRMSCLDTAP) CFGTYPE(*DEV) STATUS(*ON)
4. Create an image catalog:
   • CRTIMGCLG IMGCLG(BRMSCLDTAP) TYPE(*TAP) DIR('/tmp/BRMSCLDTAP') CRTDIR(*YES)
5. Add a volume to the image catalog:
   •  ADDIMGCLGE IMGCLG(BRMSCLDTAP) FROMFILE(*NEW) TOFILE(*GEN) VOLNAM(BRMCLD)
6. Load the image catalog on the device:
   • LODIMGCLG IMGCLG(BRMSCLDTAP) DEV(BRMSCLDTAP)  
7. Configure the virtual tape device in BRMS:
   • WRKDEVBRM
     • specify 1=Create for the Opt field
     • specify BRMSCLDTAP for the Device field
     • specify *VRTTAP for the Category field
8. Add a media class for the virtual tape media:
   • WRKCLSBRM TYPE(*MED)    
     • specify 1=Create for the Opt field
     • specify BRMSCLDTAP for the Class field
       • specify *VRT256K for the Density field
       • specify *NO for the Shared media field
9. Add volume BRMCLD to the BRMS media inventory:
   • ADDMEDBRM VOL(BRMCLD) MEDCLS(BRMSCLDTAP) IMGCLG(BRMSCLDTAP)
10. Add a media policy for the virtual tape media:
    • WRKPCYBRM TYPE(*MED)    
      • specify 1=Create for the Opt field
      • specify BRMSCLDTAP for the Policy field
        • specify BRMSCLDTAP for the Media class field
11. Create a library to save to the cloud:
    • CRTLIB LIB(CLDLIB)
12. Save the library to the virtual tape volume:
    • SAVLIBBRM LIB(CLDLIB) DEV(BRMSCLDTAP) MEDPCY(BRMSCLDTAP)
13. Move volume BRMCLD to the cloud location:
    • WRKMEDBRM VOL(BRMCLD)
      • verify the volume is in *ACT status
      • verify location *HOME
      • specify 8=Move for the Opt field
        • specify BRMSCLD for the Storage location field
      • verify the volume is in *ACT status
      • verify location BRMSCLD
14. Delete the library:
    • DLTLIB LIB(CLDLIB)
15. Restore the library:
    • RSTLIBBRM SAVLIB(CLDLIB) DEV(BRMSCLDTAP)
16. Verify that the library was restored:
    • DSPLIB LIB(CLDLIB)

NOTES

• When control groups are run that have a name with a QCLD prefix will, BRMS will automatically create and transfer media to the cloud.  For more information regarding automatic cloud transfers see Automatic Transfers of Media to Cloud Storage.
• If using user created images, BRMS will not manage these image catalog entries. As such, when the data is transferred to the cloud, the images will not be cleared or deleted. Users will need to manage these themselves. it is recommended using  CHGIMGCLGE with the parameter  IMGCLG(*MIN) to shrink the size down as much as possible.