home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / LOADDF.ZIP / LOADDSKF.DOC < prev    next >
Text File  |  1993-01-27  |  14KB  |  343 lines
  1.  
  2.  
  3.  
  4.  
  5.                                       LOADDSKF & SAVEDSKF User's Guide
  6.  
  7.        (c) Copyright International Business Machines Corporation 1993.
  8.        All rights Reserved.
  9.                                                               01/27/93
  10.  
  11.           LOADDSKF & SAVEDSKF
  12.           ___________________
  13.  
  14.           INTRODUCTION
  15.           ____________
  16.  
  17.           SaveDskF.exe  and  LoadDskF.exe  are  a pair of utilities to
  18.           save a diskette to a file and vice-versa. These programs are
  19.           not intended to save fixed  disk  images.   They  have these
  20.           characteristics:
  21.  
  22.           ∙   Run under OS/2 and DOS 3.3 or later.
  23.  
  24.           ∙   Empty sectors above the highest occupied sector are  not
  25.               included in the file.
  26.  
  27.           ∙   The data may be compressed.
  28.  
  29.           ∙   Diskettes may be formatted as they are written.
  30.  
  31.           ∙   Standard diskette formats are supported.
  32.  
  33.           ∙   Conversion to a larger diskette image is possible.
  34.  
  35.           ∙   Label text may be included in the file that is  displayed
  36.               by LoadDskF before the diskette is written.
  37.  
  38.           ∙   The progress of the data  transfer  is  visible  on  the
  39.               screen.
  40.  
  41.           ∙   Built-in Checksum function.
  42.  
  43.           ∙   Handles "image" files generated by other programs.
  44.  
  45.           Efficient  portability  of  complete diskette images is pro-
  46.           vided for transmission via data networks.  Boot, file  allo-
  47.           cation table, directory and data sectors are included.  Both
  48.           programs  provide  a  short help facility when some types of
  49.           syntax errors are detected.  Just type the program  name  to
  50.           get help.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.           LOADDSKF & SAVEDSKF                                        1
  58.  
  59.  
  60.           LOADDSKF
  61.           ________
  62.  
  63.           The calling syntax is:
  64.  
  65.                 LoadDskF [D:][path]filename.dsk d:[/F][/C][/Y][/Q]
  66.  
  67.           The  diskette  image contained in the file is written to the
  68.           specified target drive d:.   The target diskette  must  have
  69.           the  same format as the original diskette.  If the format is
  70.           incorrect, an informational message indicates  the  required
  71.           format.
  72.  
  73.           A warning message appears before the data transfer begins so
  74.           that  syntax  errors  do not result in a corrupted diskette.
  75.           It is necessary to press the "y" key in  order  to  continue
  76.           the process.  A return code of 31 (decimal) is issued if the
  77.           response is not "y".  Alternatively, /Y will bypass the need
  78.           to  press the "Y" key.  When both /Y and /Q are invoked, the
  79.           warning message is omitted.
  80.  
  81.           In the event of a checksum error, both the expected and cal-
  82.           culated values are displayed.
  83.  
  84.           IMAGE FILES
  85.           ___________
  86.  
  87.           Loaddskf supports input files that represent a  pure  binary
  88.           image  of  the disk that has been generated by SaveDskf with
  89.           the /D and /A options or other programs,  such  as  DSKIMAGE
  90.           and  DISKIMGE.    Image  is defined as the uncompressed disk
  91.           data without header or trailer.  The file must be the  exact
  92.           size of a standard diskette.  Diskettes supported are 1.44M,
  93.           1.2M, 720K and 360K.
  94.  
  95.  
  96.           FORMATTING
  97.           __________
  98.  
  99.           When  /F  is specified, each track is formatted before it is
  100.           written.  When all of the data has  been  written,  LoadDskF
  101.           continues  to  format the remainder of the tracks.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.           LOADDSKF & SAVEDSKF                                        2
  115.  
  116.  
  117.           CONVERTING A DISKETTE
  118.           _____________________
  119.  
  120.           When /C is specified, the diskette image can be written on a
  121.           diskette  of  a  different format than the original diskette
  122.           provided that it is at least as large as the  original.  The
  123.           resultant  diskette's  capacity will then appear to have the
  124.           original  diskette's capacity.  After executing LoadDskF /C,
  125.           it is recommended that the files be transferred  to  another
  126.           diskette  using  the DOS copy command. The diskette with the
  127.           truncated capacity can then be reformatted.
  128.  
  129.           When you use the /C option together with the /F option, your
  130.           diskette will be formatted to the highest density  supported
  131.           on  the  drive (not exactly true, but it will be most of the
  132.           time).  There is no means for specifying lower capacity  me-
  133.           dia.    The  image written to diskette will be logically the
  134.           same as the source.  There are some subtle differences, how-
  135.           ever. Let's assume that we have a 1.2Mb image that  we  want
  136.           to  put  onto  a  1.44Mb  diskette. There are 18 sectors per
  137.           track on a 1.44Mb diskette. There are only  15  on  a  1.2Mb
  138.           diskette. In this case we would only write 15 of the 18. The
  139.           boot  record  would  tell us that there were only 15 sectors
  140.           per track. This looks to DOS just as if it were a real 1.2Mb
  141.           diskette. Physically, there are actually 3 sectors  on  each
  142.           track that are not used. DOS is told they don't exist and it
  143.           never looks for them.
  144.  
  145.           When  you  tell  LoadDskF  the /F option, it will format the
  146.           output diskette to the same density as  the  input  diskette
  147.           image  (providing,  of  course, that the diskette drive sup-
  148.           ports that kind of image).
  149.  
  150.           If you ALSO use the /C option, your diskette will be format-
  151.           ted to the highest density that the drive supports.   If  we
  152.           assume we have a 2.88Mb diskette drive and a 1.2Mb or 1.44Mb
  153.           diskette  image,  the  diskette will be formatted to 2.88Mb.
  154.           The image written to  diskette  will  be  either  1.44Mb  or
  155.           1.2Mb.  It  will PHYSICALLY be formatted as 2.88Mb, but will
  156.           LOGICALLY be a 1.44Mb or 1.2Mb diskette. If you first  wrote
  157.           the 1.44Mb image to a diskette and then used ONLY the /C op-
  158.           tion  and wrote a 1.2Mb image to the same diskette, it would
  159.           work. If you now try to write a 1.44Mb  image  to  the  same
  160.           diskette with only the /C option, it would fail. This is be-
  161.           cause DOS thinks that you have a 1.2Mb diskette in the drive
  162.           and  a 1.44Mb diskette won't fit. In this case, you MUST use
  163.           both the /C option and the /F option.
  164.  
  165.           It is important to understand that this is not an all encom-
  166.           passing conversion from 3.5 to 5.25 inch media. In some  in-
  167.           stances,  3.5  inch  media  is provided for PS/2 systems and
  168.           5.25 inch media for PC systems. Therefore code that supports
  169.           hardware may be different for each media type.
  170.  
  171.           LOADDSKF & SAVEDSKF                                        3
  172.  
  173.  
  174.           In those cases where the media type is unimportant,  a  file
  175.           packager  such  as  SaveRam or PKZIP is strongly recommended
  176.           over SaveDskF so that those who receive the packed file need
  177.           not have a particular type of diskette drive.
  178.  
  179.           PROGRESS INDICATION
  180.           ___________________
  181.  
  182.           As  the  data  is written to the diskette, the percentage of
  183.           the data which has been written is displayed on the  screen.
  184.           If  the  diskette  is  being formatted as it is written, the
  185.           percentage is based on the diskette capacity.
  186.  
  187.           DOS COMPATIBILITY MODE
  188.           ______________________
  189.  
  190.           There is sometimes a problem when operating in the DOS  com-
  191.           patibility  mode where DOS does not recognize the newly gen-
  192.           erated diskette.  When this happens, the diskette appears to
  193.           have incorrect system information and  it  is  necessary  to
  194.           partially remove it and re-insert it in the drive.
  195.  
  196.           UP/DOWN LOADING
  197.           _______________
  198.  
  199.           When  transferring diskette image files between the PC and a
  200.           host system, it is necessary to treat them as binary  files,
  201.           i.e.  no  translation  of data must occur.  If the file data
  202.           has been translated, LoadDskF will  usually  give  an  error
  203.           message  indicating  that  the  file  is not compatible with
  204.           LoadDskF.
  205.  
  206.           It is also necessary to download any executable file includ-
  207.           ing LoadDskF.exe and SaveDskF.exe as  binary  files  without
  208.           translation.    When translation occurs, the results are un-
  209.           predictable and usually hang the machine requiring  a  power
  210.           off/on sequence to get back into operation.
  211.  
  212.           LoadDskF  will  ignore any data at the end of a file that is
  213.           shorter  than  a  complete  sector.    This  provides   some
  214.           forgiveness for the common error of uploading to a fixed re-
  215.           cord  length  file on a host system which results in a mean-
  216.           ingless string of data at the  end  of  the  file  which  is
  217.           usually not longer than 80 bytes.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.           LOADDSKF & SAVEDSKF                                        4
  229.  
  230.  
  231.           SAVEDSKF
  232.           ________
  233.  
  234.           The calling syntax is:
  235.  
  236.                 SaveDskF d: [D:][path]filename.dsk [/D][/A][/N][/M][/K]
  237.  
  238.           Since  the  diskette  that  the  file  will  be copied to by
  239.           LoadDskF must be the identical format as  the  original,  it
  240.           may be helpful to give the file a name that is indicative of
  241.           the required format, or include the  diskette  type  in  the
  242.           commentary message (/K or /M flag).  An extension of .DSK is
  243.           recommended to indicate a diskette image file.
  244.  
  245.           The complete image of the diskette in drive d: is written to
  246.           the specified file.  A file header as  described  below  and
  247.           all  diskette  sectors  are  written up to and including the
  248.           highest occupied data sector.  Whether or not a data  sector
  249.           is  in use is determined from the file allocation table.  An
  250.           informational message is displayed if some  of  the  sectors
  251.           written do not actually contain data.  This means that there
  252.           are  some  gaps in the data portion of the diskette.  An ap-
  253.           propriate response is to run a disk defragmentation  program
  254.           against the source diskette. Copy protected diskettes having
  255.           non-standard sector numbers  cannot  be  saved  by SaveDskF.
  256.           Only standard DOS formats are supported.
  257.  
  258.           As  the  data  is written to the file, the percentage of the
  259.           data which has been written is displayed on the screen.
  260.  
  261.           PURE DISKETTE IMAGE
  262.           ___________________
  263.  
  264.           The /D option omits the file header and inhibits compression
  265.           of the diskette data.  The resulting file  is  intended  for
  266.           use  with  diskette  copying  software and is not compatible
  267.           with LoadDskF.exe unless the /A option is also used.    When
  268.           /D is specified, /K and /M will generate an error message.
  269.  
  270.           SAVE ENTIRE DISK
  271.           ________________
  272.  
  273.           The  /A  option  saves  the whole diskette regardless of the
  274.           data stored on it.
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.           LOADDSKF & SAVEDSKF                                        5
  286.  
  287.  
  288.           DATA COMPRESSION
  289.           ________________
  290.  
  291.           The /N option inhibits data compression.    This  is  useful
  292.           when  the compression algorithm fails and produces data that
  293.           is larger than the uncompressed data.   When  this  happens,
  294.           SaveDskF displays an informational message recommending that
  295.           you rerun the program with /N specified.
  296.  
  297.           COMMENTARY MESSAGE
  298.           __________________
  299.  
  300.           The  /M option tells SaveDskF to get text from the specified
  301.           file to be included as a comment in the diskette image  file
  302.           which  LoadDskF  will  display before unloading the diskette
  303.           data.   It may contain information  on  any  aspect  of  the
  304.           diskette  usage  or the way it is to be unloaded.  This pro-
  305.           vides a means of ensuring that the recipient of the diskette
  306.           will be aware of important information.
  307.  
  308.           The /K option allows you to type in a brief commentary  mes-
  309.           sage  on the command line.  The text must follow immediately
  310.           and be enclosed in either single or double quotes.  The  en-
  311.           tire  command length is limited to 128 bytes.  When enclosed
  312.           in single quotes, double quotes may be used in the text  and
  313.           vice  versa.   If a message file has been specified with /M,
  314.           the /K text is added to its contents.  The total  length  of
  315.           the  message may be up to 4096 bytes.
  316.  
  317.           Examples of these flags are:
  318.  
  319.                    SaveDskF a: test.dsk /k"This is a 1.44Mb diskette"
  320.                 OR
  321.                    SaveDskF a: test.dsk /m test.msg
  322.                 OR
  323.                    SaveDskF a: test.dsk /mtest.msg
  324.  
  325.                 Where test.msg might contain:
  326.                    +--------------------------+
  327.                    + This file could contain  +
  328.                    + the text that you would  +
  329.                    + want printed on the label+
  330.                    + of the diskette.         +
  331.                    +--------------------------+
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.           LOADDSKF & SAVEDSKF                                        6
  343.