IBM Tivoli ADSTAR, User Manual

Page 1: ...voli ADSTAR Distributed Storage Manager for VM Version 3 Release 1 2 Program Number 5697 VM3 for Use with VM ESA Version 2 Release 2 0 VM ESA Version 2 Release 3 0 VM ESA Version 2 Release 4 0 Document Date June 1999 GI10 0548 00 ...

Page 2: ...or reader s comments appears at the back of this publication When you send information to IBM you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you Copyright International Business Machines Corporation 1992 1999 All rights reserved Note to U S Government Users Documentation related to restricted rights Use...

Page 3: ...s 9 5 1 Migration Requirements 9 5 2 Hardware Requirements 9 5 3 Program Considerations 9 5 3 1 Operating System Requirements 9 5 3 2 Other Program Product Requirements 9 5 3 3 Program Installation Service Considerations 10 5 4 DASD Storage and User ID Requirements 10 6 0 Installation Instructions 13 6 1 VMSES E Installation Process Overview 13 6 2 Plan Your Installation For Tivoli ADSM for VM 14 ...

Page 4: ... Disabling Tivoli ADSM for VM 43 Appendix C Moving Tivoli ADSM for VM to SFS Directories and Creating PPF Override 45 C 1 Setup SFS File Pool and Directories 45 C 2 Copy Minidisk or SFS Files to SFS Directories 47 C 3 Create Product Parameter File PPF Override 48 Appendix D ADSM Installation Tape Contents 50 Appendix E Notices 53 E 1 Trademarks and Service Marks 53 Reader s Comments 55 Figures 1 B...

Page 5: ...ides detailed servicing instructions for Tivoli ADSM for VM Appendix A Applying an RSU Tape for Tivoli ADSM for VM on page 36 provides detailed Recommended Service Upgrade instructions for Tivoli ADSM for VM Appendix B Disabling Tivoli ADSM for VM on page 43 describes how to disable Tivoli ADSM for VM 3 1 2 if on VM ESA Version 2 Release 4 0 Appendix C Moving Tivoli ADSM for VM to SFS Directories ...

Page 6: ...he VM ESA System DDR in a disabled state Most of the install steps have already been completed This includes installing the ADSM base tape and RSU tape You will still need to complete some new planning steps and the place into production steps as documented in chapter 6 0 Installation Instructions on page 13 2 Tivoli ADSM for VM Program Directory ...

Page 7: ... 1 2 Order one of the feature codes listed in Figure 1 below and indicate that you want to suppress media shipment This will license you for Tivoli ADSM for VM 3 1 2 and provide you with a set of manuals Media shipment is not necessary since the product has already been pre installed on the VM ESA System DDRs for you Installations currently using Tivoli ADSM for VM 3 1 2 There is nothing additiona...

Page 8: ...er Medium Physical Volume Tape Content External Tape Label 6001 4mm tape cart 1 Tivoli ADSM for VM 3 1 2 ADSM VM Server Figure 2 Program Tape File Content Tape File Content 1 Tape Header 2 Tape Header 3 Product Header 4 Product Memo 5 Service Apply Lists 6 PTFPARTs 7 Tivoli ADSM for VM Service 8 Tivoli ADSM for VM Service 9 Tivoli ADSM for VM Base Code 10 Tivoli ADSM for VM Executable Code Figure ...

Page 9: ...pending on your VM ESA release may be useful during the installation of Tivoli ADSM for VM To order copies contact your IBM representative Figure 3 Page 2 of 2 Basic Material Unlicensed Publications Publication Title Form Number Tivoli ADSTAR Distributed Storage Manager Installing the Clients SH26 4080 Tivoli ADSTAR Distributed Storage Manager Reference Cards for the Backup Archive Clients SX26 60...

Page 10: ...m Number VM ESA VMSES E Introduction and Reference GC24 5837 VM ESA Service Guide GC24 5838 VM ESA Planning and Administration SC24 5750 VM ESA CMS Command Reference SC24 5776 VM ESA CMS File Pool Planning Administration and Operation SC24 5751 VM ESA System Messages and Codes GC24 5841 6 Tivoli ADSM for VM Program Directory ...

Page 11: ...this program to your IBM Support Center If an APAR is required the Support Center will provide the address to which any needed documentation can be sent Figure 7 identifies the component ID COMPID Retain Release and Field Engineering Service Number FESN for Tivoli ADSM for VM Figure 6 PSP Upgrade and Subset ID Retain Upgrade Subset COMPID Release 565511901 A31 ADSM312 ADSMVM SES 565511901 A31 ADSM...

