home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / split.zip / READ.ME < prev    next >
Text File  |  1994-08-03  |  4KB  |  128 lines
  1.  
  2.    Notice:  This utility was provided to us by another Software Installer
  3.    customer.  We have been given permission to redistribute this utility
  4.    on an "as is" basis.  No other documentation was supplied other that
  5.    what follows.  This code was originally written for OS/2.  You may
  6.    port this code to other platforms at your own risk as we do not
  7.    support this code.
  8.  
  9.  
  10.    Using SPLIT.EXE:
  11.    ----------------
  12.  
  13.    1)  Copy the file to be split to a temporary directory, e.g. C:\TEMP
  14.  
  15.    2)  Copy SPLIT.EXE to C:\TEMP
  16.  
  17.    3)  The syntax for SPLIT.EXE is
  18.          SPLIT InputFilename.Ext OutputFilename
  19.  
  20.        Example:  To split XYZ.AVI, enter:
  21.          SPLIT XYZ.AVI ABC
  22.  
  23.        This will split XYZ.AVI into several files called ABC.1, ABC.2,
  24.        ABC.3, etc.  The size of each split file is approximately 450K.
  25.  
  26.    4)  Rename the first split file to the input file.
  27.  
  28.        Example:
  29.          RENAME ABC.1 XYZ.AVI
  30.  
  31.        This rename will make writing your package file easier and will allow
  32.        Software Installer to treat the joined, large file as one file once it
  33.        is installed.
  34.  
  35.  
  36.  
  37.    Creating MERGE.CMD
  38.    ------------------
  39.  
  40.    MERGE.CMD will be called during installation to join the split files
  41.    into the original large file.  Using MERGE.XMP as an example:
  42.  
  43.    1)  Add a JOIN statement for each split file.  (Note:  Do not include a
  44.        JOIN statement for the first split file (e.g. ABC.1) as this was
  45.        renamed.  You will recreate the original file by joining the split
  46.        files in succession.)
  47.  
  48.    2)  Add a DEL statment for each split file.  (Note:  Again, do not include
  49.        a DEL statement for the first split file (e.g. ABC.1)).
  50.  
  51.    MERGE.CMD takes 3 parameters:
  52.       1)  The directory where JOIN.EXE is installed.
  53.       2)  The directory where the renamed split file (e.g. XYZ.AVI) is
  54.           installed.
  55.       3)  The directory where the remaining split files (e.g. ABC.*) are
  56.           installed.
  57.  
  58.    When MERGE.CMD is complete, you will have your original file and the
  59.    split files will be deleted.
  60.  
  61.  
  62.  
  63.    Updating Your Package File
  64.    --------------------------
  65.  
  66.    Now that you have your large file split and MERGE.CMD created, you need
  67.    to update your package file.
  68.  
  69.    1)  Include a FILE entry to install JOIN.EXE
  70.  
  71.    2)  Include a FILE entry to install MERGE.CMD
  72.  
  73.    3)  Include a FILE entry to install each of the split files (e.g. XYZ.AVI,
  74.        ABC.2, ABC.3, etc.)
  75.  
  76.    4)  After the last FILE entry that installs ABC.*, include a FILE entry
  77.        to run MERGE.CMD in an exit.
  78.  
  79.  
  80.    Example:
  81.  
  82.    Assume that you want to join XYZ.AVI, ABC.2, ABC.3, ABC.4, and
  83.    ABC.5.  In your package file you would add:
  84.  
  85.            FILE
  86.               PWSPATH = 'FILE',
  87.               SOURCE = 'JOIN.EXE',
  88.               PWS = 'JOIN.EXE'
  89.  
  90.            FILE
  91.               PWSPATH = 'FILE',
  92.               SOURCE = 'MERGE.CMD',
  93.               PWS = 'MERGE.CMD'
  94.  
  95.            FILE
  96.               PWSPATH = 'WORK',
  97.               SOURCE = 'DRIVE: XYZ.AVI',
  98.               PWS = 'XYZ.AVI'
  99.  
  100.            FILE
  101.               PWSPATH = 'WORK',
  102.               SOURCE = 'DRIVE: ABC.2',
  103.               PWS = 'ABC.2'
  104.  
  105.            FILE
  106.               PWSPATH = 'WORK',
  107.               SOURCE = 'DRIVE: ABC.3',
  108.               PWS = 'ABC.3'
  109.  
  110.            FILE
  111.               PWSPATH = 'WORK',
  112.               SOURCE = 'DRIVE: ABC.4',
  113.               PWS = 'ABC.4'
  114.  
  115.            FILE
  116.               PWSPATH = 'WORK',
  117.               SOURCE = 'DRIVE: ABC.5',
  118.               PWS = 'ABC.5'
  119.  
  120.            FILE
  121.               EXIT = 'EXEC bg tw %EPFIFILEDIR%//MERGE.CMD %EPFIFILEDIR% %EPFIWORKDIR% %EPFIWORKDIR%',
  122.               EXITIGNOREERR = 'NO',
  123.               EXITWHEN = 'INSTALL'
  124.  
  125.  
  126.    Note:  You may need to add/modify FILE keywords to suit your installation.
  127.  
  128.