home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / Information / SURVIVALKIT1.SFX / help.downloads < prev    next >
Encoding:
Text File  |  1993-06-30  |  21.3 KB  |  492 lines

  1.  
  2.  
  3. Date: 930625
  4.  
  5. File: How to Download Files
  6.  
  7.  
  8. RoundTable Software Library
  9. ---------------------------
  10.  
  11. Downloading from the Libraries
  12.  
  13. The Commodore Software Library contains many Public Domain programs and files,
  14. most of which were contributed by the members of the RoundTable. They are
  15. available to everyone for the regular GEnie connect time charges.
  16.  
  17. To download these files into your own computer, you must use a Terminal Program
  18. which works with the 'X-MODEM' File-transfer protocol. You must either buy a
  19. commercially available Terminal Program, or obtain one of the many Public
  20. Domain Terminal Programs which includes X-MODEM ability.  Besides the popular
  21. X-MODEM, GEnie offers several other protocol choices for downloading.  X-MODEM
  22. 1K (which is more efficient than regular X-Modem), Y-MODEM (which will
  23. automagically write the filename to your disk, along with using 1K disk
  24. blocks), and Z-MODEM (there are currently no C64 or C-128 programs that support
  25. this streaming protocol).  If you have trouble finding a Terminal Program that
  26. supports one of these transfer protocols, send GEmail to COMMODORE$, and we
  27. will mail you a WIZARD disk for a small fee.
  28.  
  29. NOTE:  PUNTER and KERMIT are not supported as Protocols on GEnie!
  30.        X-Modem, X-Modem 1K, Y-Modem, and Z-Modem are supported on GEnie.
  31.  
  32.  
  33. Now, let's start Downloading!!
  34. ------------------------------
  35.  
  36. From the Main Commodore RoundTable menu, select #3 Software Libraries:
  37.  
  38.  
  39. M625
  40.  
  41.  1. CBM RoundTable Bulletin Board
  42.  2. Commodore Real-Time Conference
  43.  3. Commodore Software Libraries     <-- Software Library (downloads)
  44.  4. About the RoundTable
  45.  5. RoundTable News
  46.  
  47. Enter #, <P>revious, or <H>elp?3
  48.  
  49.  
  50. This will take you to the Commodore Software Library. The programs and files
  51. are sub-divided into several different categories or Libraries. For example,
  52. all Games may be grouped into Library numbers 11, 12, 13 and 14, depending on
  53. the type of game.  Music files are divided into easy to locate libraries number
  54. 15 through 19.
  55.  
  56. You will be given the choice of seeing ALL of the Libraries, and thus ALL of
  57. the files available, or of choosing ONE specific Library to work in. If you
  58. were only interested in BBS programs, you could choose ONLY the BBS library,
  59. called "BBS Resource Center", number 7, and ignore everything else.
  60.  
  61. Choosing to see only one Library is done with the SET LIBRARY option on the
  62. menu.  ALL Libraries will be open to you when you first join the RoundTable
  63. except the private libraries for vendor support and the Staff libraries.  There
  64. are several choices available to you on the Software Library menu:
  65.          Library: ALL Libraries         <--Now set to see ALL types of files
  66.  
  67.  1. Description of this Library        <--Describes types of files
  68.  2. Directory of files                 <--Lists files available
  69.  3. Search File Directory              <--Searches for specific files
  70.  4. Browse through files               <--Look at and download new files
  71.  5. Upload a new file                  <--Send files to GEnie
  72.  6. Download a file                    <--Receive files from GEnie to you
  73.  7. Delete a file you own              <--Remove your file from the Libraries
  74.  8. Set Software Library               <--Choose one specific Library
  75.  9. Save Current Software Library      <--Save Library choice
  76. 10. Instructions for Software Exchange <--More information
  77. 11. Directory of New Files             <--New Files since Last On
  78. 12. Join/Ignore Library Category       <--Removes selected Libraries
  79.  
  80. Enter #, <P>revious, or <H>elp?
  81.  
  82.  
  83.  1: 'Description of this Library' gives brief information about the types of
  84. files contained in each of the individual Libraries.
  85.  
  86.  2: 'Directory of files' will give you a list of the programs in the Library
  87. you have selected, or of all programs if you are set to ALL Libraries. Library
  88. menu option 2 (Directory) and 4 (Browse) prompts for file  number to start
  89. listing from, or <RETURN> for All.  This new feature   increases your on-line
  90. Library flexibility!
  91.  
  92.  3: 'Search File Directory' allows you to search through the Libraries for a
  93. particular word or words. For example, you could search for all files with the
  94. word 'Terminal' in their descriptions. You may also search by UPLOADER GEmail
  95. address, or Number of Days Back (such as 30 for 1 month). This is a very handy
  96. way to find files relating to your requests. Remember that UPLOADER and DAYS
  97. back are a sub-set of the Search Function.
  98.  
  99. The manner in which keywords are searched has improved. The routine will no
  100. longer search for any matching portion of a string in all keywords; it will
  101. only find keywords or filenames which BEGIN with the string you specify - i.e.
  102. if you specify GEOS, it will find GEOS-BB, but not BB-GEOS. Keep this in mind
  103. when constructing search strategies, and when making up keywords to go with
  104. your uploads.
  105.  
  106. The other change affects the ability to search for all files specifying ONLY a
  107. date, or with no search specs. You can no longer use the command this way.
  108. However, you can easily find the new files since your last logon, by using the
  109. #2 DIRECTORY choice instead of the SEARCH by date or better yet, Directory of
  110. New Files. The #2 DIRECTORY, and #11 Directory of New Files is in reverse
  111. upload order with the newest file first. Watch the dates as they go by, and
  112. when you have scanned back as far as you want to go, hit your BREAK character
  113. to abort the listing.
  114.  
  115.  4: 'Browse through files' lets you look at the descriptions of the files in
  116. reverse order (starting with the newest, and working back through the older
  117. ones), and download the files if you wish. This is the best way to see what's
  118. new in the Libraries since your last time on-line.
  119.  
  120. Library menu option 2 (Directory) and 4 (Browse) prompts for file  number to
  121. start listing from, or <RETURN> for All.  This new feature increases your
  122. on-line Library flexibility!
  123.  
  124.  5: 'Upload a new file' is how you can send a program to GEnie to share with
  125. the other Roundtable members.
  126.  
  127.  6: 'Download a file' will let you receive a specific program. You must know
  128. the Name or Number of the file, from either the Directory or a Search.
  129.  
  130.  7: 'Delete a file you own' allows you to remove a program you have previously
  131. uploaded, from the Library.
  132.  
  133.  8: 'Set Software Library' lets you choose one specific Library to look at.
  134.  
  135.  9: 'Save Current Software Library' will make your choice of a specific
  136. Software Library permanent, until you decide to change it again.  Each time you
  137. enter the Software Library, you will ONLY see that library.  To change this
  138. back to the default of ALL Libraries, set to ALL libraries using the SET
  139. Library menu option, and choose ALL Libraries, at the end of the names of the
  140. other libraries.  Then be sure to SAVE your new library setting again.  It will
  141. wipe out the first one and restore you so that you may locate files outside of
  142. the library you set to last time.
  143.  
  144.  10:'Instructions for Software Exchange' prints out more information about
  145. using the Software Library. You may wish to capture and print out this
  146. information for future reference.
  147.  
  148.  11:'Directory of New Files' will give you a listing of all of the New Files
  149. since the last time you have selected this menu option. Remember, you trigger
  150. the 'pointer' by selecting this.  If you have never selected this menu option,
  151. then you will see ALL of the files. Just hit CONTROL C to 'break' out of the
  152. listing. THIS OPTION IS NOT FOOLPROOF, but it works well when your Sysops
  153. release the new files in order.
  154.  
  155.  12:'Join/Ignore Library Category' will allow you to select which libraries you
  156. will be seeing in either your BROwse command or a directory, and have this
  157. stored permanently for all your visits.
  158.  
  159. To use the new menu item, you just choose it on the menu, it will then ask you
  160. which library number you want to change. Pressing <D> and return here will
  161. display the status of each individual library to you. You can then enter a
  162. library number. One of two things will happen:
  163.  
  164. If you are already 'JOINED' to view that library, it will deselect it, and the
  165. library will be invisible to you until you specifically join it again. If you
  166. have ignored it, then it will be toggled on to be visible to you again.
  167.  
  168.  
  169. Let's 'Pull' a Directory for our Capture buffer:
  170.  
  171. GEnie                         Libraries
  172.       Commodore Software Library:
  173.  
  174.       ALL Libraries <--Set to look at ALL files
  175.  
  176.  1. Description of this Library
  177.  2. Directory of files            <--Choose Directory to view files
  178.  3. Search File Directory
  179.  4. Browse through files
  180.  5. Upload a new file
  181.  6. Download a file
  182.  7. Delete a file you own
  183.  8. Set Software Library
  184.  9. Save Current Software Library
  185. 10. Instructions for Software Exchange
  186. 11. Directory of New Files
  187. 12. Join/Ignore Library Category
  188.  
  189. Enter #, <P>revious, or <H>elp?2
  190.  
  191.  
  192. ALL Libraries
  193.   No. File Name             Type Address      YYMMDD Bytes   Access Lib
  194. ----- ------------------------ - ------------ ------ ------- ------ ---
  195.  
  196.  4400 JONES.NUDE               X GRAFIX.M     870628   20160      5  37
  197.       Desc: 2 views of a gal named Jones.
  198.  4399 FASCINATION.128          X M.KREKLOW    870628    2520      5   8
  199.       Desc: Fascination for C128.
  200.  4398 REM REV128               X RWO          870628    2520      3   9
  201.       Desc: Highlight BASIC 7.0 REM Statements
  202.  4397 WITH OR WITHOUT YOU.SAL  X TIGLON.G     870627    5040     14  17
  203.       Desc: U2 On SIDPlayer!!
  204.  4386 PRINTILITY-2.SDA         X CHUCK.WAGON  870625   35280     25   9
  205.       Desc: Convertor/Stripper/File
  206.  
  207. Note: Press your BREAK key combination to escape from a directory listing.
  208.       See the First Hints text for information on how to SET your BREAK.
  209.       This is usually a CTRL C or a true break.
  210.  
  211.  
  212. Browse, Download and Download from a Browse
  213.   (Examples)
  214.  
  215. The second way to download is to choose #4 Browse from the menu. This will let
  216. you read through the descriptions of the files available, backwards from a
  217. particular file number, and download any that seem of interest. If you want to
  218. look at the newest files in the Library, just press RETURN when it asks you
  219. which file to start Browsing from.
  220.  
  221. When you select #6, Download a file, the description of the file will be
  222. printed out, then you will be given the choice of Skipping the file,
  223. Downloading the file, Listing the file, or just Quitting back to the main menu.
  224. If you are Browsing, you will see this choice of options after each file
  225. description is printed out.
  226.  
  227. If this is not the program you want, just press RETURN to skip it.
  228.  
  229. To tell GEnie you want to Download the file, type  D  and  RETURN.
  230.  
  231. If the file is printed Text, you can choose to List it, and use your Terminal
  232. Program to Capture the text. Note that Listing a Program file will result in
  233. nothing but 'Garbage' on your screen, as most programs are NOT directly
  234. readable. To List a file, type  L  and  RETURN.  You may also download an ASCII
  235. Text File, just like a program file, then read it with your Word Processor.
  236.  
  237. You can Quit back to the Software Library menu by typing  Q  and  RETURN.
  238.  
  239. Once you choose D for Download, GEnie will ask what Protocol you wish to use:
  240.  
  241. Select Download Protocol
  242.  
  243.  1. X-MODEM
  244.  2. X-MODEM (W/1K blocks)
  245.  3. Y-MODEM
  246.  4  Z-MODEM
  247.  
  248. Which item, or <RETURN> to skip?
  249.  
  250.  
  251. GEnie then tells you how many XMODEM blocks are in the file, and then after a
  252. short pause, will say:
  253.  
  254. 'File is ready. Start your X-Modem receive file'.
  255.  
  256. (Note: It is VERY important to wait for this message.        Otherwise problems
  257. may result)
  258.  
  259. When you see that message, and NOT before, go into your Terminal Program and
  260. set it up to receive the file (See the instructions which came with your
  261. Terminal Program for the correct procedure to use). GEnie will wait for you
  262. while you are doing this.
  263.  
  264. If you decide that you don't want to download the program after all, you have
  265. one last chance to cancel the download by typing a CONTROL X  (hold down the
  266. Control key, and press X at the same time).
  267.  
  268. Once you have set up and started the download process, GEnie will begin sending
  269. the program file to your computer in 'Blocks' of 128 bytes (for X-MODEM) or
  270. 1024 bytes for X-MODEM 1K or Y-MODEM. The XMODEM file-transfer protocol means
  271. that after each of these 'blocks' is transmitted, a 'checksum' byte is also
  272. transmitted and compared against a 'checksum' that your computer has
  273. calculated, based on the 128 bytes it received. If the two checksums match, you
  274. can be virtually certain that the data received was correct, and your computer
  275. will automatically signal GEnie to send the next block. If the checksums do NOT
  276. match, GEnie will re-send the block to try again. (The most common cause of
  277. re-transmitted blocks is a 'noisy' telephone line. If you get a large number of
  278. re-sent blocks, it might be a good idea to Quit, and log-off of GEnie, then
  279. call back again in hopes of getting a better telephone connection.)
  280.  
  281. When the download is complete, GEnie will print a summary of how the transfer
  282. went, then ask you to press RETURN. After that, you will either be asked if you
  283. want to download another file, or if you want to continue Browsing.
  284.  
  285. Here is what a typical download session looks like:
  286.  
  287.  
  288. GEnie                     Libraries
  289.       Commodore Software Library
  290.         Library: ALL Libraries
  291.  
  292.  1. Description of this Library
  293.  2. Directory of files
  294.  3. Search File Directory
  295.  4. Browse through files
  296.  5. Upload a new file
  297.  6. Download a file                  <-- Choose Download
  298.  7. Delete a file you own
  299.  8. Set Software Library
  300.  9. Save Current Software Library
  301. 10. Instructions for Software Exchange
  302. 11. Directory of New Files
  303. 12 Join/Ignore Library Category
  304.  
  305. Enter #, <P>revious, or <H>elp?6
  306.  
  307.         --------------------
  308.  Enter number, or name of file?3489     <--Number from the Directory list above
  309.  
  310. *************************************
  311. Number: 3489  Name: BULLETIN BOARD STARTER
  312. Address: DEB        Date: 870331
  313. Approximate # of Bytes: 10080          <--See NOTE about file sizes
  314. Number of Accesses: 40  Library: 1
  315. *************************************
  316. Description:
  317. How to get started with the *FlagShip* Bulletin Board!  Don't miss the hints,
  318. tips, reviews, news and rumors as it happens!  Good tutorial file for your
  319. introduction to this electronic gathering place!
  320. Keywords: HELP,BULLETIN,BOARD,BB,BBOARD,MESSAGES,HLP,FLAGSHIP,HINTS,TIPS
  321. -------------------------------------
  322.  
  323. File: BULLETIN BOARD STARTER
  324. is an XMODEM File.
  325.  
  326. Press <RETURN> to skip, <D>ownload, <L>ist, or <Q>uit.
  327. ?D                                      <--Enter D to Download
  328.  
  329. Select Download Protocol
  330.  
  331. 1. XMODEM
  332. 2. XMODEM (w/1K blocks)
  333. 3. YMODEM
  334. 4. ZMODEM
  335.  
  336. Which item, or <RETURN> to skip?1        <--Enter 1 for X-Modem
  337.  
  338. 137 XMODEM Blocks in file.
  339.  
  340. File is ready. Start your XMODEM receive file. <--WAIT for this message!
  341.  
  342.  
  343. XMODEM: NORMAL TERMINATION              <--Download is finished
  344.       137 FRAMES PROCESSED
  345.         0 FRAMES RETRANSMITTED
  346.         0 TIMEOUTS
  347.  
  348. Press <RETURN>?                        <-- Press RETURN or ENTER
  349.  
  350. Download Complete.
  351.  
  352. Download another file (Y/N)?n           <-- enter Y to download another file
  353.  
  354.  
  355.  
  356. NOTE on file sizes: The SIZE of files on GEnie is reported in APPROXIMATE
  357. figures, based on the blocks of memory used to actually store the files in the
  358. system. Thus the ACTUAL number of bytes a program takes up on YOUR disk at home
  359. will normally be somewhat smaller than the 'Approximate # of Bytes' figure
  360. given on GEnie... THIS IS NORMAL and does NOT indicate that you got a bad
  361. download if the figures don't match!
  362.  
  363.  
  364. Troubleshooting Download Problems
  365. ---------------------------------
  366.  
  367. Possible problems which may occur during downloading are generally related to
  368. conditions on your telephone line. If you have been seeing a lot of 'garbage'
  369. on your screen (xD ` }x) while reading messages, you will probably have
  370. problems downloading. If you see this, or have a lot of blocks being
  371. re-transmitted while downloading, it is always a good idea to log-off of GEnie,
  372. and call back to try to get a better telephone line. Bad telephone connections
  373. can waste your time by causing a lot of re-transmitted blocks, and can even
  374. cause the system to 'lock-up' and stop sending blocks. If this happens, you
  375. will have to hang up on your end and call back anyway.
  376.  
  377. Another problem can occur if you don't wait long enough before starting your
  378. program downloading. GEnie isn't ready to send a file until you see the 'File
  379. is ready. Start your receive file' message. If you start BEFORE seeing this
  380. message, things may never get going properly.
  381.  
  382. Always make sure that you have selected the proper Download Protocol that your
  383. Terminal Program supports.  CBTERM will not perform Y-Modem, (nor will Bob's
  384. Term Pro) for example. Remember, at this time, Z-Modem is not supported by any
  385. Commodore 8-bit terminal program.
  386.  
  387. Your Terminal program also has a number of settings which must be set properly
  388. for downloading to work. Fortunately, most terminal programs come pre-set to
  389. these 'default' settings, so you won't have to worry about them in most cases.
  390. If you DO encounter problems downloading, check to make sure your terminal
  391. program is set like this:
  392.  
  393. 8 Data bits, NO Parity, 1 Stop bit
  394.  
  395. Also, be certain that your MODEM is set for FULL DUPLEX. To be able to see what
  396. you are typing on GEnie, your TERMINAL PROGRAM must normally be set to HALF
  397. DUPLEX, but do not change the setting of your modem!
  398.  
  399. One other area of concern is that IF your terminal program downloads a file to
  400. your disk, but you later find that it has been saved as a sequential file. Some
  401. Terminal Programs DEFAULT to sequential file downloads.  You may find that
  402. adding a ',p,w' to the filename (when you are asked to type it in by your
  403. terminal program) will properly write the file as a program file (PRG).
  404.  
  405.   Example:  "WIZARD128.SFX,p,w"
  406.  
  407. You may also convert the already saved SEQ file to PRG by using several of the
  408. programs designed to do this very thing.
  409.  
  410. If you are using 1200 or 2400 baud, you will want to check and make sure that
  411. the special 1200/2400 baud timing is working correctly for your system. See the
  412. Survival Kit instruction text about "How to set 1200/2400 Baud Rate Factor".
  413.  
  414. If you downloaded a file which requires de-compressing with the ARC utility or
  415. the Library utility, it will NOT run as it is.  Please see the Survival Kit
  416. item about ARC.  Common downloads which require additional action include:
  417.  
  418.    Files ending in:
  419.     .ARC <-- See Survival Kit file about ARC
  420.     .LBR <-- See Survival Kit file about ARC (COLOR64 Only)
  421.     .MUS <-- SIDplayer files- see "Where to look for..." on Survival Kit
  422.     .SDA <-- Self Dissovling Archive
  423.     .SFX <-- Self dissolving Archive (use either 64 or 128 mode)
  424.     .CVT <-- GEOS files that need CONVERT
  425.     .TXT <-- ASCII Text Files (written documents)
  426.     .COM <-- CP/M Files that are not compressed
  427.     .ARK <-- CP/M Files that are compressed
  428.  
  429.    Files beginning in:
  430.     DD   <-- Doodle pictures, see "Where to look for..." on Survival Kit
  431.  
  432.    BASIC 8.0 <C128 graphics package from Lou Wallace> requires BASIC 8 to run.
  433.   GEOS graphics, tools and applications require GEOS to run.
  434.  
  435. If you have problems downloading, be sure to get your PORT number so it can be
  436. reported to GEnie. Just type PORT at a menu prompt or Click on Wizard's PORT
  437. ICON, and write down the entire long number that is returned. This will enable
  438. the GEnie service people to track down the exact parts of the system you were
  439. using when the problem occurred. Send mail to the Commodore Sysops
  440. (COMMODORE$), and try to be as exact in your description of the problems as
  441. possible.  Indicate which files you were downloading, the time of day, the PORT
  442. number, the Terminal Program you were using, hardware configuration, and as
  443. detailed a description of what happened as you can give.  This will enable us
  444. to help you as quickly and easily as we can, and get you back to downloading!
  445.  
  446.  
  447.   Downloading Summary for Library Files
  448.   -------------------------------------
  449.  
  450. 1.  Find a file you want to download by listing the DIRECTORY (#2 on Menu)
  451.  
  452. 2.  Select Download from the Software Library menu (#6).
  453.  
  454. 3.  Read the description. If you want to download this file, enter D.
  455.     To skip this file, just press RETURN.
  456.  
  457. 4.  Select the transfer protocol you wish to use.  If in doubt, use XMODEM.
  458.  
  459. 5.  WAIT for GEnie to say "File is ready. Start your receive file."
  460.  
  461. 6.  Set up your Terminal program for the same protocol you have selected
  462.     and initiate the transfer.
  463.  
  464. 7.  Wait until the file is transferred to your disk.
  465.  
  466.                      OR
  467.                      --
  468.  
  469. 1.  Select Browse from the Software Library menu (#4).
  470.  
  471. 2.  Enter the number of the file you want to Browse backwards from, or
  472.     Just press RETURN to start at the newest files.
  473.  
  474. 3.  Read the description of the files. If you want to download a file,
  475.     enter D. To skip to the next file, press RETURN.
  476.  
  477. 4.  Select the Transfer protocol you wish to use. (#1 to #4).
  478.  
  479. 5.  Wait for GEnie to say "File is ready. Start your receive file".
  480.  
  481. 6.  Set up your Terminal program for the same protocol that you have selected
  482.     and initiate your transfer.
  483.  
  484. 7.  Wait until the file is transferred to your disk.
  485.  
  486. 8.  Press RETURN when indicated, then choose Browse to read the description
  487.     for the next file. Repeat steps 3-7 for all the files you want to download.
  488.  
  489.     ###############################
  490.        Back To Survival Kit Menu!
  491.     ###############################
  492.