home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / wpssafe1.zip / WPSsafe.txt < prev   
Text File  |  1994-02-21  |  4KB  |  99 lines
  1.  
  2. WPSsafe(1)                     LOCAL                        WPSsafe(1)
  3.  
  4.  
  5. NAME
  6.      WPSsafe - A WorkPlace Shell backup/restore program
  7.  
  8. SYNOPSIS
  9.      wpssafe {backup_name} [!]
  10.  
  11. DESCRIPTION
  12.      WPSsafe is the easiest way to backup your current WorkPlace Shell
  13.      desktop, user, and system INI files.
  14.  
  15. PREREQUISITES AND LIMITATIONS
  16.      WPSsafe requires GTAK, currently the best GNU TAR port to OS/2. It
  17.      is used to store the current desktop directory as-is.  At the
  18.      moment GTAK seems to be the only free program to do it properly.
  19.      To my experience Info-ZIP is a no-go solution.
  20.  
  21.      For GTAK you need only the tar.exe, no settings are required for
  22.      WPSsafe.
  23.  
  24.      WPSsafe requires the backup target directory (SafeDir) to be on a
  25.      HPFS volume.
  26.  
  27.      Before restoring the desktop you do NOT have to erase the current
  28.      desktop.  Instead you have to reboot and do it before launching
  29.      WordPlace Shell.  One tedious way is to boot from floppies.  A lot
  30.      easier way is to use an excellent IBM EWS ShiftRun (or similar) to
  31.      launch CMD.EXE just before WPS (first example below).  Another
  32.      workable solution is the second example below.
  33.  
  34.         1: CALL=...\ShiftRun.exe 5 \OS2\Cmd.exe
  35.         2: CALL=\OS2\CMD.EXE
  36.  
  37.      You should customize WPSsafe to suit your own environment.
  38.      See later under LOCALIZATION.
  39.  
  40.      This program has only been tested with OS/2 2.1 GA at the moment.
  41.  
  42. OPTIONS
  43.      backup_name    This should preferably be current date in the form
  44.                     YYMMDD so that you can easily track older desktops
  45.                     if needed.  Naming conventions are up to the user,
  46.                     not author.
  47.  
  48.      !              Initiates the restoration of desktop and inis.
  49.                     See PREREQUISITES AND LIMITATIONS!
  50.  
  51.                     Please reboot immediately after restoration.
  52.  
  53. FILES
  54.      Desktop.#.tar  Desktop directory tree tar with all directories,
  55.                     files, and extended attributes.
  56.      OS2.INI.#      Current user ini file from boot volume's \OS2
  57.                     directory.
  58.      OS2SYS.INI.#   Current systen ini file from boot volume's \OS2
  59.                     directory.
  60.  
  61.      '#'  Stands for the program option 'backup_name'.
  62.  
  63. LOCALIZATION
  64.      You'll have to localize WPSsafe.cmd to suit your own environment.
  65.      This consists of redefining the environment variables DESKTOP,
  66.      BOOTVOL, and SAFEDIR.  Be careful with all the slashes and
  67.      backslashes.
  68.  
  69.      For OS/2 v2.0 DESKTOP you propably have to use quotes around the
  70.      directory name because of the spaces in it.
  71.  
  72.      SAFEDIR has to be on a HPSF volume.
  73.  
  74. IMPROVEMENT IDEAS
  75.      Change this to a REXX program and pass the backup name
  76.      automatically to the tar and copy statements. Personally I don't
  77.      think this is much of an improvement to the current version.
  78.  
  79.      REXX version: I recommend naming the backups with statement
  80.      "Backup_name = Date('Sorted')".
  81.  
  82. BUGS
  83.      Shouldn't be any... but you never know.
  84.  
  85. HISTORY OF RELEASES
  86.      0   (4-Aug-93)  First release for personal usage only.
  87.      1  (17-Sep-93)  First public release.
  88.  
  89. CREDITS
  90.      Andreas Kaiser for his excellent GNU TAR port to OS/2.
  91.  
  92. AUTHOR
  93.      Kari Mattsson  (karmat@utu.fi)
  94.  
  95.      If you have questions and/or problems, please Email to me.  Other
  96.      than that you are on your own here.  I'm not responsible to any
  97.      loss of data.
  98.  
  99.