ROBOSAVE (ROBOSV)

ROBOSAVE Version 3.04 A Utility for Saving the OS/2 2.X Desktop User's Guide R. R. Kurtz J. G. Knauth (c) Copyright International Business Machines Corporation 1994. All rights Reserved. 9 Nov 1993 3:04 -- Employee Written Software Edition  9 Nov 1993 3:04 -- Employee Written Software Edition CONTENTS 1.0 ROBOSAVE User's Guide . . . . . . . . . . . . . . . . . . . 1 1.1 What ROBOSAVE Does . . . . . . . . . . . . . . . . . . . . . 1 1.2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 What ROBOSAVE Does Not Do . . . . . . . . . . . . . . . . . 2 1.4 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . 3 1.5 Installation . . . . . . . . . . . . . . . . . . . . . . . . 3 1.6 ROBOSAVE Profile . . . . . . . . . . . . . . . . . . . . . . 3 1.7 ROBOSAVE Command . . . . . . . . . . . . . . . . . . . . . . 6 1.8 Doing a Save . . . . . . . . . . . . . . . . . . . . . . . . 6 1.9 Doing a Restore . . . . . . . . . . . . . . . . . . . . . . 8 1.10 Recovery of Individual Files . . . . . . . . . . . . . . . 10 1.11 Choosing a Save Directory . . . . . . . . . . . . . . . . . 11 1.12 Contents of the Save Directory . . . . . . . . . . . . . . 12 1.13 ROBOSVUT Utility . . . . . . . . . . . . . . . . . . . . . 13 Contents ii 9 Nov 1993 3:04 -- Employee Written Software Edition 1.0 ROBOSAVE USER'S GUIDE This edition of the User's Guide is for the Employee Written Software release of ROBOSAVE. 1.1 WHAT ROBOSAVE DOES ROBOSAVE is a tool which allows you to quickly and easily back up the OS/2 2.x Desktop. In addition you can save a limited number of user- specified files. If problems occur later, you can easily restore the saved information. Because it is so easy to do a ROBOSAVE, you will find that doing frequent backups is quite painless. The OS/2 2.x Desktop consists of control information for such things as folders, program objects, printer objects, and shadows. It also contains data about the tailoring you have done for colors, fonts, titles, window positions, associations, and much more. You may have invested a significant amount of time in adjusting the Desktop to your preferences. ROBOSAVE provides a good way to protect that investment. 1.2 OVERVIEW Using ROBOSAVE is very simple. Here is a summary. Details are in following sections, together with suggestions for how you might plan ROBOSAVE backups for your system. - Installation - Download and unzip ROBOSAVE's zip file into a directory of your choice - Set up a ROBOSAVE profile; you can use ROBOSAVE.SMP as a model - Doing a save - Stabilize the Desktop by doing a shutdown and IPL - Invoke ROBOSAVE, using the profile you created above - Doing a restore - Bring up an OS/2 environment suitable for doing ROBOREST - Switch to the save drive and directory - Invoke ROBOREST - ReIPL ROBOSAVE User's Guide 1 9 Nov 1993 3:04 -- Employee Written Software Edition 1.3 WHAT ROBOSAVE DOES NOT DO ROBOSAVE does not do a full backup of all the data on your system. Instead it saves only certain key information. Part of this informa- tion is saved automatically. Part you must specify thru a profile. A sample ROBOSAVE profile is provided; however, there may be other crit- ical files for your applications that you should specify in your own profile. Restoring this information is often sufficient to get your system working again very quickly. Of course doing a full backup pro- vides a better guarantee of a full recovery. However, doing a full backup requires much more time and more space on your backup medium. From ROBOSAVE's point of view the Desktop consists of the Desktop directory and all the files and directories under it. This is the information ROBOSAVE will save automatically. You must be careful about what information you either remove from or add to that directory tree. If you move an object from the Desktop to some location that is not in the Desktop, ROBOSAVE will NOT save that object. For example, suppose your Desktop directory is C:\DESKTOP. The standard OS/2 install will create a Productivity folder in the OS/2 System folder. Suppose you use the Workplace Shell Drives facility to drag the Productivity folder to some location not in the Desktop, let's say into a C:\MISC directory. From a (FAT) file system point of view, you just moved the C:\DESKTOP\OS!2_SYS\PRODUCTI directory to C:\MISC\PRODUCTI. It is no longer under C:\DESKTOP and will not be automatically saved by ROBOSAVE. Even if you create a shadow on the Desktop of the moved Productivity folder, the moved folder will not be saved because it is no longer in the Desktop. However, if all you do is move the object to another place in the Desktop, e.g., suppose you move it from the OS/2 System folder to the Information folder (assuming this folder itself is still in the Desktop), then the object is still in the Desktop structure and will be automatically saved by ROBOSAVE. This works both ways. If you create directories or files in the Desktop directory tree, ROBOSAVE will consider all that information as part of the Desktop and will save it automatically. Thus you should be careful not to put a bunch of "extraneous" things in the Desktop unless you really do want all that information saved every time you do a ROBOSAVE. ROBOSAVE is not intended to migrate a Desktop from one release (or CSD level) of OS/2 to another. The control information that ROBOSAVE saves from one release of OS/2 may very well not be compatible with another OS/2 release. Similarly, if after you do a ROBOSAVE you then change any fundamental system characteristics (e.g., file system type, display type, or boot drive), restoring the old system's data to the ROBOSAVE User's Guide 2 9 Nov 1993 3:04 -- Employee Written Software Edition new system will not work. ROBOSAVE is intended to backup a system and then restore the data to exactly that same system. ROBOSAVE does not save the information used to automatically restart currently running programs. This is done to prevent restarting ROBOSAVE itself when the restored system is first IPLed. The impli- cation of this is that after your system has been restored, you must restart your normally running programs yourself for the initial IPL. For subsequent IPLs, those programs will be restarted (or not) as usual, depending on the way you have chosen to tailor OS/2 for this restart function. 1.4 PREREQUISITES Your operating system must be either OS/2 2.0 or 2.1. ROBOSAVE does not support earlier releases, e.g., OS/2 1.3. REXX is required in order to use ROBOSAVE. REXX is installed in OS/2 by default. You can use OS/2 Selective Install to add REXX if it is not already present on your system. 1.5 INSTALLATION Download ROBOSAVE's zip file in binary and unzip it into a directory of your choice. Either this directory must be in your PATH, or it should be the current directory when ROBOSAVE is invoked. 1.6 ROBOSAVE PROFILE A profile is required to run ROBOSAVE. See ROBOSAVE.SMP for an example. The profile is an ASCII text file which specifies parameters for operating ROBOSAVE. Usually you will name your profile ROBOSAVE.PRO, although you can give it a different name and then specify that name in the ROBOSAVE command. The profile controls what files will be saved. If you don't specify the right files for saving, they won't be available for restoring -- not good. Please invest the time to set up your profile appropriately to begin with, and keep it up to date as your application environment changes. If an "*" is found in column 1 of a line in the profile, that line is treated as a comment and is ignored. You should not have any blank lines in the profile; a blank line will terminate profile processing. One of the following verbs must start each of the non-comment lines of ROBOSAVE User's Guide 3 9 Nov 1993 3:04 -- Employee Written Software Edition the profile. The verbs can be in any order and can be in upper or lower case. SAVE=directory where "directory" specifies the directory in which ROBOSAVE will save the files to be backed up, together with certain control information. This directory will be created for you if it does not exist. This is a required verb; there is no default. Examples: "save=A:\SAVEDATA" and "save=E:\SV930922". Later sections of the User's Guide provide guidance about choosing a save directory and give details about what is put into it. SAVENUM=number where "number" specifies the number of generations of data that can be saved in this directory. A new generation is created each time you successfully complete ROBOSAVE. When "number" is exceeded, the oldest generation is erased and is replaced by the new generation, the data saved by the current execution of ROBOSAVE. If you reduce "number", all the older generations are erased up to the point where "number" will not be exceeded by the new generation. Valid values are 1 thru 9. This is a required verb; there is no default. CLEANUP=B|E specifies when old generations should be erased if the "SAVENUM=" number is exceeded, as described above. "CLEANUP=B" means erase the data at the beginning of the ROBOSAVE operation, i.e., before the new generation is created. "CLEANUP=E" means erase the old data at the end, i.e., after the new generation has been created. The default is "CLEANUP=E". Erasing at the end is safer, in that the old data will not be erased unless the new generation has been successfully saved. However, erasing at the beginning might be necessary if the save directory is on a drive with little available space; you might need to erase the old generation first to make room for the new generation. LOG=P|T specifies the location of the ROBOSAVE.LOG file. This log records all ROBOSAVE activity for the save directory specified by the "SAVE" verb. "LOG=P" means put the log in the same directory as the ROBOSAVE profile. "LOG=T" means put the log in the save directory. The default is "LOG=P". ROBO=fileid [fileid ...] where each "fileid" specifies one or more files to be saved in the save directory. Normally the complete fileid (drive, path, and file) should be specified, e.g., robo=e:\somedir\myfile.xyz. Multiple fileids can be specified on each ROBO= line. Wildcards, ROBOSAVE User's Guide 4 9 Nov 1993 3:04 -- Employee Written Software Edition both "*" and "?", can be used in the same way they are used in the OS/2 COPY command. If there are any blanks in the fileid, enclose the entire fileid in double quotes. In addition, by enclosing the fileid in brackets, you indicate that directories below the one specified in the fileid should also be searched. Bracketed fileids can be intermixed with normal fileids on the same line. In the following examples, notice the use of double quotes and brackets; the quotes must be outside the brackets when both are used. Profile line Files saved -------------------------- --------------------------------------- robo=d:\os2\*.ini D:\OS2\OS2.INI, D:\OS2\OS2SYS.INI, etc. robo="d:\my dir\my data" D:\MY DIR\MY DATA robo=[e:\*.ini] All .INI files on the E: drive robo=[g:\my*.*] All files on the G: drive whose names start with MY with any extension robo="[g:\Down\U ar*.*]" All files in the G:\DOWN directory (and all its subdirectories) whose names start with "U AR" and any extension robo=c:\x.y d:\dir\ccc.y C:\X.Y and D:\DIR\CCC.Y Examine ROBOSAVE.SMP for a list of additional files you may want to save if you installed OS/2 Windows support, Communications Manager, or LAN Services. You should not attempt to save ". SF" files, e.g., "EA DATA. SF". WARNING: You should be careful with using wildcard characters and/or brackets. It is very easy to unintentionally specify many files you don't really want to backup. This is especially sig- nificant if your save directory is on a diskette, which has less space and operates more slowly than a hard disk. It is also easy to unintentionally save a file multiple times; ROBOSAVE will make a separate copy for each specification, whether it was an explicit specification or by wildcards or brackets. Thus, speci- fying both "robo=e:\abc.ini" and "robo=e:\*.ini" would copy ABC.INI twice. It is a good idea after doing a ROBOSAVE to examine ROBOSAVE.LOG and see exactly which files were copied; then adjust your profile if necessary. Needless to say, having something like "robo=c:\*.*" would attempt to save far more than you really intended; in fact it would likely fail as the process stumbled over certain files that cannot be copied normally. ROBOSAVE User's Guide 5 9 Nov 1993 3:04 -- Employee Written Software Edition 1.7 ROBOSAVE COMMAND Here is the syntax of the ROBOSAVE command. If the "/P" parameter is used, it must be the last parameter specified. ROBOSAVE [[fileid]...] [/P=profile] fileid has the same syntax and meaning as when used in a "ROBO=" line in a ROBOSAVE profile. Specifying a fileid as a ROBOSAVE command parameter has the same effect as specifying it in the profile. Fileids specified in the command are logically merged with those from the "ROBO=" lines of the profile. If no fileid parameter is specified in the ROBOSAVE command, only the fileids from the "ROBO=" lines will be used. /P=profile specifies the profile used by ROBOSAVE. This can be either a complete fileid (drive, path, file) or it can be just the drive and path; in the latter case the file is considered to be named ROBOSAVE.PRO and it must reside in the drive-path directory. If this parameter is not specified, the first occurrence of ROBOSAVE.PRO found in the current directory or PATH is used. Here are some examples: robosave robosave /p=d:\os2tools robosave e:\myapps\myapp.dat g:\temp\some.stf robosave "e:\my dir\my file.dat" "g:\main dir\sub dir" robosave e:\os!2_apps\*.ini /p=d:\my2tool\myprof.xyz robosave [e:\*.ini] "[g:\Down\This\Road\one way.*]" 1.8 DOING A SAVE After you have installed ROBOSAVE and have built your profile, you can invoke it to save your data. In fact, this is the part of ROBOSAVE you will be using most often; it is very easy to do. Before doing the save, however, you should ensure your Desktop has stabilized. In par- ticular, if you have made Desktop changes since you last IPLed, including moving objects around on the Desktop, and you want to be sure all this information is captured, you should shut down your system cleanly and reIPL. Then you can do the save. This is neces- sary because for some control information, OS/2 will not write the data to disk (where it can be copied by ROBOSAVE) until shutdown is done. Other control information is written to disk only occasionally, in a lazy-write fashion. Doing a shutdown will force that information ROBOSAVE User's Guide 6 9 Nov 1993 3:04 -- Employee Written Software Edition to disk, too. Of course after you reIPL, don't start making more Desktop changes before doing the ROBOSAVE. It is preferable to have as little as possible going on while ROBOSAVE is running to lessen the chance that any data will be changing while it is being saved. If that happens, the saved data might be inconsistent and any subsequent restore from it might not produce what you want. ROBOSAVE runs quickly. Be patient and let it operate without interference. Now to do the save. Normally you just enter "ROBOSAVE" at an OS/2 command prompt, either full screen or windowed. If necessary, you can specify ROBOSAVE command parameters, as described in the preceding section. However most people will specify all fileids via "ROBO=" lines in their profile and will put their profile in a directory in their PATH; if you do this, no command parameters are necessary -- you can just say "ROBOSAVE". If you want to be fancier about ROBOSAVE invocation, you can build an OS/2 program object and then doubleclick on its icon to do a ROBOSAVE. To build such an object, drag a program object from the Templates folder. Then fill in the blanks as follows: - On the Program page: - Set "Path and file name" to "x:\path\ROBOSAVE.CMD". Replace "x:\path" with the drive and directory where you put ROBOSAVE. - Set "Parameters" with whatever parameters you need (usually leave this blank). - Set "Working directory" with ROBOSAVE's directory, i.e., with your values for the "x:\path" mentioned in the first item. - On the Session page: - Uncheck "Close window on exit". This is necessary to allow you to see any error messages before the window is closed. When you are finished with ROBOSAVE, just close the window as you normally would, e.g., by doubleclicking on the system icon in the upper left corner of the window. - On the General page: - Change "Title" to whatever you want to show up under the pro- gram's icon. If you have done all the preceding steps, the icon shipped with ROBOSAVE should already be displayed. WARNING: Needless to say, if you wait to do a backup until AFTER you have had a problem, then any restore with that backup data will just put you right back in the problem state again. Thus you need to do backups BEFORE you have a problem. Generally, you should do a backup ROBOSAVE User's Guide 7 9 Nov 1993 3:04 -- Employee Written Software Edition after any major change if you are satisfied with the results of that change. This will give you a checkpoint of a system that you are now satisfied with, but before you or some outside force messes it up. Of course this assumes you have been following this procedure all along and thus already have a good backup of the system BEFORE making the major change. If you don't have such a BEFORE-the-change backup already, then make one first. Because ROBOSAVE is so easy to use and takes only a few minutes at most, it is very easy to do all this. Just be sure to label your backups so you'll know what you've got. We recommend doing major backups to diskettes (freshly formatted and still empty) -- one backup per diskette. 1.9 DOING A RESTORE Suppose disaster has just struck. Maybe you accidentally powered off your system without doing a shutdown first, or possibly a power outage occurred. Both of these can result in a corrupted Desktop. Or maybe you got overenthusiatic while you were tidying up your Desktop and dropped the wrong thing on the shredder. Or maybe you encountered a programming bug. Or maybe your hardware hiccupped. Or ... you get the idea. If you have been faithfully doing ROBOSAVEs and have been saving the right data, you can probably recover your system completely and quickly. It is important to realize that the system will be restored back to the point it was at when you did the ROBOSAVE for that data. If you made any changes after that ROBOSAVE, those changes may be lost. This points out the desirability of doing frequent ROBOSAVEs and keeping your profile up to date. Part of the data created by ROBOSAVE in your save directory is a ROBOREST.CMD. Executing that command will restore the data saved by the ROBOSAVE you issued most recently to that save directory. If you have saved multiple generations in the same save directory, there will be a ROBOREST.CM1, a ROBOREST.CM2, etc. These represent the next older generation, and the next older beyond that, etc., with the oldest having the highest .CMn number. If you want to recover a pre- vious generation instead of the most recent, just rename ROBOREST.CMD to some other name, e.g., ROBOREST.CUR, and then rename the desired ROBOREST.CMn to ROBOREST.CMD. You can examine ROBOSAVE.LOG to see when each save was done and what files were associated with each. You can doublecheck the chosen command file to ensure it is the desired one. Before invoking ROBOREST, you must first set up the proper OS/2 envi- ronment. You cannot simply issue ROBOREST from an OS/2 command prompt in your normal system since some of the files ROBOREST will try to replace are in use by the normal system. You must establish an envi- ronment independent of your normal system and issue ROBOREST from ROBOSAVE User's Guide 8 9 Nov 1993 3:04 -- Employee Written Software Edition there. Fortunately that is easy to do. Below are three different techniques you can use. They produce equivalent results. Use the one that is most convenient for you. ROBOREST will attempt to verify that you have established a proper environment. If it detects something is wrong, it will display an error message and stop the procedure without making any changes to your system. Part of the recovery procedure involves erasing the old (possibly corrupted) Desktop before restoring the saved Desktop. You will be prompted for final authorization before this is done. If you answer anything other than "YES", the ROBOREST procedure will stop and no changes will be made to your system. You should make sure you don't have a directory in the Desktop tree as the current directory for its drive. For example, if C:\DESKTOP is your OS/2 Desktop directory, make sure you haven't done a CHANGEDIR on C: to \DESKTOP or to any of the directories under it. Having any of those directories as the current directory would interfere with the deletion of the Desktop tree. ROBOREST (ROBOSVUT) will fail if you make this mistake and will issue an error message. If this happens, just do a "CD \" and reissue ROBOREST. Except for the OS2.INI and OS2SYS.INI files, ROBOREST will restore the same Readonly, System, and Hidden attributes for each file that existed when you saved the file with ROBOSAVE. Restoring the Desktop - Method 1 This method requires you to have the Install and DISK 1 diskettes for the version of OS/2 you booted when you did the save. It is required that the OS/2 level of the diskettes must match exactly the level of the system being restored, including the CSD level. (In fact you may be able to get away with a different level sometimes, but other times you can't. Since failure can result in a corrupted system, we require the levels to be the same.) Instead of using the actual installation diskettes, you might use something equivalent, e.g., a diskette you have created with the BOOTOS2 tool (also known as BOOT2X); the diskette must be at the correct OS/2 level, of course. Or you might boot from another partition (at the correct OS/2 level, of course). - Boot from the OS/2 2.x Install and DISK 1 diskettes. - ESC to the OS/2 prompt when allowed. - Place your "save" diskette in A: if restoring from diskette. - Change to the "save" drive you will restore from. - Change to the "save" directory containing ROBOREST.CMD. - Invoke ROBOREST; there are no parameters. - Respond YES when prompted to delete the Desktop. - Re-boot when the restore is complete. ROBOSAVE User's Guide 9 9 Nov 1993 3:04 -- Employee Written Software Edition Restoring the Desktop - Method 2 This method requires that the SHFTRN package be installed on your system. It must be on your hard drive and your CONFIG.SYS must have been edited to place the call to SHIFTRUN in it. This method is faster than Method 1 and does not require the two OS/2 installation diskettes. - Get the SHFTRN package from the same place you got ROBOSAVE. - Download and install it as directed. - Re-boot. - Press Left-Shift when the SHIFTRUN timer appears, then release it. - Place your "save" diskette in A: if restoring from diskette. - Change to the "save" drive you will restore from. - Change to the "save" directory containing ROBOREST.CMD. - Invoke ROBOREST; there are no parameters. - Respond YES when prompted to delete the Desktop. - Re-boot when the restore is complete. Restoring the Desktop - Method 3 This method is similar to using SHFTRN, but does not require the SHFTRN tool. It is quick and straightforward. The tradeoff is that you must edit CONFIG.SYS before using ROBOREST. You could make this your standard CONFIG.SYS, but then you would need to do an EXIT at the command prompt for every IPL. SHFTRN doesn't require that. - Edit CONFIG.SYS to put this line at the end, where "x:" is your boot drive: CALL=x:\OS2\CMD.EXE /K - IPL; eventually you will get a command prompt. - Place your "save" diskette in A: if restoring from diskette. - Change to the "save" drive you will restore from. - Change to the "save" directory containing ROBOREST.CMD. - Invoke ROBOREST; there are no parameters. - Respond YES when prompted to delete the Desktop. - Re-boot when the restore is complete. 1.10 RECOVERY OF INDIVIDUAL FILES ROBOSAVE can also be useful if you have lost one or a few of your saved files instead of losing the whole Desktop. For example, if you have accidentally erased your CONFIG.SYS, you can look at ROBOSAVE.LOG to see the name under which it was copied to your save directory. Then just copy it back to your boot drive and rename it to CONFIG.SYS. ROBOSAVE User's Guide 10 9 Nov 1993 3:04 -- Employee Written Software Edition 1.11 CHOOSING A SAVE DIRECTORY There are some decisions you need to make when choosing a save direc- tory. You can place the directory either on a diskette or on a hard drive. Placing the data on a diskette isolates it from the system and gives you some additional reliability. For example, if the system hard drive itself fails, you can reinstall OS/2 and your applications on a repaired drive and then use ROBOSAVE to reapply all your tai- loring. You can easily and inexpensively keep multiple generations of backups on separate diskettes with one generation per diskette. Then just rotate thru the set of diskettes; when you are ready to do the next ROBOSAVE, format the diskette that holds the oldest generation and use it for the new save. Then even if your most recent backup is lost because for some reason the diskette holding it is no longer readable (it happens more often than you would like to think), you can go back to the next most recent backup on a separate diskette. On the other hand, saving to a diskette is much slower than saving to a hard drive. Also, if the amount of data to be saved is large, you may exceed a single diskette's capacity; ROBOSAVE does not support diskette spanning. For a typical system the diskette space constraint will not be a problem, particularly if you dedicate each diskette to a single generation of saved data. Normally the amount of data that should be saved is well under a megabyte. However, you might have a special case and have a large amount of data to save. A good technique is to combine the two media approaches by making fre- quent (quick) saves to a hard drive, but making occasional saves to the next available diskette, e.g., after you have made some partic- ularly important change to your system. Also, if your saved data is too large for a diskette, you can save it to a hard drive and then later use a data compression program, such as PKZIP, to produce a file small enough to store offline on a diskette. Note there was a problem in OS/2 2.0 in which the OS2.INI and OS2SYS.INI files tended to grow very large; that problem seems to have been much alleviated in OS/2 2.1. Another consideration with choosing a save directory is whether to use the root directory as the save directory, even on a dedicated diskette. Generally that is not a good idea since for the FAT file system (which is the system used for diskettes) there is a limit to how many files can be stored in the root directory. The limit depends on the size of the hard disk or diskette involved, but is typically not much greater than several hundred files. On the other hand, a subdirectory does not have such a limit. Thus it is a good idea to ROBOSAVE User's Guide 11 9 Nov 1993 3:04 -- Employee Written Software Edition specify something like "SAVE=A:\SAVEDIR" rather than "SAVE=A:\" in your profile. 1.12 CONTENTS OF THE SAVE DIRECTORY In your ROBOSAVE profile you designate a save directory thru the "SAVE=" verb. When you invoke ROBOSAVE, Desktop data and the files you specified are saved there, together with some ROBOSAVE control information. Here are the types of files you may see in the save directory. Each "n" represents a decimal digit. nnnnnnnn.FIL - A "robo=" file or a file from a Desktop directory nnnnnnnn.EAS - Extended Attributes from a file or Desktop directory ROBOREST.CMD - Restore command created by the most recent ROBOSAVE ROBOREST.CMn - Restore command created by a previous ROBOSAVE ROBOSVUT.EXE - Module to check the OS/2 state and erase the Desktop ROBOSAVE.LOG - Records all ROBOSAVE activity for this save directory ROBOSAVE.MRK - File containing last used nnnnnnnn value All saved files and all files holding split extended attributes are named with a numeric filename (nnnnnnnn) when put into the save direc- tory. The numeric value is incremented as each file is created. A check is made to ensure that the next value to be used is not already in use in this save directory; if it is in use, the value is incre- mented until a free value is found. Using a numeric name instead of the real name solves several problems. It avoids ambiguity when two files with the same name are saved from different directories, or when the same file is saved multiple times in multiple generations. It also allows files with long HPFS names to be easily saved in a FAT save directory, e.g., on a diskette. The original name is restored by the ROBOREST.CMD when it is executed. You can see the correspondence between the nnnnnnnn names and the real names by looking at ROBOSAVE.LOG or the appropriate ROBOREST command. The "SAVENUM=" verb in the ROBOSAVE profile controls how many gener- ations of data will be kept in the save directory. ROBOREST.CMD is associated with the most recent ROBOSAVE. Each ROBOREST.CMn file is a renamed ROBOREST.CMD that is associated with a preceding generation. When the number of generations exceeds the "SAVENUM=" value, the oldest ROBOREST.CMn file and all the files it points to will be deleted from the save directory. For example, if you have SAVENUM=3, the following ROBOREST.CMn files would be kept in the "SAVE=" direc- tory. ROBOREST.CMD --> most recent ROBOREST.CM1 --> 2nd most recent ROBOREST.CM2 --> 3rd most recent ROBOSAVE User's Guide 12 9 Nov 1993 3:04 -- Employee Written Software Edition If you run ROBOSAVE again, ROBOREST.CM2 and all the files it points to will be deleted. ROBOREST.CM1 will be renamed to ROBOREST.CM2 and ROBOREST.CMD will be renamed to ROBOREST.CM1. A new ROBOREST.CMD will be written containing commands to restore the data saved by the current run. 1.13 ROBOSVUT UTILITY ROBOSVUT.EXE is a utility module which is used by both ROBOSAVE.CMD and ROBOREST.CMD. It accesses some low-level OS/2 services that are not directly available thru OS/2 commands or REXX functions. ROBOSAVE.CMD uses ROBOSVUT to copy files which for some reason cannot be copied by the OS/2 COPY command. For example, this can happen if a file has already been opened by some other process at the time ROBOSAVE tries to COPY it. In that case you will see a message from ROBOSAVE.CMD that the COPY failed and that now ROBOSVUT will be tried. ROBOSVUT will usually succeed in this situation. ROBOSAVE.CMD will also use ROBOSVUT to copy files that have been marked with the Hidden or System attribute; OS/2 COPY cannot find such files. A consider- ation with using ROBOSVUT to copy a file is that it will not save the file's extended attributes. For the files ROBOSVUT is typically used to save, that is not important because they do not have extended attributes. ROBOREST.CMD uses ROBOSVUT to verify the OS/2 environment before pro- ceeding. ROBOSVUT will check that the right level of OS/2 has been IPLed to do the ROBOREST; it must be the level that was used to do the ROBOSAVE. This check will detect most errors, but it will not detect if there is a CSD mismatch. ROBOSVUT will also verify that the OS/2 Workplace Shell is not active for the Desktop being restored; if it were active, the restore would very likely be unsuccessful, or at least the results would be unpredictable. (Note that the Workplace Shell CAN be active for a different Desktop; thus it is valid to IPL from a different partition with its own Desktop to do the ROBOREST of the inactive partition you want to recover.) Finally, if all the tests are passed, the user will be prompted for authorization to erase the Desktop to prepare a clean slate for the restoration of the saved Desktop. If the user answers "YES", ROBOSVUT will erase the Desktop directory tree and then return to ROBOREST, which will then do the actual restore. Here are the return codes from ROBOSVUT.EXE. If an OS/2 function returns an error code to ROBOSVUT, both the OS/2 function name and the returned error code are displayed in addition to ROBOSVUT's own return code from the following list. ROBOSAVE User's Guide 13 9 Nov 1993 3:04 -- Employee Written Software Edition 1 - Error. Opening source file for reading. 2 - Error. Opening target file for writing. 6 - Error. Unable to clear attributes on target. 11 - Error. DosAllocMem failed. 12 - Error. DosQuery failed for source. 13 - Error. DosQuery failed for target. 14 - Error. Open (READONLY) failed for target. 15 - Error. Read failed for source. 16 - Error. Write failed for target. Target disk full? 17 - Error. Close failed for target. 20 - Error. Unable to update attributes/timestamp for target. 21 - Error. VERIFY_COPY failed. 100 - Copy was successful. 199 - Desktop deleted successfully for ERASE_DESKTOP. 200 - User answered "NO" to prompt for ERASE_DESKTOP. 201 - Error. DosFindFirst failed for directory. 202 - Error. DosFindFirst found other than "." entry. 203 - Error. DosDelete failed. 204 - Error. DosFindNext failed. 205 - Error. DosFindClose failed. 206 - Error. DosDeleteDir failed. 207 - Error. Maximum number of DosFindFirst/DosFindNexts exceeded. 251 - Error. DosQuerySysInfo failed. 252 - Error. DosOpen failed for test file. 253 - Error. DosClose failed for test file. 254 - Error. DosSetCurrentDir failed. 300 - Error. DosOpen of test file detected Workplace Shell open. 301 - Error. OS/2 version mismatch between ROBOSAVE and ROBOREST. Note: If Ctrl-Break is pressed while ROBOSVUT is working or if the user selects "End the program" for an OS/2 disk error prompt, a 99 can be returned by the system to the invoker of ROBOSVUT. ROBOSAVE User's Guide 14