Page 12: ...2 Service Level Information Check the ADSM312 PSP bucket for any additional PTFs that should be installed or any additional install information 4 3 Cumulative Service Tape Cumulative service for Tivoli ADSM for VM Version 3 Release 1 2 is available through a periodic Recommended Service Upgrade RSU tape See PSP bucket upgrade ADSM312 subset yynnRSU where yynn is the RSU service level for the lates...

Page 13: ...cial hardware requirements for Tivoli ADSM for VM 5 3 Program Considerations The following sections list the programming considerations for installing Tivoli ADSM for VM and activating its functions 5 3 1 Operating System Requirements Tivoli ADSM for VM supports the following VM operating systems VM ESA Version 2 Release 4 0 VM ESA Version 2 Release 3 0 VM ESA Version 2 Release 2 0 5 3 2 Other Pro...

Page 14: ...red File System SFS after you have initially installed the product or if you want to change from the default SFS file pool or directories then you will need to follow the steps in Appendix C Moving Tivoli ADSM for VM to SFS Directories and Creating PPF Override on page 45 These steps will have you create the SFS directories move the files to the SFS directories and create a PPF override You can al...

Page 15: ...ADSM for VM that is currently in production VMSYS 5654A09A ADSM APPLYPROD 5654A09A 491 3390 3380 9345 45 54 54 64800 8100 This is the production disk All the files needed by the ADSM Server and the CMS Admin client will exist in this disk SFS directory not recommended 1 Notes 1 An SFS directory SHOULD NOT be used for the production disk or the test build disk to avoid suspension of the ADSM server...

Page 16: ...e message repository which is read as needed by the server will reside on these disks By placing the message repository in an SFS directory the ADSM Server can be suspended while the SFS Server satisfies a read request when a message text is needed 2 Cylinder values defined in this table are based on a 4K block size FB 512 block and SFS values are derived from the 3380 cylinder values in this tabl...

Page 17: ... a VM ESA Version 2 Release 3 system If you re installing Tivoli ADSM for VM on a different VM ESA system the results obtained for some commands may differ from those depicted here 6 1 VMSES E Installation Process Overview The following is a brief description of the main steps in installing Tivoli ADSM for VM using VMSES E Plan Your Installation Use the VMFINS command to load several VMSES E files...

Page 18: ... planning tasks can be performed This user ID can be any ID that has the following read access to MAINT s 5E5 minidisk write access to MAINT s 51D minidisk Privilege class E authority required for VM ESA 2 4 0 installations 2 Establish read access to the VMSES E code link MAINT 5e5 5e5 rr access 5e5 b The 5E5 disk contains the VMSES E code 3 Establish write access to the Software Inventory disk li...

Page 19: ...stalling using Shared File System directories This command will perform the following Set Tivoli ADSM for VM as ENABLED in VMSES E and within CP Create a 5654A09A PRODSYS file on the A disk that contains the CP system configuration PRODUCT statement with a state of ENABLED 5 In order to retain the ENABLED state for Tivoli ADSM for VM update the CP system configuration file with the information in ...

Page 20: ...VM as described in 2 0 Program Materials on page 3 Remember to check the area which indicates to suppress media shipment which will order you a set of manuals for Tivoli ADSM for VM 3 1 2 End of VM ESA Version 2 Release 4 0 Licensed Users of Tivoli ADSM for VM only 6 Mount the Tivoli ADSM for VM installation tape and attach it to the user ID at virtual address 181 The VMFINS EXEC requires the tape...

Page 21: ... name of the product parameter file the default install user ID minidisk directory definitions Notes a If you change the PPF name a default user ID or other parameters via a PPF override you will need to use your changed values instead of those indicated when appropriate throughout the rest of the installation instructions as well as the instructions for servicing Tivoli ADSM for VM For example yo...

Page 22: ...4A 9A ADSM PRODID 5654A 9A ADSM VMFINS19 9I 5654A 9A PLANINFO created on your A disk VMFREQ28 5I Product PPF 5654A 9A ADSM PRODID 5654A 9A ADSM has passed requisite checking VMFINT26 3I Planning for the installation of product PPF 5654A 9A ADSM PRODID 5654A 9A ADSM VMFRMT276 I VMFRMT processing started VMFRMT276 I VMFRMT processing completed successfully VMFINS276 I VMFINS processing completed suc...

Page 23: ...stall of Tivoli ADSM for VM as these products were not in VMSES E format Update the software inventories by issuing the following commands for each of the products listed For additional information about the System Inventory files and the VMFSIM command see the VMSES E Introduction and Reference If C 370 5688188 V2R1M0 or lower is installed on your system enter If you want to use LE V1R5M0 or high...

