background image

®

 

August 15, 2017                              

                                                                            

© Copyright IBM Corporation, 2017 

 
 
 
 

 
 
 
 

 
 
 
 
 
 
 

 
 
 
 
 
 
 
 
 
 
 

Kerri Shotwell 
Takahiro Tsuda 

IBM® TS7700 Series 

Copy Export Function User's Guide Version 

2.4 

Summary of Contents for TS7700 Series

Page 1: ...August 15 2017 Copyright IBM Corporation 2017 Kerri Shotwell Takahiro Tsuda IBM TS7700 Series Copy Export Function User s Guide Version 2 4...

Page 2: ...ion Message 37 Operator Interventions 42 Export Status File Records 43 Canceling a Copy Export Operation 52 Planning and Considerations for the Recovery TS7700 and Library 53 Performing Copy Export Re...

Page 3: ...nage Physical Volume Pool Properties 102 Manage Export Hold Volumes 105 Copy Export Settings 106 Move Export Hold Volumes Back to Private 107 Appendix C Processes on Pre 8 5 x x Systems 109 Management...

Page 4: ...s with the discovery of duplicate volumes on the second library manager partition Added a note describing a scenario where a logical volume that is only cache resident may not be eligible for a copy e...

Page 5: ...ated into the TS7700 Version 1 5 Add E06 as a valid recording format Version 1 6 Clarify need for physical scratch on recovery machine regardless of whether running in test mode or doing an actual rec...

Page 6: ...S7700 is considered a separate source TS7700 This means that only the physical volume exported from a source TS7700 can be used for recovery of a source TS7700 Physical volumes from more than one sour...

Page 7: ...he TS7700 is 8 20 0 115 For the changes supported in version 2 1 of this white paper the minimum code level for the TS7700 is 8 21 x x and the code level on the recovery TS7700 must be at the same or...

Page 8: ...the Export List File Volume and Copy Export Operation Note It is expected that customers will execute the copy export operation on a periodic basis possibly even more than once a day Since the purpose...

Page 9: ...ter Disaster Recovery 6 Once the copy export recovery operation has completed you can vary the TS7700s virtual drives online to the host and resume processing 7 If you plan on writing data to the reco...

Page 10: ...the library manager for copy export operations to be performed A service representative uses the Enable Disable function of Utilities on the Service menu to do this 3 Only one copy export operation c...

Page 11: ...n in section Copy Export Operation pre execution checking for more details 15 When a copy export operation is initiated only those logical volumes assigned to the secondary pool specified in the Expor...

Page 12: ...August 15 2017 Copyright IBM Corporation 2017 Page 12 of 117...

Page 13: ...either stand alone or grid Please contact your sales team for information 22 As a part of copy export recovery an option is provided to erase any previous data on the TS7700 This allows a TS7700 that...

Page 14: ...tion that has equal or newer physical tape drive and equal or newer TS7700 microcode TS7720T copy export set can be restored into both TS7740 and TS7720T TS7740 copy export set also can be restored in...

Page 15: ...JC JK in E07 format and JC JK JD JL in E08 format E08 JC JK JD JL in E08 format E07 JC JK in E07 format Default No JA JJ JB in E05 E06 format JC JK in E07 format and JC JK JD JL in E08 format E08 JC J...

Page 16: ...you are going to be using copy export in a Grid configuration you should also see the section on Grid Considerations for Copy Export The subsequent sections in this white paper will delve into the de...

Page 17: ...cause then a subsequent copy export would remove that primary copy A pool s properties definition must explicitly specify whether or not it will be used for copy export If a pool s properties indicate...

Page 18: ...define each Management Class name Begin by selecting the Management Class option from the ISMF Primary Option Menu for storage administrators panel On the Management Class Application Selection panel...

Page 19: ...d have a new option in Pool Properties that will allow them to select a desired recording format for an Export Pool This field is called Copy Export Recording Format and can only be assigned to a pool...

Page 20: ...7 Page 20 of 117 6 Activate the new construct names and ACS routines Before new allocations will be assigned the new management class the source control data set SCDS with the new management class def...

Page 21: ...etermine the actual names decide whether to catalog them etc Note It is recommended that the Export List file volumes used for each of the copy export operations performed be kept because of the Statu...

Page 22: ...alid options Option Description COPY Perform a copy export This is a required option EJECT If specified physical volumes are ejected to the I O station when the export completes If this option is not...

