home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1998 January (DVD) / VPR980100.ISO / DRIVER / IBM / LOADDF / LOADDF.ZIP / LOADDSKF.INF (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1994-01-10  |  10.6 KB  |  232 lines
  1.  
  2. 笊絶武笊 1. Introduction 笊絶武笊
  3.  
  4. SaveDskF.exe and LoadDskF.exe are a pair of utilities to save a diskette to a 
  5. file and vice-versa. These programs are not intended to save fixed disk images. 
  6. They have these characteristics: 
  7.  
  8. o Run under OS/2 and DOS 3.3 or later. 
  9.  
  10. o Empty sectors above the highest occupied sector are not included in the file. 
  11.  
  12. o The data may be compressed. 
  13.  
  14. o Diskettes may be formatted as they are written. 
  15.  
  16. o Standard diskette formats are supported. 
  17.  
  18. o Conversion to a larger diskette image is possible. 
  19.  
  20. o Label text may be included in the file that is displayed by LoadDskF before 
  21.   the diskette is written. 
  22.  
  23. o The progress of the data transfer is visible on the screen. 
  24.  
  25. o Built-in Checksum function. 
  26.  
  27. o Handles "image" files generated by other programs. 
  28.  
  29. Efficient portability of complete diskette images is provided for transmission 
  30. via data networks.  Boot, file allocation table, directory and data sectors are 
  31. included. Both programs provide a short help facility when some types of syntax 
  32. errors are detected.  Just type the program name to get help. 
  33.  
  34.  
  35. 笊絶武笊 2. LoadDskF 笊絶武笊
  36.  
  37. The calling syntax is: 
  38.  
  39.     LoadDskF [D:][path]filename.dsk d: [/F][/C][/Y][/Q]
  40.  
  41. The diskette image contained in the file is written to the specified target 
  42. drive d:. The target diskette must have the same format as the original 
  43. diskette. If the format is incorrect, an informational message indicates the 
  44. required format. 
  45.  
  46. A warning message appears before the data transfer begins so that syntax errors 
  47. do not result in a corrupted diskette. It is necessary to press the "y" key in 
  48. order to continue the process. A return code of 31 (decimal) is issued if the 
  49. response is not "y". Alternatively, /Y will bypass the need to press the "Y" 
  50. key. When both /Y and /Q are invoked, the warning message is omitted. 
  51.  
  52. In the event of a checksum error, both the expected and calculated values are 
  53. displayed. 
  54.  
  55.  
  56. 笊絶武笊 3. Image files 笊絶武笊
  57.  
  58. Loaddskf supports input files that represent a pure binary image of the disk 
  59. that has been generated by SaveDskf with the /D and /A options or other 
  60. programs, such as DSKIMAGE and DISKIMGE. Image is defined as the uncompressed 
  61. disk data without header or trailer. The file must be the exact size of a 
  62. standard diskette. Diskettes supported are 1.44M, 1.2M, 720K and 360K. 
  63.  
  64.  
  65. 笊絶武笊 4. Formatting 笊絶武笊
  66.  
  67. When /F is specified, each track is formatted before it is written. When all of 
  68. the data has been written, LoadDskF continues to format the remainder of the 
  69. tracks. 
  70.  
  71.  
  72. 笊絶武笊 5. Converting a Diskette 笊絶武笊
  73.  
  74. When /C is specified, the diskette image can be written on a diskette of a 
  75. different format than the original diskette provided that it is at least as 
  76. large as the original. The resultant diskette's capacity will then appear to 
  77. have the original diskette's capacity. After executing LoadDskF /C, it is 
  78. recommended that the files be transferred to another diskette using the DOS 
  79. copy command. The diskette with the truncated capacity should then be 
  80. reformatted. 
  81.  
  82. When you use the /C option together with the /F option, your diskette will be 
  83. formatted to the highest density supported on the drive (not exactly true, but 
  84. it will be most of the time). There is no means for specifying lower capacity 
  85. media. The image written to diskette will be logically the same as the source. 
  86. There are some subtle differences, however. Let's assume that we have a 1.2Mb 
  87. image that we want to put onto a 1.44Mb diskette. There are 18 sectors per 
  88. track on a 1.44Mb diskette. There are only 15 on a 1.2Mb diskette. In this case 
  89. we would only write 15 of the 18. The boot record would tell us that there were 
  90. only 15 sectors per track. This looks to DOS just as if it were a real 1.2Mb 
  91. diskette. Physically, there are actually 3 sectors on each track that are not 
  92. used. DOS is told they don't exist and it never looks for them. 
  93.  
  94. When you tell LoadDskF the /F option, it will format the output diskette to the 
  95. same density as the input diskette image (providing, of course, that the 
  96. diskette drive supports that kind of image). 
  97.  
  98. If you ALSO use the /C option, your diskette will be formatted to the highest 
  99. density that the drive supports. If we assume we have a 2.88Mb diskette drive 
  100. and a 1.2Mb or 1.44Mb diskette image, the diskette will be formatted to 2.88Mb. 
  101. The image written to diskette will be either 1.44Mb or 1.2Mb. It will 
  102. PHYSICALLY be formatted as 2.88Mb, but will LOGICALLY be a 1.44Mb or 1.2Mb 
  103. diskette. If you first wrote the 1.44Mb image to a diskette and then used ONLY 
  104. the /C option and wrote a 1.2Mb image to the same diskette, it would work. If 
  105. you now try to write a 1.44Mb image to the same diskette with only the /C 
  106. option, it would fail. This is because DOS thinks that you have a 1.2Mb 
  107. diskette in the drive and a 1.44Mb diskette won't fit. In this case, you MUST 
  108. use both the /C option and the /F option. 
  109.  
  110. It is important to understand that this is not an all encompassing conversion 
  111. from 3.5 to 5.25 inch media. In some instances, 3.5 inch media is provided for 
  112. PS/2 systems and 5.25 inch media for PC systems. Therefore code that supports 
  113. hardware may be different for each media type. 
  114.  
  115. In those cases where the media type is unimportant, a file packager such as 
  116. SaveRam or PKZIP is strongly recommended over SaveDskF so that those who 
  117. receive the packed file need not have a particular type of diskette drive. 
  118.  
  119.  
  120. 笊絶武笊 6. Progress Indication 笊絶武笊
  121.  
  122. As the data is written to the diskette, the percentage of the data which has 
  123. been written is displayed on the screen. If the diskette is being formatted as 
  124. it is written, the percentage is based on the diskette capacity. 
  125.  
  126.  
  127. 笊絶武笊 7. DOS Compatibility Mode 笊絶武笊
  128.  
  129. There is sometimes a problem when operating in the DOS compatibility mode where 
  130. DOS does not recognize the newly generated diskette.  When this happens, the 
  131. diskette appears to have incorrect system information and it is necessary to 
  132. partially remove it and re-insert it in the drive. 
  133.  
  134.  
  135. 笊絶武笊 8. Up/Down loading 笊絶武笊
  136.  
  137. When transferring diskette image files between the PC and a host system, it is 
  138. necessary to treat them as binary files, i.e. no translation of data must 
  139. occur. If the file data has been translated, LoadDskF will usually give an 
  140. error message indicating that the file is not compatible with LoadDskF. 
  141.  
  142. It is also necessary to download any executable file including LoadDskF.exe and 
  143. SaveDskF.exe as binary files without translation.  When translation occurs, the 
  144. results are unpredictable and usually hang the machine requiring a power off/on 
  145. sequence to get back into operation. 
  146.  
  147. LoadDskF will ignore any data at the end of a file that is shorter than a 
  148. complete sector. This provides some forgiveness for the common error of 
  149. uploading to a fixed record length file on a host system which results in a 
  150. meaningless string of data at the end of the file which is usually not longer 
  151. than 80 bytes. 
  152.  
  153.  
  154. 笊絶武笊 9. SaveDskF 笊絶武笊
  155.  
  156. The calling syntax is: 
  157.  
  158.     SaveDskF d: [D:][path]filename.dsk [/D][/A][/N][/M][/K]
  159.  
  160. Since the diskette that the file will be copied to by LoadDskF must be the 
  161. identical format as the original, it may be helpful to give the file a name 
  162. that is indicative of the required format, e.g. DOS4028.DSK to indicate 40 
  163. tracks, 2 sides and 8 sectors per track.  An extension of .DSK is recommended 
  164. to indicate a diskette image file. 
  165.  
  166. The complete image of the diskette in drive d: is written to the specified 
  167. file.  A file header as described below and all diskette sectors are written up 
  168. to and including the highest occupied data sector.  Whether or not a data 
  169. sector is in use is determined from the file allocation table. An informational 
  170. message is displayed if some of the sectors written do not actually contain 
  171. data.  This means that there are some gaps in the data portion of the diskette. 
  172. An appropriate response is to run a disk defragmentation program against the 
  173. source diskette.  Copy protected diskettes having non-standard sector numbers 
  174. cannot be saved by SaveDskF.  Only standard DOS formats are supported. 
  175.  
  176. As the data is written to the file, the percentage of the data which has been 
  177. written is displayed on the screen. 
  178.  
  179.  
  180. 笊絶武笊 10. Pure Diskette image 笊絶武笊
  181.  
  182. The /D option omits the file header and inhibits compression of the diskette 
  183. data.  The resulting file is intended for use with diskette copying software 
  184. and is not compatible with LoadDskF.exe unless the /A option is also used. When 
  185. /D is specified, /K and /M will generate an error message. 
  186.  
  187.  
  188. 笊絶武笊 11. Save Entire Disk 笊絶武笊
  189.  
  190. The /A option saves the whole diskette regardless of the data stored on it. 
  191.  
  192.  
  193. 笊絶武笊 12. Data Compression 笊絶武笊
  194.  
  195. The /N option inhibits data compression. This is useful when the compression 
  196. algorithm fails and produces data that is larger than the uncompressed data. 
  197. When this happens, SaveDskF displays an informational message recommending that 
  198. you rerun the program with /N specified. 
  199.  
  200.  
  201. 笊絶武笊 13. Commentary message 笊絶武笊
  202.  
  203. The /M option tells SaveDskF to get text from the specified file to be included 
  204. as a comment in the diskette image file which LoadDskF will display before 
  205. unloading the diskette data.  It may contain information on any aspect of the 
  206. diskette usage or the way it is to be unloaded. This provides a means of 
  207. ensuring that the recipient of the diskette will be aware of important 
  208. information. 
  209.  
  210. The /K option allows you to type in a brief commentary message on the command 
  211. line. The text must follow immediately and be enclosed in either single or 
  212. double quotes. The entire command length is limited to 128 bytes. When enclosed 
  213. in single quotes, double quotes may be used in the text and vice versa. If a 
  214. message file has been specified with /M, the /K text is added to its contents. 
  215. The total length of the message may be up to 4096 bytes except when /C is used. 
  216. In that case, the message length may be up to 470 bytes. 
  217.  
  218. Examples of these flags are: 
  219.  
  220.        SaveDskf a: test.dsk /k"This is a 1.44Mb diskette"
  221.     OR
  222.        SaveDskf a: test.dsk /mtest.msg
  223.     OR
  224.        SaveDskf a: test.dsk /m test.msg
  225.     Where test.msg might contain:
  226.        +--------------------------+
  227.        + This file could contain  +
  228.        + the text that you would  +
  229.        + want printed on the label+
  230.        + of the diskette.         +
  231.        +--------------------------+
  232.