Page 24: ...xxxxxx to a valid password in accordance with your security guidelines 4 Add the 5654A09A directory definition to the system directory Note Updates to the CP system directory can be done only from authorized user IDs If you or any of your user IDs do not have the proper authority then seek help from the person who has the proper authority 5 Place the new directory definition on line using VM Direc...

Page 25: ...ry definition to the system directory Note Updates to the CP system directory can be done only from authorized user IDs If you or any of your user IDs do not have the proper authority then seek help from the person who has the proper authority 6 Place the new directory definition on line using VM Directory Maintenance DIRMAINT or an equivalent CP directory maintenance method 7 An SFS install will ...

Page 26: ...ory vmsys 5654A09A adsm applyalt create directory vmsys 5654A09A adsm applyprod create directory vmsys 5654A09A adsm delta Refer to Figure 8 on page 11 to find out what each SFS directory is used for If necessary see the VM ESA CMS Command Reference manual for more information about the CREATE DIRECTORY command 6 4 Install Tivoli ADSM for VM The ppfname used throughout these installation instructi...

Page 27: ...es a If you ve already created a PPF override file you should specify your override file name in place of the default PPF name 5654A09A after the PPF keyword for the following VMFINS command b You may be prompted for additional information during VMFINS INSTALL processing depending on your installation environment If you re unsure how to respond to a prompt refer to the Installing Products with VM...

Page 28: ...sing completed successfully VMFREC276 I VMFREC processing started VMFREC1852I Volume 1 of 1 of INS TAPE 99 VMFREC1851I 1 of 6 VMFRCAXL processing AXLIST VMFRCX2159I Loading part s to DELTA 2D2 G VMFREC1851I 2 of 6 VMFRCPTF processing PARTLST VMFRCP2159I Loading part s to DELTA 2D2 G VMFREC1851I 3 of 6 VMFRCALL processing APPLY VMFRCA2159I Loading part s to APPLY 2A6 E VMFRCA2159I Loaded 1 part s t...

Page 29: ...SGLOG If necessary correct any problems before going on For information about handling specific error messages see VM ESA System Messages and Codes or use on line HELP vmfview install 6 4 2 Place Tivoli ADSM for VM into Production 1 Copy the Tivoli ADSM for VM files from the test BUILD disk to the production BUILD disk access 4e2 e access 491 f vmfcopy e f1 prodid 5654A09A ADSM olddate replace 4E2...

Page 30: ...lient on your system The book also contains instructions for migrating a Version 2 ADSM system to Version 3 Tivoli ADSM for VM is now installed and built on your system 26 Tivoli ADSM for VM Program Directory ...

Page 31: ...sed or if using a shared file system change the instructions appropriately 7 1 VMSES E Service Process Overview The following is a brief description of the main steps in servicing Tivoli ADSM for VM using VMSES E Setup Environment Access the software inventory disk Use VMFSETUP command to establish the correct minidisk access order Merge Service Use the VMFMRDSK command to clear the alternate APPL...

Page 32: ...your own PPF override file for Tivoli ADSM for VM you should use your file s ppfname instead of 5654A09A The ppfname you selected should be used throughout the rest of this procedure unless otherwise stated differently 1 Logon to Tivoli ADSM for VM service user ID 5654A09A 2 If the Software Inventory disk 51D was accessed R O read only then establish write access to the Software Inventory disk Not...

Page 33: ...s PD and continue with step 9 vmfrec info The INFO option loads the documentation and displays a list of all the products on the tape 6 Check the receive message log VMFREC MSGLOG for warning and error messages vmfview receive Also make note of which products and components have service on the tape To do this use the PF5 key to show all status messages which identify the products on the tape 7 Rea...

Page 34: ...e in the VM ESA Service Guide Remember to substitute the ppfname and compname used for servicing Tivoli ADSM for VM in the instructions shown in the Appendix Then return back to this PD and continue with 7 2 3 Apply the Service on page 31 1 Receive the service vmfrec ppf 5654A09A ADSM ADSMSFS Use ADSM for installing on minidisks or ADSMSFS for installing in Shared File System directories This comm...

Page 35: ...es and Codes or use on line HELP vmfview apply Note If you get the message VMFAPP2120W then re apply any local modifications before building the new Tivoli ADSM for VM Refer to chapter 7 in the VM ESA Service Guide Follow the steps that are applicable to your local modification The following substitutions need to be made esalcl should be 5654A09A esa should be 5654A09A compname should be ADSM or A...

Page 36: ...d Status Table with serviced parts vmfbld ppf 5654A09A ADSM ADSMSFS status Use ADSM for installing on minidisks or ADSMSFS for installing in Shared File System directories This command updates the Build Status Table 32 Tivoli ADSM for VM Program Directory ...