Page 23: ...esults including the logical volumes exported and the status of all physical volumes in the copy exported state Note The TS7700 may update the version number on the status file record that was written...

Page 24: ...EVELQ RESERVED UNIT VTS1 DISP NEW KEEP LABEL 2 SL VOL RETAIN REF STEP1 SYSUT2 DCB STEP1 SYSUT2 SYSUT1 DD RESERVED FILE FILE 3 EXPORT STATUS FILE STEP3 EXEC PGM IEBGENER COND 4 LT SYSPRINT DD SYSOUT SY...

Page 25: ...2E05E E05E Y MIGR 01 JA8149 Z04381 000001365176 3592E05E E05E Y RCLT 01 S70421 Z09866 000001365177 3592E05E E05E Y MIGR 01 JA8145 Z08629 000001365137 3592E05E E05E Y RCLS 03 310112 XC4487 000001365181...

Page 26: ...jobs that will mount and then demount them This will bring them back into the cache and the TS7700 will see that they need to be converted In addition if they did not have a secondary copy in the phys...

Page 27: ...logical volume is not added to the queue for copying to the physical volume pools and keeps resident state until configured Premigration Delay Time has passed since its Premigration Delay Reference ti...

Page 28: ...ry physical volume pool after the beginning of the operation they are copied to scratch physical volumes in the pool that are not to be exported during the operation Note If scratch physical volumes a...

Page 29: ...volume will be ejected when the I O station has room At code level 8 4 1 57 this is changed so that the volume maintains the copy export state and is instead moved to the Export Hold category At code...

Page 30: ...copy export operation None E0002 OPENING EXPORT LIST VOLUME XXXXXX FAILED This message is generated when opening Export List File Volume fails during copy export operation Check if the Export List Vo...

Page 31: ...ed volumes available perform analysis of the Status file on the Export List File volume and reissue the Export operation E0016 COPYING LOGICAL EXPORT VOLUMES FROM CACHE TO STACKED VOLUMES This message...

Page 32: ...ed library name of the TS7700 performing the export operation The export operation continues with the valid copies When the export operation completes perform analysis of the Status file on the Export...

Page 33: ...m an exported stacked volume exported during a previous copy export operation but one or more primary copies of the active logical volumes were unavailable to complete the operation Note A copy export...

Page 34: ...from more than one export operation are not mixed If the EJECT option was not specified the copy exported physical volumes are retained in the physical library until an operator requests that they be...

Page 35: ...y exported physical volume that contains the secondary logical volume copy must be brought back You have several options available to identify the physical volume to return easiest is first 1 Use the...

Page 36: ...as been resolved run copy export for the pool again so that the physical volume and any other physical volume with new data in the pool can be moved to the offsite location Note At code release level...

Page 37: ...statistics on what was processed during the operation The statistics reported are as follows Requested number The number of logical volumes associated with the secondary volume pool specified in the e...

Page 38: ...the recommended actions for the customer to take CBR3858I Error incurred with list volume volser in library library Library returned failure failure reason In the table below the symbols VOLSER File R...

Page 39: ...n the Volume Label does not match the Volser specified in the Export command Call your IBM Service Representative Volume Label found tape mark instead Tape Mark was found which is not in the correct f...

Page 40: ...h prepared the Export List File Volume File missing a tape mark For the File indicated a tape mark was not found as expected in the format Check JCL which prepared the Export List File Volume File int...

Page 41: ...current export volume limit Change the reclaim criteria so that empty physical volumes can be created and then return the physical volumes that are empty At code level R1 6 and higher it is possible t...

Page 42: ...has been ejected The medium may be degraded and should not be reused in an export pool During a Copy Export operation the TS7700 encountered an unrecoverable error indicating that the media of the st...

Page 43: ...lser For copy export this field contains the volume serial number of an active logical volume that has been processed as part of the operation 6 Field Delimiter Comma character 7 12 Physical Volser Fo...

Page 44: ...tus Code 02 Status Text Canceled Host request Probable Cause The volume could not be processed because the operation was canceled by the host prior to processing the volume Determine why the operation...

Page 45: ...umes must be converted to the new TS7700 format 2 On pre 8 5 x x systems refer to Using the Search Database for Volumes Window in the 3494 or 3953 Operator Guide For the volser indicated if the Status...

