home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / diskutil / back2fat / back2fat.doc < prev    next >
Encoding:
Text File  |  1993-02-06  |  9.1 KB  |  228 lines
  1.         ***************************************************************
  2.  
  3.         File:   BACK2FAT.DOC
  4.  
  5.         Author: Ralf Hauser (c│o)
  6.                 e-mail:  affie@frege.sns.neuphilologie.uni-tuebingen.de
  7.  
  8.         Date:   22-07-92
  9.  
  10.         Desc.:  To all those who have a OS/2 drive with a HPFS partition,
  11.                 another drive with a FAT partition and a tape streamer
  12.                 without OS/2 2.0 support...
  13.  
  14.                 Requires EABACKUP V2.x (available from hobbes)
  15.                      and ZOO V2.x (available from hobbes) or any
  16.                      other file compression utility.
  17.  
  18.         __________________________________________________________________
  19.         __ BACK2FAT.DOC __________________________________________________
  20.  
  21.         BACK2FAT.CMD acts as a shell in calling other (PD) programs to
  22.         create a backup of a specified fileset from a HPFS drive to a
  23.         FAT drive.
  24.  
  25.         BACK2FAT.CMD is designed as a template for your own backup jobs.
  26.  
  27.         BACK2FAT.CMD is a REXX program which may easily be changed for
  28.         personal preferences and other environments.
  29.  
  30.         (I hope it doesn't bore if I now start with my personal story...)
  31.         I have been using OS/2 2.0 with pleasure for two months now.
  32.         The only drop of bitterness so far ist that one vital program does
  33.         not run in the DOS box:
  34.  
  35.               SYTOS plus for DOS
  36.  
  37.         This is vital in so far as my WANGTEK tape streamer with its own
  38.         controller/adapter is worthless under OS/2 ...
  39.  
  40.         Rumors telling me that a support should be introduced in this fall
  41.         but Pinocchio is a true story either.
  42.  
  43.         So I have written my first REXX program (it's not my last one but,
  44.         personally, I prefer C and C++) to have a 'comfortable' shell for
  45.         the classic backup programs EABACKUP and ZOO.
  46.  
  47.         So I do backup my files to my second (FAT) harddrive, boot under
  48.         pure DOS, run SYTOS and sleep much better from now on!
  49.  
  50.         If you, the honorable reader of this magnificient document, have
  51.         similar problems, my (\TMP) solution might help you.
  52.  
  53.         So this is what you have to do:
  54.  
  55.         __________________________________________________________________
  56.         __ INSTALL _______________________________________________________
  57.  
  58.         BACK2FAT requires ...
  59.  
  60.            ■ OS/2 2.0 (That's what the mess is alll about)
  61.            ■ EABACKUP Version 2.x for backing up Extended Attributes
  62.            ■ ZOO Version 2.x for backing up files
  63.  
  64.         If you prefer another file compression utility you must adapt
  65.         BACK2FAT accordingly. (This is quite definitely your problem!)
  66.         (You need to know how to program in REXX which is *no* magic.)
  67.  
  68.         Copy BACK2FAT.CMD (and this DOC file) to a directory of your
  69.         choice.
  70.  
  71.            Either:
  72.  
  73.               Copy EABACKUP.EXE to the same directory
  74.               Copy ZOO.EXE to the same directory
  75.  
  76.            Or:
  77.  
  78.               Be shure that EABACKUP.EXE is in a directory of your PATH
  79.                       environment.
  80.               Be shure that ZOO.EXE is in a directory of your PATH
  81.                       environment.
  82.  
  83.         If you do not know, what a PATH environment is (maybe because
  84.         you are totally object-oriented and do not care for those technical
  85.         details), refer to your OS/2 Online Manual for a description or
  86.         fulfill the first condition!
  87.  
  88.         That's it.
  89.  
  90.         BACK2FAT automatically searches for its spawned programs and
  91.         generates an error message if it cannot find them. This is
  92.         done by a nice REXX system call...
  93.  
  94.         NOTE: On my system I have installed the APA's PJ03945 and PJ04178
  95.               and I don't know whether my program requires them or not.
  96.               I didn't have the time to check this out, sorry.
  97.               These patches are available from hobbes as something like
  98.               REXX20.ZOO
  99.  
  100.         __________________________________________________________________
  101.         __ ADAPTION ______________________________________________________
  102.  
  103.         BACK2FAT.CMD is designed as a template for your own backup jobs.
  104.  
  105.         So this means you have to do a little bit!!!
  106.  
  107.         You do not have know anything about REXX or so, it's really easy
  108.         do 'patch' the program, don't be shy...
  109.  
  110.  
  111.         The program must be called with at least one argument describing
  112.         a fileset. A fileset is a drive/path specification of the files
  113.         which are to be backuped.
  114.  
  115.         The filesets are hardcoded within the program and must be edited
  116.         to fit to your environment!
  117.  
  118.         There are 5 filesets already defined in the program which suit to
  119.         my environment. Unless you change your whole filesystem to the
  120.         same structure as mine you have to edit the fileset names and
  121.         their underlying filespecs!
  122.  
  123.         So use your favorite editor (e.g EDLIN) and edit BACK2FAT.CMD
  124.         Around line #212 there should be something like
  125.  
  126.         ----
  127.         global.fileset.1     = "OS2  -->   C:\OS2"    /* OS2 system files */
  128.         global.fileset.2     = "APP  -->   C:\APP"    /* applications */
  129.         global.fileset.3     = "BIN  -->   C:\BIN"    /* 'binaries', tools */
  130.         global.fileset.4     = "ETC  -->   C:\ETC"    /* other system files */
  131.         global.fileset.5     = "LIB  -->   C:\LIB"    /* libraries */
  132.         /* ... more ... */
  133.         global.fileset_num   = 5       /* must contain number of filesets! */
  134.         ---
  135.  
  136.         If your built-in-pattern-matcher works with a low-priority threshold
  137.         you should already recognize the trick.
  138.  
  139.         If you just see objects (letters, punctuation signs, crazy things)
  140.         I have to catch another breath and explain it:
  141.  
  142.         A fileset definition looks like:
  143.  
  144.         global.fileset.1  = "OS2  -->   C:\OS2"  /* OS2 system files */
  145.  
  146.         ^^^^^^^^^^^^^^ ^  ^  ^     ^     ^       ^^^^^^^^^^^^^^^^^^^^^^
  147.                 │      │  │  │     │     │                 │
  148.                 │      │  │  │     │     │                 └ REXX comment
  149.                 │      │  │  │     │     │
  150.                 │      │  │  │     │     └ file specification (used as backup source)
  151.                 │      │  │  │     └ separator (must be here)
  152.                 │      │  │  └ fileset (command line argument)
  153.                 │      │  │
  154.                 │      │  └ guess what it does
  155.                 │      │
  156.                 │      └ must be a unique number for each definition!!!
  157.                 │
  158.                 └ REXX Stuff
  159.  
  160.         So invent an own name for a fileset and attach a file specification
  161.         to it!
  162.         Be shure that all fileset definitions have a uniqe number!
  163.         Be shure that the first fileset definition has number "1"!
  164.         After having defined all your filesets be shure that the next line
  165.         is:
  166.  
  167.         global.fileset_num   = 5       /* must contain number of filesets! */
  168.                                ^
  169.                                │
  170.                                └ must be the number of the last definition!
  171.  
  172.  
  173.         YOU GOT IT, EH???
  174.  
  175.         After having saved the file with your personal editor save and exit
  176.         command (for EDLIN its: W <┘, Q <┘) run it!
  177.  
  178.         __________________________________________________________________
  179.         __ ADAPTION TO ANOTHER COMPRESSION PROGRAM _______________________
  180.  
  181.         This is for those being familiar with the sophisticated REXX
  182.         language (SAA, haha).
  183.  
  184.         You need to change the "global.eabckup_pgm" and "global.eabckup_add"
  185.         constants in the "b2f_init" procedure.
  186.         Also, you have to rewrite the "b2f_backup" procedure.
  187.  
  188.         I think that the program has good comments and is not too
  189.         compleictaddade, eh, complicated for someone else to edit.
  190.  
  191.         Feel free to work on it, let me know your modifications!
  192.  
  193.         __________________________________________________________________
  194.         __ RUNNING IT ____________________________________________________
  195.  
  196.         Running it without any arguments or with a "/?" or "-?" switch
  197.         will display further instructions.
  198.  
  199.         (This was really a fast explanation, was it?)
  200.  
  201.         __________________________________________________________________
  202.         __ DONATIONS _____________________________________________________
  203.  
  204.         If you want to send money, feel free to do it.
  205.  
  206.         I will not prevent you from doing so.
  207.  
  208.         (Since I only have a NEC 3D Multisync which is not capable of
  209.         displaying 1024 x 768 x 16 non-interlaced I urgently need money.)
  210.  
  211.         If you do not want to send any money, spend it for your own
  212.         pleasure and think of me ...
  213.  
  214.         __________________________________________________________________
  215.         __ AUTHOR ________________________________________________________
  216.  
  217.         Ralf Hauser
  218.         Seminar für Sprachwissenschaft
  219.         Kleine Wilhelmstraße 113
  220.         7400 Tübingen
  221.         Germany West or West Germany or so
  222.  
  223.         e-mail:  affie@frege.sns.neuphilologie.uni-tuebingen.de
  224.  
  225.  
  226.         <EOF>
  227.  
  228.