Page 37: ...er files with VMFPPF VMFBLD2188I Building 5654A 9A PPF on 191 A from level PFnnnnn 0 Enter a 0 and complete the following steps before you continue vmfppf 5654A09A Note If you ve created your own PPF override then use your PPF name instead of 5654A09A Use ADSM for installing on minidisks or ADSMSFS for installing in Shared File System directories copyfile 5654A09A PPF a d olddate replace erase 565...

Page 38: ...cessary correct any problems before going on For information about handling specific error messages see VM ESA System Messages and Codes or use on line HELP vmfview build 7 2 6 Place the New Tivoli ADSM for VM Service into Production 1 Copy the serviced files from the test BUILD disk onto the production BUILD disk using VMFCOPY access 4e2 e access 491 f vmfcopy e f1 prodid 5654A09A ADSM olddate re...

Page 39: ...You have finished servicing Tivoli ADSM for VM Service Instructions 35 ...

Page 40: ...from the RSU Tape These tasks will be discussed The following outline is an overview of what tasks need to be performed during the Preventive Service procedure PSU using the RSU tape Prepare System In this task you will receive the documentation contained on the RSU Tape and determine the DASD required to install the RSU Tape Merge Service Use the VMFMRDSK command to clear the alternate APPLY disk...

Page 41: ... module The file name of the decompacted file will be of the format RPTFnum The file type will be SERVLINK You will need to enter the file name on the VMFINS commands 1 Read through the latest RSU information hard copy memo 2 If the Software Inventory disk 51D was accessed R O read only then establish write access to the Software Inventory disk Note If the MAINT 51D minidisk was accessed R O you w...

Page 42: ...PPLY disks for Tivoli ADSM for VM Next you must prepare your system to receive the service from the RSU Tape To do this you must first clear the alternate APPLY disk for receipt of the service from the RSU Tape Enter the VMFMRDSK command to merge the alternate APPLY disk to the production APPLY disk This will clear the alternate APPLY disk vmfmrdsk 5654A09A ADSM ADSMSFS apply Use ADSM for installi...

Page 43: ...sh the Tivoli ADSM for VM service disks by loading new service from the RSU Tape a If receiving the RSU from tape vmfins install ppf 5654A09A ADSM ADSMSFS nomemo nolink override no Use component name ADSM if the product is installed on minidisks or ADSMSFS if the product is installed in SFS b If receiving the RSU from an envelope file vmfins install ppf 5654A09A ADSM ADSMSFS nomemo nolink env rptf...

Page 44: ...2 5I Y S R O 19E MNT19E VMFSET276 I VMFSETUP processing completed successfully VMFREC276 I VMFREC processing started VMFREC1852I Volume 1 of 1 of INS TAPE yynn VMFREC276 I VMFREC processing completed successfully VMFINT276 I VMFINST processing completed successfully VMFINS276 I VMFINS processing completed successfully Ready 4 5 2 Check the receive message log VMFREC MSGLOG for warning and error me...

Page 45: ...heck the apply message log VMFAPP MSGLOG for warning and error messages If necessary correct any problems before going on For information about handling specific apply messages see VM ESA System Messages and Codes or use online HELP vmfview apply 3 If necessary rework local modifications The output from the VMFPSU command which was run in an earlier step appid PSUPLAN file can be used to indicate ...

Page 46: ...alled The following command is used to query the current service level of the system vmfsim query vm sysrecs tdata ppf ppfname stat The output from this command is similar to the following console log The last part of the status line indicates the RSU service level 9901 VMFSIP24 8I RESULTS FOR TDATA PPF ppfname STAT PPF ppfname compname STAT RECEIVED mm dd yy hh mm ss userid RSU 99 1 4 5 42 Tivoli...

Page 47: ...sk Note If the MAINT 51D minidisk was accessed R O you will need to have the user that has it accessed R W link it R O You then can issue the following commands to obtain R W access to it link MAINT 51d 51d mr access 51d d The 51D minidisk is where the VMSES E Software Inventory files and other product dependent files reside 4 Set Tivoli ADSM for VM to the disabled state vmfins disable ppf 5654A09...

Page 48: ... name is SYSTEM CONFIG and it resides on the CP parm disk MAINT s CF1 and CF2 minidisks The section PRODUCT ENABLE DISABLE INFORMATION in the SYSTEM CONFIG file is what needs to be updated You will need to replace the current ENABLED entry for PRODID 5654A09A Tivoli ADSM for VM with the entry from the 5654A09A PRODSYS file created by VMFINS in the previous step If necessary refer to the VM ESA Pla...