Page 46: ...ause of a library manager reported error during export processing Call an IBM Service Representative Status Code 21 Status Text Terminated out of scratch Probable Cause The logical volume could not be...

Page 47: ...e Cause The logical volume associated with the secondary storage pool specified as part of a copy export operation could not be exported because it does not have a valid copy on the TS7700 performing...

Page 48: ...dary storage pool specified as part of a copy export operation but that physical volume could not be exported because it contains one or more logical volumes that are the sole accessible copy of a vol...

Page 49: ...to write the physical volume The following values are defined for this field 4 3592 model J1A 5 3592 model E05 6 3592 model E05E encryption 7 3592 model E06 8 3592 model E06E encryption 9 3952 model E...

Page 50: ...haracters 33 52 Exported Timestamp This field indicates the date and time that the physical volume was exported The format of the timestamp is Year Month Day Hour Minute Second for example 2006 05 23...

Page 51: ...Delimiter Blank characters 24 27 Percentage Utilized Header UTL 28 Field Delimiter Blank character 29 31 Media Type Header MED 32 Field Delimiter Blank character 33 50 Exported Timestamp Header COPY E...

Page 52: ...TS7700 that can issue the cancel command you can cancel the operation through the library manager console Select the Cancel VTS Export Import item from the commands pull down and then select an activ...

Page 53: ...all of the copy exported physical volumes from the source TS7700 Only the copy exported volumes from a single source TS7700 can be used in the recovery process The recovery TS7700 cannot be part of a...

Page 54: ...different configuration of features ie different cache capabilities performance enablement features etc You will need to add scratch physical volumes to the recovery TS7700 even if you are only going...

Page 55: ...required The physical tape drives must be compatible with the source TS7700 including encryption The exported volumes can be from more than one pool in the source TS7700 but only the data from one so...

Page 56: ...given access to that function by the overall system administrator of the TS7700 It is also not displayed if the TS7700 is configured in a Grid configuration 2 The TS7700 determines that data exists i...

Page 57: ...x x 3 You would ensure that you are using the correct TS7700 check to make sure you are logged in to the correct TS7700 and if so check the Erase all existing volumes before the recovery check box an...

Page 58: ...a on the recovery TS7700 or to abandon the recovery process It describes what data records are going to be erased and informs you of the next action to be taken To continue on to erase the data enter...

Page 59: ...process the only selection that will be available through the Service at code level 8 30 x x or Service Troubleshooting at code level from 8 5 x x to 8 21 x x menu is the Copy Export Recovery Status...

Page 60: ...August 15 2017 Copyright IBM Corporation 2017 Page 60 of 117 MI page of code level 8 30 x x or higher...

Page 61: ...able The following are the tasks that will be listed in the task detail window as the erasure steps are being performed Taking the TS7700 offline The existing data in the TS7700 database is being remo...

Page 62: ...tion for pre 8 5 x x systems Systems running 8 5 x x with 3494 attached libraries must define the ranges on the 3494 also per Appendix C If the copy exported physical volumes were encrypted you must s...

Page 63: ...m 8 5 x x to 8 21 x x Note You will only see the Copy Export Recovery menu item if you have been given access to that function by the overall system administrator of the TS7700 It is also not displaye...

Page 64: ...August 15 2017 Copyright IBM Corporation 2017 Page 64 of 117 MI page of code level from 8 30 x x or higher MI page of code level from 8 5 x x to 8 21 x x...

Page 65: ...that can be used for recovery If a tape that is selected for recovery does not have the backup the user will get the following error The database backup could not be found on the specified recovery v...

Page 66: ...ntered the volume serial number and decided on the checkbox click on the Submit button In the next step you will have the option to continue with the recovery or abandon it 10 The following page is th...

Page 67: ...e Service at code level 8 30 x x or Service Troubleshooting at code level from 8 5 x x to 8 21 x x menu is the Copy Export Recovery Status at code level 8 30 x x or Copy Export Recovery State at code...

Page 68: ...being performed The X s and Y s will be replaced by appropriate values Taking the TS7700 offline The requested recovery tape XXXXXX is being mounted on device YYY The database backup is being retriev...

Page 69: ...ry manager The mount of volume XXXXXX on device YYY has failed 1 Be sure the physical volume is available in the library and that the physical tape device is available and does not have an error 2 Ret...

