home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / zbkup131.zip / ZBACKUP.HLP < prev    next >
Text File  |  1995-04-20  |  13KB  |  363 lines
  1. ╔═══════════════════════════════════════════════╗
  2. ║ ZBackUp Version 1.31                     Help ║
  3. ║───────────────────────────────────────────────║
  4. ║ Copyright (c) 1994, 1995 by Dynamic Solutions ║
  5. ╚═══════════════════════════════════════════════╝
  6.  
  7. Purposes of ZBackup:
  8.  
  9. o In general, provides a simple and convenient
  10.   interface for using PKZIP and PKUNZIP.
  11.  
  12. o Provides a simple scrollable directory listing
  13.   of any and all subdirectories in which the user
  14.   can select subdirectories or individual files
  15.   that are to be backed up or restored using PKZIP
  16.  
  17. o A convenient way to look at directory listings
  18.   as well as ZIP file contents.
  19.  
  20. Backup Mode Screen Layout
  21. ═════════════════════════
  22.  
  23.    ┌──────────────────────────┐┌──────────────┐
  24.    │    directory listing     ││  selected    │
  25.    │                          ││  dataset     │
  26.    │                          ││  items       │
  27.    │   (DIR)     ╔════════════════╗           │
  28.    │             ║  available     ║   (SEL)   │
  29.    │             ║  datasets      ║           │
  30.    │             ║                ║           │
  31.    │             ║     (DST)      ║           │
  32.    │             ║                ║           │
  33.    └─────────────║                ║───────────┘
  34.                  ║                ║
  35.                  ╚════════════════╝
  36.  
  37. Restore Mode Screen Layout
  38. ══════════════════════════
  39.  
  40.    ┌──────────────────────────────────────────┐
  41.    │ contents of a selected ZIP file          │
  42.    │ or messages from PKZIP/PKUNZIP           │
  43.    │                                          │
  44.    │  (RES)      ╔════════════════╗           │
  45.    │             ║  available     ║           │
  46.    │             ║  ZIP files     ║           │
  47.    │             ║  to be         ║           │
  48.    │             ║  restored      ║           │
  49.    │             ║                ║           │
  50.    └─────────────║     (ZIP)      ║───────────┘
  51.                  ║                ║
  52.                  ╚════════════════╝  
  53. Keys Available
  54. ══════════════
  55.    DIR  SEL  DST  RES  ZIP
  56.    ───  ───  ───  ───  ───
  57.     X    X    X    X    X  F1 = this Help file
  58.     X    X         X       F8 = Execute backup
  59.                                     or restore
  60.     X                      Tab= go to DSI window
  61.                              only when it
  62.                              contains data
  63.          X                 Tab= go to DIR window
  64.     X              X       Spc= select/deselect
  65.     X    X         X       Esc= exit program
  66.               X         X  Esc= exit pop on window
  67.     X                   X  Enter= go to directory
  68.               X            Enter= list dataset
  69.                         X  Enter= list zip file
  70.  
  71.    DIR  SEL  DST  RES  ZIP
  72.    ───  ───  ───  ───  ───
  73.     R    R    R            R  = go to Restore
  74.                    B    B  B  = go to Backup
  75.     D                   D  D  = change drive
  76.                    A       A  = mark all items
  77.     U    U         U       U  = unmark all items
  78.     L    L                 L  = list datasets
  79.                    L       L  = list zip files
  80.     S    S    S            S  = save dataset
  81.  
  82. Sorts
  83. ═════
  84.  
  85.     Alt-E = sort listings by extension
  86.     Alt-N = sort listings by filename
  87.     Alt-D = sort listings by date + time
  88.     Alt-P = print current window contents
  89.  
  90.     Sorts will not be executed if the amount of
  91.     data in the list exceeds the maximum number
  92.     of items allowed in the data buffer.  This
  93.     maximum is set when loading the program, ie.
  94.     ZBACKUP 512 allows for 512 items per list in
  95.     memory at one time, therefore a list of 513
  96.     items will not be sorted.  Loading the program
  97.     with a simple ZBACKUP command will set the
  98.     buffer at 5 times the number of lines in the
  99.     listbox.  This allows you to manage your
  100.     memory on older machines.  512 would the
  101.     recommended maximum to allow.  If you run out
  102.     of memory, then edit ZBACKUP.BAT and lower or
  103.     even remove the number.
  104.  
  105.     The current sort is displayed at the bottom of
  106.     each listbox, ie. <None>, <Ext>, <Name>, or
  107.     <Date>.  Note that even though the DIR listbox
  108.     is sorted by date, the SEL listbox has no date
  109.     to sort, so it's sort may remain as the
  110.     previous sort.
  111.  
  112.            ═══════════════════════════
  113.            BACKUP GENERAL INSTRUCTIONS
  114.            ═══════════════════════════
  115.  
  116. NOTE:  All files (system, hidden, and archived
  117.        also) will be displayed in the file lists.
  118.  
  119. Select all files/directories to be backed up ---
  120. ════════════════════════════════════════════
  121.  
  122.    To move to another drive ---
  123.    ────────────────────────
  124.    - Press 'D'
  125.    - Type the desired drive into the pop-on box.
  126.  
  127.    To move to another directory ---
  128.    ────────────────────────────
  129.    - To go to a previous/parent directory either,
  130.      move your cursor to the top .. line of the
  131.      listing and then press ENTER
  132.    - To go into a subdirectory, move your cursor
  133.      to the desired subdirectory; press ENTER.
  134.  
  135.    To mark/select the files/subdirectories ---
  136.    ───────────────────────────────────────
  137.    - The .. file at the list top is NOT selectable
  138.    - Use the up/down ARROW KEYS to move to the
  139.      file/subdirectory desired
  140.    - Use the SPACE BAR to select/deselect
  141.    ' ──»' indicates a directory which has some of
  142.           its contents marked; to mark all files
  143.           in this directory, unmark then remark by
  144.           pressing the SPACE BAR twice.
  145.    '═══»' indicates a completely marked directory
  146.    '═══' indicates a file that is marked
  147.    '«═══' indicates a file/directory that is not
  148.           marked directly but is contained in a
  149.           marked parent directory
  150.    - A maximum of 200 is set for the number of
  151.      marked items due to the extreme time it takes
  152.      PKZip to process more than 100 files (5
  153.      minutes or more, depending upon the processor
  154.      speed).
  155.  
  156.    To look at currently selected files
  157.    ───────────────────────────────────
  158.    - The right window displays all currently
  159.      selected files/subdirectories.
  160.    - Tab key toggles between left & right windows
  161.      only when the right window contains data
  162.    - The right window is also scrollable to the
  163.      left and right using the arrow keys.
  164.  
  165.    To UNmark ALL selected files/subdirectories
  166.    ───────────────────────────────────────────
  167.    - Press 'U' to clear the dataset
  168.  
  169.    To load a previously saved dataset
  170.    ──────────────────────────────────
  171.    - Press 'L' & select the dataset from the list.
  172.    - The contents of the dataset will be listed in
  173.      the right window and the left window will
  174.      display the currently displayed directory
  175.      with the selections updated according to the
  176.      selected dataset in the right window.
  177.  
  178.    To save a dataset of current selections
  179.    ───────────────────────────────────────
  180.    - Press 'S'
  181.    - Type in the name to give to the new dataset.
  182.    - If it already exists you will be asked if you
  183.      wish to overwrite it with the message:
  184.      File Already Exists.  Overwrite (Y/N)?
  185.    - It is not required to save a dataset to do a
  186.      backup; it is for the convenience of users
  187.      who need the same set repeatedly.
  188.  
  189. Backup your selected files ---
  190. ══════════════════════════
  191.  
  192.    - Press F8
  193.  
  194.    - You will be prompted in a pop-on box:
  195.      - Titled:
  196.        Zip File Name (Ex. D:\BACKUPS\BACKUP01.ZIP)
  197.      - Type in the name for the new ZIP file
  198.      - Be sure to include the drive and the .ZIP
  199.        as the example shows.
  200.      - Using the example, the file will be placed
  201.        in the directory D:\BACKUPS
  202.      - Using D:\Backup1.zip, the file will be
  203.        placed in the root subdirectory on D:
  204.  
  205.    - You will be prompted in a pop-on box:
  206.      Disk Spanning (Y/N)?
  207.      If the data is being backed up on floppies
  208.      and will take more than one floppy, then
  209.      answer 'Y', otherwise answer 'N'.
  210.  
  211.    - PKZip will then be in control and will keep
  212.      you updated as to which file it is currently
  213.      adding or updating in your ZIP file.
  214.  
  215.    - When PKZip is finished, you will have the
  216.      message:  Backup Complete.  Press any Key....
  217.  
  218.    - You will be returned to the your original
  219.      screen to continue.
  220.  
  221.            ════════════════════════════
  222.            RESTORE GENERAL INSTRUCTIONS
  223.            ════════════════════════════
  224.  
  225. From the initial ZBackup screen, press 'R' to
  226. enter the restore mode.
  227.  
  228. Select the ZIP File you wish to use to restore
  229. ══════════════════════════════════════════════
  230.  
  231.    - NOTE of WARNING using PKUNZIP:  If you have
  232.      used disk spanning to backup your files, then
  233.      the directory for those files is on the LAST
  234.      disk.  If you use any of the other disks from
  235.      the disk-spanned set to get your restore list
  236.      then PKUNZIP may either give you a warning
  237.      message after several minutes of looking and
  238.      ask you to use PKZipFix which is NOT the
  239.      correct action in this case OR it may simply
  240.      leave you locked in the grips of PKUNZIP and
  241.      not let control return to ZBACKUP.  So, BE
  242.      SURE TO USE THE LAST DISK OF A DISK-SPANNED
  243.      SET IN ORDER TO GET YOUR RESTORE LIST.
  244.  
  245.    - When entering the restore mode, a pop-on box
  246.      will appear labeled "Load Zip File".  It will
  247.      contain a file listing in which you can
  248.      navigate to other drives and directories just
  249.      as described above.
  250.  
  251.    - To exit the "Load Zip File" box, press Esc.
  252.  
  253.    - After exiting the pop-on "Load Zip File" box,
  254.      you may redisplay it by pressing 'L' for Load
  255.      Zip Listing.
  256.  
  257.    - To return to the Backup Files Mode, press 'B'
  258.  
  259.    - After selecting a ZIP file (by locating the
  260.      cursor on it and then pressing ENTER), you
  261.      will be able to scroll up/down/left/right
  262.      through the list of files contained in the
  263.      selected ZIP file.
  264.  
  265. Select all items in the ZIP file to be restored
  266. ═══════════════════════════════════════════════
  267.  
  268.    - Select/mark ALL files by pressing 'A'
  269.    - Deselect/unmark ALL files by pressing 'U'
  270.    - Select/Deselect an item by moving the cursor
  271.      to the item and press the SPACE BAR.
  272.  
  273. Restore your selected files ---
  274. ═══════════════════════════
  275.  
  276.    - Press F8.
  277.  
  278.    - You will be prompted with a "Restore Path
  279.      (Ex. D:\) pop-on box.  Follow the example.
  280.      All subdirectories will be created if they
  281.      do not exist according to the pathnames you
  282.      see in the ZIP listing.
  283.  
  284.    - Press ENTER.
  285.  
  286.    - PKZip will then be in control and will keep
  287.      you updated as to which file it is currently
  288.      restoring.
  289.  
  290.    - BE SURE TO READ ALL MESSAGES from PKUNZIP
  291.      to verify that it had no problem, such as
  292.      "Disk Full", etc.  There will be no beep.
  293.  
  294.    - IF A FILE ALREADY EXISTS, PKZIP will prompt
  295.      you with an unexplained warning message:
  296.      PKUNZIP:  (W18) Warning! .... already exists.
  297.      Overwrite (y/n/a/r)?
  298.  
  299.      type 'y' to overwrite the existing ZIP
  300.      type 'n' to NOT overwrite the existing ZIP
  301.      type 'a' to overwrite ..ALL.. existing files
  302.      type 'r' to rename the unzipped file so you
  303.               can keep the original; you will be
  304.               asked what filename to use
  305.  
  306.    - When PKZip has finished, ZBACKUP will give
  307.      you the message:  Restoration Complete.
  308.      Press any Key....
  309.  
  310.    - You will be returned to the program.
  311.  
  312.  
  313. ZBSetUp Help ---
  314. ════════════
  315.  
  316.    Run ZBSetUp to reset the screen colors if you
  317.    wish to use something other than the defaults
  318.    set up for you.  Follow the instructions on
  319.    the screen.  It can also be used to set back
  320.    to default colors.  Default colors will be
  321.    used, if you do not wish to set your own.
  322.  
  323. Installation ---
  324. ════════════
  325.    ZBackup will expect the zb.hlp file to be
  326.    present in the same subdirectory with
  327.    zbackup.exe.  Another fact you may wish to
  328.    know is that all .DST files will be saved into
  329.    that same directory.  These are the files into
  330.    which you save your stored backup listings.
  331.    It is not required that you save a dataset, but
  332.    if you do, this is where it will be placed.
  333.  
  334.    Also, PKZIP.EXE and PKUNZIP.EXE must either be
  335.    in the same directory with ZBACKUP or in a path
  336.    directory.
  337.  
  338. Numbered Error Messages ---
  339. ═══════════════════════
  340.     10 = 'Invalid environment.'
  341.     11 = 'Invalid format.'
  342.     12 = 'Invalid file access code.'
  343.     15 = 'Invalid drive number.'
  344.     16 = 'Cannot remove current directory.'
  345.     17 = 'Cannot rename across drives.'
  346.    100 = 'Disk read error.'
  347.    101 = 'Disk write error.'
  348.    102 = 'File not assigned.'
  349.    103 = 'File not open.'
  350.    104 = 'File not open for input.'
  351.    105 = 'File not open for output.'
  352.    106 = 'Invalid numeric format.'
  353.    151 = 'Unknown unit.'
  354.    153 = 'Unknown command.'
  355.    154 = 'CRC error in data.'
  356.    155 = 'Bad drive request structure length.'
  357.    156 = 'Disk seek error.'
  358.    157 = 'Unknown media type.'
  359.    158 = 'Sector not found.'
  360.    160 = 'Device write fault.'
  361.    161 = 'Device read fault.'
  362.    162 = 'Hardware failure.'
  363.