SAVTAATOOL SAVE TAATOOL LIBRARIES TAASAVP
The Save TAATOOL Libraries command is intended for those users who want to restore the TAA Productivity Tool early during a disaster recovery. This allows the TAA Productivity Tools to be used to assist in restoring the rest of the system. ***************************************************** * * * If your disaster recovery solution is * * to restore all of the libraries (both * * system and user) before using any of * * the TAA Productivity Tools, you should * * not consider SAVTAATOOL. * * * ***************************************************** The TAA Productivity Tools such as RSTALLLIB, RSTMNYLIB, and RSTALLCHG can be used to improve your critical recovery needs by allowing you to do selective restores or restore multiple libraries whether the tapes were created with a LIB(*nnn) on the save commands or not. SAVTAATOOL can be used with either of two special libraries $$TAATOOL or Q$$TAATOOL. These will be described as 'backup libraries'. Save files are used in the backup libraries to save the TAATOOL and TAASECURE libraries. The use of the special library names allows the library containing the save files to be restored by a single RSTLIB command (this does not restore the TAATOOL or TAASECURE libraries). The special TAASAVPC program (exists in the backup libraries) can then be used to restore the TAA Productivity Tool libraries from the save files. The TAA Productivity Tool commands can then be used to restore the remainder of the system. The TAAWORK library is not saved by SAVTAATOOL. The TAAWORK library is used by various tools for temporary work objects. The typical tools you would use to help restore the system do not use TAAWORK. To determine whether to use $$TAATOOL or Q$$TAATOOL as your backup library, you must first consider your save/restore strategy. ** The $$TAATOOL library is intended for those users who use SAVLIB LIB(*NONSYS) or the Operational Assistant option to save the entire system. When *NONSYS is used, both user and system libraries are saved in alphabetical sequence. Using the name $$TAATOOL will place that library at or near the beginning of the tape. If the Operational Assistant option was used, the library will be after the libraries saved by SAVSYS. ** The Q$$TAATOOL library is intended for those users who use SAVLIB LIB(*IBM) and then SAVLIB(*ALLUSR). Using the library name Q$$TAATOOL will place the library at or near the beginning of the SAVLIB(*IBM) tape. SAVLIB LIB(*IBM) saves all Qxxx libraries that are not in a specific list. To successfully use the SAVTAATOOL approach, you must properly save the backup library and the save files. The default on the SAVLIB commands is SAVFDTA(*YES). This must be used to allow for a restore. Space considerations -------------------- To use the SAVTAATOOL function as intended will require save files to exist in your backup library with compressed versions of the TAATOOL and TAASECURE libraries. ** For a CISC system (prior to V3R6), this will require approximately 50 MB. ** For a RISC system (V3R6 and after), this will require approximately 90 MB. Getting started --------------- Once you decide which special library you want to use, a user with *ALLOBJ special authority must use the CRTSAVTAA command to create the required library. For example, to use the Q$$TAATOOL library, the following command should be run (it is a short running command): CRTSAVTAA LIB(Q$$TAATOOL) When the command completes, the library will exist with the save files TAATOOL and TAASECURE plus the special restore program TAASAVPC. Note that the libraries have not been saved. Any user with *SAVSYS authority can then use the save command such as: SAVTAATOOL to save the libraries to the save files. This is a long running command and should be submitted to batch. SAVTAATOOL determines which library ($$TAATOOL or Q$$TAATOOL) is being used, ensures the proper objects exist, and saves the TAATOOL and TAASECURE libraries in a compressed format to the save files. You may want to consider using SAVTAATOOL periodically to ensure that the libraries are current. See the later discussion on use of SAVTAATOOL. The CRTSAVTAA command may also be used anytime the objects must be re-built. See the later discussion on changing the TAASAVPC program. Automatic SAVTAATOOL on Install of TAA Productivity Tools --------------------------------------------------------- When the TAA Productivity Tools are installed and either the $$TAATOOL or Q$$TAATOOL exist, a job is automatically submitted to do SAVTAATOOL. This occurs when any update or new release of the product is installed. This ensures that the new version is properly saved in the backup library. During the install processing, a check will be made for the TAASAVPC program in the backup libraries. If the program exists, the new version of the program will replace the existing version. Restoring from $$TAATOOL or Q$$TAATOOL -------------------------------------- In a disaster recovery situation, you would normally install the LIC (Licensed internal code) and then i5/OS. Then there are important steps such as: - RSTUSRPRF - RSTCFG At the point where you are ready to restore: - The remaining system libraries from a SAVLIB(*IBM) or - Restore from a SAVLIB(*NONSYS) is when you would typically want to restore the TAA Productivity Tools. The library you selected ($$TAATOOL or Q$$TAATOOL) would normally be restored by the normal RSTLIB command such as: RSTLIB SAVLIB($$TAATOOL) Assuming your save strategy is consistent with your backup library, the backup library should be at or near the front of the saved media. Once the library is installed, a user with *ALLOBJ special authority should call the TAASAVPC program in the specified library. For example, if you created $$TAATOOL, the command would be (the command could be submitted to batch if a batch subsystem is running): CALL PGM($$TAATOOL/TAASAVPC) This will restore the TAATOOL and TAASECURE libraries. The TAA Productivity Tool commands may then be used to assist in restoring the remainder of the system. All of the product including the commands, command help text, the HELPTAA menu, and documentation would then be available. If you have a tape from SAVLIB LIB(*xxx), the first file (sequence number 1) contains a list of libraries that is used by the corresponding RSTLIB SAVLIB(*xxx) function. To use a TAA Productivity Tool command like RSTALLLIB, you must specify SEQNBR(2) to start with the first library after the special first file. Use of a Command Library for TAA Tool Commands ---------------------------------------------- If you are using a command library for TAA Tool commands such as TAACMD, you do not have to save or restore the library to use the SAVTAATOOL concept. All TAA commands are always in the TAATOOL library. You must have the TAATOOL library on your library list when using a command like RSTALLLIB for disaster recovery. Normal saves of the TAATOOL and TAASECURE libraries --------------------------------------------------- If you follow the intent of the SAVTAATOOL function, there should be no reason to backup the TAATOOL and TAASECURE libraries thru the use of SAVLIB LIB(*NONSYS) or SAVLIB(*ALLUSR). You may use the OMITLIB parameter to omit the libraries. If you save the libraries on the normal save media (without using OMITLIB), the following considerations exist if you first restore from the backup library. ** The system RST commands will probably operate successfully and restore over the top of existing objects in TAATOOL and TAASECURE. If the the same version of the libraries is restored, there should be no difference. If the versions differ, there may be error conditions that would have to be handled manually. ** If the TAA Productivity tool commands RSTALLLIB, RSTMNYLIB, or RSTALLCHG are used, the TAATOOL library is automatically bypassed because the program that is running is in TAATOOL. The TAASECURE library would be restored over the existing objects. Use of SAVTAATOOL ----------------- Each time SAVTAATOOL is used, the command determines that the proper objects exist in either $$TAATOOL or Q$$TAATOOL and then saves the TAATOOL and TAASECURE libraries in a compressed format to save files in the backup library. In some unique situations you may want to use both libraries. If both libraries exist, both will be saved to. You would normally want to include the SAVTAATOOL command in a regular backup procedure to ensure that any changes in the TAATOOL and TAASECURE libraries are backed up. A previous section has discussed the use of the automatic save that occurs during the install of a new update or release of the TAA Productivity Tools. This ensures that at least a base level version of the tools will exist. See the discussion on the HELPTAA menu of 'Backup considerations' for the types of changes that can occur in the TAATOOL and TAASECURE libraries. The major reason for a change in the TAATOOL library would be if you re-created one of the tools. Tailoring the TAASAVPC restore program -------------------------------------- In most cases there should not be a need to tailor the special restore program. If you do, follow the instructions for 'Modifying a tool' on the HELPTAA menu. You should re-create the new version in the TAATOOL library and then use CRTSAVTAA. CRTSAVTAA will ensure that the proper save files exist and create them if they do not. It will also delete the current version of the TAASAVPC program and duplicate the version from TAATOOL. Note that during install of a new update or release of the TAA Productivity Tools, the latest version from the TAATOOL library of TAASAVPC will be placed into your backup library. Therefore, if you have modified the TAASAVPC program, you must go thru the steps again to re-create the tool and then use CRTSAVTAA to get your tailored version of the object into your backup library. CRTSAVTAA Command *CMD ----------------- LIB The library to be designated as the backup library. Either $$TAATOOL or Q$$TAATOOL must be specified. SAVTAATOOL Command *CMD ------------------ No parameters exist. Restrictions ------------ There are several restrictions discussed throughout. The following are the major considerations. ** The backup library chosen must be consistent with your save strategy. ** SAVFDTA(*YES) must be specified (or defaulted to) on your normal backup such as SAVLIB LIB(*NONSYS). ** Only a user with *ALLOBJ special authority can use CRTSAVTAA to create or refresh the backup library objects. ** Only a user with *SAVSYS special authority can use the SAVTAATOOL command. ** Only a user with *ALLOBJ special authority can use the special restore program. ** If you are changing objects in TAATOOL or TAASECURE, you should ensure a regular backup using SAVTAATOOL Prerequisites ------------- The following TAA Tools must be on your system: CHGLIBOWN Change library owner CHKALLOBJ Check *ALLOBJ special authority SNDCOMPMSG Send completion message SNDDIAGMSG Send diagnostic message SNDESCMSG Send escape message SNDSTSMSG Send status message Implementation -------------- The tool is ready to use, but CRTSAVTAA must be used to create the backup library. SAVTAATOOL must be used after the backup library has been created. Objects used by the tool ------------------------ Object Type Attribute Src member Src file ------ ---- --------- ---------- ---------- SAVTAATOOL *CMD TAASAVP2 QATTCMD CRTSAVTAA *CMD TAASAVP3 QATTCMD TAASAVPC *PGM CLP TAASAVPC QATTCL TAASAVPC2 *PGM CLP TAASAVPC2 QATTCL TAASAVPC3 *PGM CLP TAASAVPC3 QATTCL The TAASAVPC program also exists in the backup library. Structure --------- SAVTAATOOL Cmd TAASAVPC2 CL pgm CRTSAVTAA Cmd TAASAVPC3 CL pgm