Page 70: ...lable to be used to restore the exported database Resolve problem with the physical tape devices At least one device must be available Retry the copy export recovery process An error condition has bee...

Page 71: ...gnore the storage management construct setting as logical volumes are accessed and closed If you are only going to read data there is no need to change the storage management construct actions If you...

Page 72: ...nterface for the grid and cluster to match the library names defined to DFSMS That way the names shown on the management interface panels will match those used at the host for the composite and distri...

Page 73: ...e management class name s that specified the secondary physical volume pool For R1 7 and later the volumes will need to be mounted to re establish the construct change For example let s say that in th...

Page 74: ...no further action will be taken Note Reclaiming a physical volume is not enough to have the new primary or secondary copy created as reclaim does not bring logical volumes into the cache The above exa...

Page 75: ...5 493812 11 5 2007 03 24 08 05 27 JA5204 22 5 493748 146 5 2007 03 24 08 09 31 JA5328 22 5 509 782 5 2007 03 24 08 12 08 JA5223 22 5 492283 899 5 2007 03 31 09 57 22 JA5297 22 5 493809 929 5 2007 03 3...

Page 76: ...VOLUME AB0203 MEDIA TYPE JA DRIVE MODE E05 FORMAT TS7700 VOLUME STATE COPY EXPORTED CAPACITY STATE FULL CURRENT POOL 1 MBYTES WRITTEN 497413 ACTIVE DATA 85 2 LAST INSERTED 2006 12 23 19 34 27 WHEN EX...

Page 77: ...the ratio between active data size and media capacity but check if the ratio between active data size and total bytes written to the physical volume with reclaim threshold percent Note If you wish to...

Page 78: ...those newly exported volumes will have the latest logical to physical volume mapping information and would show that the reclaimed copy exported volume no longer have any logical volumes on them The n...

Page 79: ...a copy policy specifying it is to have a copy When the copy export operation is executed the export list file volume must only be valid on the TS7700 performing the operation You will need to define a...

Page 80: ...copies were not complete when a copy export was initiated will be exported the next time copy export is initiated You can check the copy status of the logical volumes on the TS7700 that is to perform...

Page 81: ...August 15 2017 Copyright IBM Corporation 2017 Page 81 of 117 Library Request Library Request libname copyexp volser delete to have the original TS7700 stop managing them...

Page 82: ...poration 2017 Page 82 of 117 Appendix A Processes for 8 30 x x and Higher Systems Management Class Definition Begin by selecting the Constructs icon Then select Management Classes The figure below sho...

Page 83: ...August 15 2017 Copyright IBM Corporation 2017 Page 83 of 117 To add a management class 1 Select Add from the Select Action options then press Go...

Page 84: ...t a Secondary Pool It is recommended that a single secondary pool be associated with a single management class name for copy export use In this example pool 9 is being specified 4 Enter a short descri...

Page 85: ...the Select Action options Select Go to continue Make modifications to the secondary pool other attributes and or description Select the OK button to save the management class changes To delete a manag...

Page 86: ...yright IBM Corporation 2017 Page 86 of 117 Volser Range Definition Begin by selecting the Physical Volumes in Physical icon Then select Physical Volume Ranges tab The figure below shows the Physical V...

Page 87: ...being specified and I want the range of volsers to go to that pool when they are added to the library 5 Select the OK button To expand a range click on the range presented in the list select Modify f...

Page 88: ...ust 15 2017 Copyright IBM Corporation 2017 Page 88 of 117 If the TS7700 is attached to a 3494 library then setup the Volser Ranges on the 3494 using the instructions in Appendix C Volser Range Definit...

Page 89: ...nage Physical Volume Pool Properties Begin by selecting the Physical Volumes in Physical icon The figure below shows the Physical Volume Pools panel 1 Check the box beside the pool to be modified and...

Page 90: ...copy export pool is modified it is the customer s responsibility to copy export volumes from the reclaim pool 5 Select the Maximum Devices Leave at the default of All Devices unless you want to limit...

Page 91: ...August 15 2017 Copyright IBM Corporation 2017 Page 91 of 117...

Page 92: ...Physical Volumes in Physical icon Then select the Eject Physical Volumes tab The figure below shows the Eject Physical Volumes panel 1 From the Select Action options choose the Eject Export Hold optio...