Page 49: ... the necessary Tivoli ADSM for VM subdirectories Copy files from the minidisks to the new SFS subdirectories Create a PPF override if not using the default file pool or subdirectory names Where to next You need to do one of the following If you want to place Tivoli ADSM for VM into SFS directories using the defaults defined in the 5654A09A PPF file you need to continue with the instructions provid...

Page 50: ...zed in Figure 8 on page 11 This information is used when enrolling the 5654A09A to the user defined file pool 2 Enroll user 5654A09A in the user defined file pool using the ENROLL USER command ENROLL USER 5654A09A userfilepool BLOCKS blocks where blocks is the number of 4k blocks that you calculated in the previous step Note This must be done from a user ID that is an administrator for the user de...

Page 51: ...tatement in the 5654A09A directory entry IPL CMS PARM FILEPOOL userfilepool This will cause CMS to automatically access the 5654A09A s top directory as file mode A C 2 Copy Minidisk or SFS Files to SFS Directories 1 Copy the files from the Tivoli ADSM for VM minidisks or VMSYS file pool if you already have Tivoli ADSM for VM installed in the default SFS file pool to your new user defined SFS file ...

Page 52: ...nformation on PPF overrides Note Do not modify the product supplied 5654A09A PPF or 5654A09A PPF files to change the VMSYS file pool name or any other installation parameters If the 5654A09A PPF file is serviced the existing PPF file will be replaced and any changes to that file will be lost By creating your own PPF override your updates will be preserved The following process describes changing t...

Page 53: ...54A 9A USER 5654A 9A P ADSM Code Owner Userid EDCL END P P P This override will replace the DCL section of the adsmsfs override area of the 5654A09A PPF file 3 If your PPF override file was created at file mode A copy it to file mode D the Software Inventory minidisk MAINT 51D file copyfile overname PPF fm d olddate 4 Compile your changes to create the usable overname PPF file vmfppf overname adsm...

Page 54: ...le File 3 5654A 9A 3121 1 Program level file 5654A 9A INS99 Product contents directory file File 4 5654A 9A MEMO ADSM for VM Memo to Users File 5 DUMMY FILE File 6 DUMMY FILE File 7 DUMMY FILE File 8 DUMMY FILE File 9 DSMLOAD EXEC Format 2 build list to build usable forms of the ADSM 3 1 2 product DSMINST EXEC Initialize the server database DSMMDISK EXEC Prepare minidisks for use as server storage...

Page 55: ...ent panel README TXT Server and CMD Admin client latest info File 1 DSMINST EXEC Initialize the server database DSMMDISK EXEC Prepare minidisks for use as server storage pool space DSMOP EXEC Sample Operator tape mount reply procedure DSMMOUNT EXEC Sample tape mount procedure DSMDELET EXEC Sample tape deletion procedure DSMAMENG HLP American English server help text repository DSMSERV MODULE Serve...

Page 56: ...MPLE ANRUSRXC SAMPLE ANRUSRXH SAMPLE DSMSERV IDL Server IDL file ASHG 998 CLASS Server Web client panel CMMNDLN CLASS Server Web client panel DSMCNSL CLASS Server Web client panel P HTML Server Web client panels P GIF Server Web client panels README TXT Server and CMD Admin client latest info 52 Tivoli ADSM for VM Program Directory ...

Page 57: ... s responsibility IBM may have patents or pending patent applications covering subject matter in this document The furnishing of this document does not give you any license to these patents You can send license inquiries in writing to the IBM Director of Licensing IBM Corporation North Castle Drive Armonk NY 10504 1785 USA E 1 Trademarks and Service Marks The following terms used in this document ...

Page 58: ...54 Tivoli ADSM for VM Program Directory ...

Page 59: ... a rating of a 5 represents Very Dissatisfied If a statement does not apply please circle N Satisfaction Ease of product installation 1 2 3 4 5 N Time required to install the product 1 2 3 4 5 N Contents of program directory 1 2 3 4 5 N Readability and organization of program directory tasks 1 2 3 4 5 N Necessity of all installation tasks 1 2 3 4 5 N Accuracy of the definition of the installation ...

Page 60: ...atings above or any other aspect of the product installation please list them below Please provide the following contact information Name and Job Title Organization Address Telephone Thank you for your participation Please send the completed form to the following address or give to your IBM representative who will forward it to the Tivoli ADSTAR Distributed Storage Manager Development group Intern...

Page 61: ......

Page 62: ...IBM Program Number 5697 VM3 5802 6001 Printed in U S A GI1 548 ...