home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / Information / SURVIVALKIT1.SFX / help.arc next >
Encoding:
Text File  |  1993-06-30  |  8.4 KB  |  203 lines
  1.  
  2.  
  3. Date: 930626
  4.  
  5. File: Help with .ARC
  6.  
  7.  
  8. How To Use ARC
  9. --------------
  10.  
  11. ARC is a handy utility which makes our file transfers much easier and in many
  12. cases completely foolproof.  The utility itself is powerful, and you will want
  13. to read the complete documentation file for more information, this small
  14. tutorial is aimed at just how to use the ARC file extractions and creations
  15. with ARC.  There are BASIC programming utilities, printing and viewing
  16. facilities, DOS wedge commands, and even an editor inside the many facets of
  17. ARC itself.
  18.  
  19. Please remember that this Commodore ARC method is not compatible with the MSDOS
  20. ARC version nor the CP/M ARK version.
  21.  
  22. For file transfers, ARC does two very important things.  It COMPRESSES the
  23. data, allowing for a 10-50% or more reduction in the size of the material you
  24. download.  It also combines several necessary files into one easy to manage PRG
  25. file.  Many programs have one or more machine language overlays, a
  26. documentation file, the main file itself, and might have even more extra files
  27. to go with it.  In the past, people had to make sure they uploaded every single
  28. necessary file individually, taking care to preserve data if there was a binary
  29. SEQ file.  Then we had to make sure that we downloaded every single file
  30. necessary to run the program successfully.  ARC makes all the worries about
  31. that go away.  When something has been ARC'd, there is no worry about looking
  32. for additional files or worrying about what filetype to download something as,
  33. or even worrying about XMODEM padding!  No padding problems!
  34.  
  35. The first step in downloading any of the programs in the Software Library which
  36. have a .ARC at the end of their names is to download the current version of
  37. ARC.  You only download the ARC program one time.  Place it on a utility disk,
  38. you can use the same program over and over for every ARC'd file you download,
  39. or each ARC'd file you wish to create for uploading.
  40.  
  41.  
  42. While you are sitting there downloading, download one of the programs which
  43. requires ARC to dissolve it.  Remember, they will have a .ARC in the name of
  44. the file in the Software Library.  This is your key to knowing that ARC will be
  45. required.
  46.  
  47. When you download the file, remember to name it with a .ARC on your disk, too.
  48. <Don't use shifted letters, type the filename normally, just be sure to leave
  49. enough room to use a period and 'arc'.
  50.  
  51. There are some ARC files which dissolve automatically, and do not require the
  52. ARC program.  These are called Self Dissolving ARCs, and are all marked .SDA or
  53. .SFX in the Software Library.  These you just load into memory and RUN. The
  54. proper file<s> will be written to your disk for you.  About the only thing you
  55. should worry about in an SDA/SFX file is to watch for duplicate filenames. I
  56. always name my .SDA/.SFX file with a period and 'SDA' (or .SFX) at the end of
  57. it, knowing that no other file in the set would be named that. Make it a good
  58. practice to dissolve .SDA and .SFX files to a freshly formatted disk.
  59.  
  60.  
  61. OK, I just Downloaded the ARC Program file...
  62.  
  63. After you have logged off, strip ALL XMODEM padding from the ARC program with
  64. one of the padding stripping utilities as described in the Survival Kit about
  65. XMODEM PADDING.  ARC'd files themselves are not susceptible to XMODEM padding
  66. because the data is preserved inside the file itself, complete with checksums
  67. and byte counts.  It is just the ARC PROGRAM which you download for the first
  68. time which must be stripped of every single padding character.  Even a single
  69. extra CONTROL Z at the end of the program could mess it up.  Follow
  70. instructions and precautions for stripping XMODEM padding as usual.  Step by
  71. step XMODEM PADDING information is item 4 on the Survival Kit menu.
  72.  
  73. ARC does not work with fastloading cartridges and programs.  Disable them
  74. before trying to use the program.
  75.  
  76. Now, load ARC and run it.  It will display the version number, the copyright
  77. notice by the author, Chris Smeets and turn your screen black.  Then you will
  78. see the regular READY prompt with a flashing cursor underneath it. That means
  79. everything is OK!
  80.  
  81. ARC does not use fancy title screens or menus.  It was written as a TOOL or
  82. UTILITY, and works like a WEDGE.  What it does is add new commands to your
  83. BASIC!  You just type in direct mode what you want ARC to do.  This is why the
  84. complete set of instructions documentation file is so important.
  85.  
  86. After you RUN ARC, you are ready to dissolve that program you downloaded! Place
  87. the disk with it in drive 8.  If you have a second drive, place your
  88. destination disk in that one.
  89.  
  90. Now, lets check the directory on drive 8 to make sure that the file is there
  91. and is named properly.  <<I called mine GAME.ARC>>
  92.  
  93. The command to view the directory is:   DIR
  94.  
  95. Just type in 'dir' in direct mode:
  96.  
  97. dir
  98.  
  99. After you press return, the directory contents will be displayed on drive 8.
  100.  
  101. Make sure that GAME.ARC has a period and the letters 'arc' as the last
  102. characters in the filename.  If not, rename the file!
  103.  
  104. First, lets learn how to extract the ARC'd file to just one drive. Its called
  105. UnARCing or DeARCING or Extracting or Dissolving.
  106.  
  107. To Dissolve a Downloaded File:
  108. ----------------------------- On 1 drive system, type at the ready prompt,
  109.  
  110. ARC/X A:GAME
  111.  ! !!!!! !
  112.  ^ ------- --> the ARC command, remember its a new BASIC command.
  113.    ^------ --> No space at all, ARC is always followed by a slash.
  114.     ^----- --> The ARC option you want to use, X means eXtract, or
  115.                dissolve-sometimes called unARCing or deARCing.
  116.      ^---- --> ALWAYS a space after the command and before the filename<s>
  117.       ^--- --> Denotes drive A, which is drive 8, for the Arcfilename, GAME
  118.        ^-- --> A colon always separates the drive notation from the filename.
  119.          ^ --> The ARC file name itself on your disk.  You do not have to
  120.                type in the .ARC, tho.
  121.  
  122. On a 2 drive system, place the source file in drive 8, destination disk in
  123. drive 9, enter:
  124.  
  125. C:            (changes default to drive 9)
  126. ARC/X A:GAME C:
  127.  
  128. Adding the C: to the end tells ARC that you want the output on the C: drive,
  129. which is drive 9.  As ARC extracts the file, the original program and any
  130. accompanying files will be written to drive 9 this way.  See Chris Smeets'
  131. excellent instruction file for more information about drive assignments and
  132. directing your output.
  133.  
  134. After you press RETURN, the files will be written to your disk.  Make sure that
  135. you have enough room on the disk for the new files!  I find it best to allow
  136. the size of the GAME.ARC plus about 50% more to guess at the number of free
  137. blocks I should have.  TEXT files and some Graphics files are about the only
  138. things which might be larger than that 50%.
  139.  
  140.  
  141. ARC RECAP/Reference:
  142. -------------------
  143.  
  144. 1. Load the latest version of ARC.     (Currently 2.30, File # 2586)
  145. 2. RUN it.
  146. 3. Check to see if the file to be dissolved on your disk has a '.arc'
  147.    at the end of end of the filename.
  148.    Our Example will use GAME.ARC
  149. 4. Consult the complete instructions in files 3362 or 2423.
  150.  
  151. To Extract a Downloaded File:  (or UnARC):
  152. -----------------------------
  153. On 1 drive system, type at the ready prompt,
  154.  
  155. ARC/X A:GAME
  156.  
  157. On a 2 drive system, place the source file in drive 8, destination disk in
  158. drive 9, enter:
  159.  
  160. C:            (changes default to drive 9)
  161. ARC/X A:GAME C:
  162.  
  163.  
  164. Disk Commands within ARC:
  165. ------------------------
  166.  
  167. DIR  - gives you a directory listing of the default directory.
  168. >    - to send any disk command, ala Wedges.
  169. MOVE - Moves File between drives.
  170.        MOVE A:FROMHERE C:TOHERE
  171.        the above moves file from drive 8 to 9
  172.  
  173. Creating an .ARC file to upload:
  174. -------------------------------
  175.  
  176. ARC/C A:ARCNAME C:FILE1 PATTERN* FILE2 DD*
  177.  
  178. You can specify EXACT filenames or use pattern matching to catch all files on
  179. the disk with the characters DD, for instance.
  180.  
  181. Add to an existing ARCfile with:
  182.  
  183. ARC/A A:ARCNAME C:NEWFILENAME
  184.  
  185. Listing an .ARC file contents:
  186. -----------------------------
  187.  
  188. ARC/L A:GAME
  189.  
  190. This command will let you see exactly which files, their original sizes and how
  191. much compression ARC used on them, with exact filenames and filetypes so that
  192. you can make sure an ARC worked right or to check for duplicate filenames
  193. before eXtracting the ARC'd file.
  194.  
  195.  
  196.  
  197.   Thats it in a nutshell.  The process is actually much simpler than I have
  198. made it sound, so don't be intimidated by it.
  199.  
  200.   ###################################
  201.   #    Back To the Survival Kit!    #
  202.   ###################################
  203.