Page 93: ...ion 2017 Page 93 of 117 Copy Export Settings Begin by selecting the Copy Export Settings in Settings icon The figure below shows the Copy Export Settings panel 1 Enter the number of physical volumes t...

Page 94: ...e below shows the Move Physical Volumes panel 1 From the Select Move Action options choose the Move Export Hold to Private option and then select the source pool that the export hold volume s currentl...

Page 95: ...is failed successfully completed or still in progress Therefore the MI will need to redirect the user to the Operation History page to get their results for this operation If any failure occurs an Eve...

Page 96: ...tion 2017 Page 96 of 117 Appendix B Processes for Systems from 8 5 x x to 8 21 x x Management Class Definition Begin by selecting the Constructs tab Then select Management Classes tab The figure below...

Page 97: ...August 15 2017 Copyright IBM Corporation 2017 Page 97 of 117 To add a management class 1 Select Add from the Select Action options then press Go...

Page 98: ...Secondary Pool It is recommended that a single secondary pool be associated with a single management class name for copy export use In this example pool 9 is being specified 4 Enter a short descripti...

Page 99: ...the Select Action options Select Go to continue Make modifications to the secondary pool other attributes and or description Select the OK button to save the management class changes To delete a manag...

Page 100: ...17 Copyright IBM Corporation 2017 Page 100 of 117 Volser Range Definition Begin by selecting the Physical Volumes tab Then select Physical Volume Ranges tab The figure below shows the Physical Volume...

Page 101: ...re added to the library 5 Select the OK button To expand a range click on the range presented in the list select Modify from the Select Action options then press Go Make changes to the from and or to...

Page 102: ...l Volume Pool Properties Begin by selecting the Physical Volumes tab Then select Physical Volume Pools tab The figure below shows the Physical Volume Pools panel 2 Check the box beside the pool to be...

Page 103: ...If the reclaim pool for the copy export pool is modified it is the customer s responsibility to copy export volumes from the reclaim pool 5 Select the Maximum Devices Leave at the default of All Devi...

Page 104: ...August 15 2017 Copyright IBM Corporation 2017 Page 104 of 117...

Page 105: ...ng the Physical Volumes tab Then select the Eject Physical Volumes tab The figure below shows the Eject Physical Volumes panel 3 From the Select Action options choose the Eject Export Hold option 4 Pu...

Page 106: ...106 of 117 Copy Export Settings Begin by selecting the Service Troubleshooting tab Then select Copy Export Settings tab The figure below shows the Copy Export Settings panel 1 Enter the number of phys...

Page 107: ...w shows the Move Physical Volumes panel 1 From the Select Move Action options choose the Move Export Hold to Private option and then select the source pool that the export hold volume s currently resi...

Page 108: ...is failed successfully completed or still in progress Therefore the MI will need to redirect the user to the Operation History page to get their results for this operation If any failure occurs an Ev...

Page 109: ...the library In this example a definition for management class MCPRIATL is being added 2 Select a Secondary Pool A secondary pool can be associated with more than one management class name but that is...

Page 110: ...0 if there is more than one in the library An important consideration for the media type is to select one that is compatible with the physical drives of the TS7700 that would be used for recovery For...

Page 111: ...was indicated 4 Select the Reclaim Pool The default is to the same pool If the reclaim pool is modified copy export disaster recovery capabilities can be compromised If there is a need to modify the r...

Page 112: ...ending on drive and physical volume availability when data is copied from the cache to physical tapes during a copy export operation 6 Set up the reclamation policies by entering values in the Days wi...

Page 113: ...ht the Export Hold volumes and press the Eject button followed by the Take Action button Note Although the Manage Export Hold Volumes panel allows the movement of volumes to the import category that s...

Page 114: ...he TS7700 Highlight the Unassigned volumes and press the Insert button followed by the Take Action button The selected volumes are then added to the insert category and the TS7700 will see that they a...

Page 115: ...inition Select Cartridges tab Then select the Cartridge Assignment Policy tab The figure below shows the Cartridge Assignment Policy panel Go 1 From the View pull down select the logical library that...

Page 116: ...e IBM s intellectually property rights may be used instead It is the user s responsibility to evaluate and verify the operation of any non IBM product program or service The information provided in th...

Page 117: ...NY 10504 1785 U S A Trademarks The following are trademarks or registered trademarks of International Business Machines in the United States other countries or both IBM TotalStorage DFSMS MVS S 390 z...

Reviews: