home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO022.ZIP / TAPDOC.EXE / TAPDOC.7 < prev    next >
Text File  |  1990-09-28  |  21KB  |  571 lines
  1.  
  2. Section 7 -- Forums: Libraries
  3.  
  4.  
  5. Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-1
  6.    Downloading  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-1
  7.    Library Search
  8. Creating a Catalog  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-1
  9.    Marking Files to Download  . . . . . . . . . . . . . . . . . . . . . .  7-2
  10.    Catalog Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-3
  11.    Download the Marked Files  . . . . . . . . . . . . . . . . . . . . . .  7-4
  12.    Transfer Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-5
  13.    Downloading Tips . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-6
  14.  
  15. Uploading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-7
  16.       Upload Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . .  7-7
  17.    Upload Tips  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7-8
  18.  
  19.  
  20. TAPCIS(tm) Documentation Copyright (c) 1990, Support Group, Inc.
  21. 800-USA-GROUP, 301-387-4500
  22.  
  23. ========================================================================
  24. Libraries
  25. ========================================================================
  26.  
  27. The CompuServe forum libraries (LIBs, previously called "data libraries" or
  28. DLs) are where files can be uploaded by you for use by others or downloaded
  29. from the libraries for use on your computer.  The LIBs are numbered just like
  30. the message sections.  Many forums have LIBs that closely match the
  31. corresponding message section.  Below you can compare the list of section and
  32. library names in the TAPCIS Forum:
  33.  
  34. Libraries            Message Sections
  35.  
  36. 1 TAPCIS (tm)        1 TAPCIS Q & A
  37. 2 Scripts and Tools  2 Scripts and Tools
  38. 3 Modem/HW/OS        3 Modems/HW/OS
  39. 4 Problem reports    4 Problem reports
  40. 5 Suggestions        5 Suggestion box
  41. 6 International      6 International
  42. 7 The TAProom        7 The TAProom
  43. 8 Threads and stuff  8 Section 8                   
  44.  
  45. TAPCIS gives you a list of library names when needed to complete an operation. 
  46. Online the names are found using the CompuServe NAME command from the function
  47. prompt.
  48.  
  49. ------------------------------------
  50. Downloading
  51.  
  52. You can download files using offline commands or by selecting the files when
  53. interactive with CompuServe.  TAPCIS uses the CompuServe "B+" protocol to do
  54. all protocol transfers so that the resulting files are transmitted without
  55. uncorrected errors and as efficiently as the communication link allows.
  56.  
  57. ------------------------------------
  58. Library Search
  59. Creating a Catalog
  60.  
  61. The way most TAPCIS users download is to first have the program create a
  62. catalog of files from the LIBs you select.  This catalog includes all the
  63. information CompuServe has about the files in the library.  You can choose to
  64. include all files, files matching a wildcard specification, files less than a
  65. certain number of days old, files listed under certain keywords, or a
  66. combination of these.
  67.  
  68. Press <L> to start the Library Search command.  Enter the forum number if
  69. prompted.  TAPCIS asks:   Search by name ?   y/n: N
  70.  
  71. In this example we are not searching the LIBs for a particular name so press
  72. <N>o.  (If you know the exact name and LIB, you can enter those and have
  73. TAPCIS automatically download just that one file).  The next prompt requests:
  74.  
  75. Keyword -- <Enter> for all :  <Enter>
  76.  
  77. Keywords help to put the many files that can be in a single LIB into
  78. categories.  Even if you don't know a specific filename, you might guess that
  79. WordPerfect macros would have the keyword "MACRO" or "MACROS."  Here we're
  80.  
  81.  
  82. TAPCIS                                               Forums:  Libraries    7-1
  83.  
  84. trying to get a listing of all files so the <Enter> key is pressed to select
  85. all keywords.  Unfortunately, TAPCIS cannot give you a listing of keywords to
  86. choose from.
  87.  
  88. <Enter> or Age in days :  <Enter>
  89.  
  90. The above prompt allows you to limit the search to files added within a
  91. certain number of days.  This is a very convenient way of updating your
  92. catalog every week (7 days) or month (31 days).  If you have an existing .CAT
  93. file TAPCIS will use the age of that file as the default at the Age: prompt. 
  94. We'll get the full listing by pressing <Enter> (first deleting with backspace
  95. any number offered as a default age).
  96.  
  97. TAPCIS then offers a list of available libraries in a box to the right and
  98. asks you to choose which ones you want to catalog.  You can back out of the
  99. command at this point by pressing <Enter> without entering any LIB numbers.
  100.  
  101. The LIB numbers must be separated by spaces and followed by <Enter> when you
  102. type them in as shown in the screen above where LIBs 1 (TAPCIS (tm)), 2
  103. (Scripts and Tools), and 3 (Modem/Hardware/Operating System) are to be
  104. cataloged.
  105.  
  106. The final question asks:
  107.  
  108. Additional searches?  y/n:  N
  109.  
  110. If you do not have any additional catalog commands to perform in this forum,
  111. press <N>o and TAPCIS will return to the main menu.  At the bottom of the
  112. screen next to the forum number you'll find the upside-down triangle
  113. indicating a LIB action.  Press <O>nline to go online and search the data
  114. libraries.
  115.  
  116.  
  117. ------------------------------------
  118. Marking Files to Download
  119.  
  120. Once the catalog is saved in the <forum>.CAT file, you can mark the files for
  121. downloading at your convenience.  TAPCIS does not show an indicator on the
  122. status line for forums with catalogs.
  123.  
  124. Press <C>atalog at the main menu prompt to process the catalog.  Answer the
  125. forum number prompt if you have more than one forum defined.  While the
  126. catalog files are being scanned, TAPCIS will show:
  127.  
  128.    Files:       nnn
  129. Sessions:       nn
  130. Libraries:      nn
  131.   FORUM  
  132.  
  133. on the top status line.  When all the files have been scanned by TAPCIS, the
  134. first entry in the catalog will appear.  Each file is shown separately on a
  135. screen similar to Figure 0.
  136.  
  137.  
  138. The status line indicates that this is the first file out of 74 files in the
  139. catalog for the TAPCIS Forum. This particular file is from LIB 1.  The user ID
  140. in brackets [ ]'s above the filename is the number for the person who uploaded
  141.  
  142.  
  143. 7-2    Forums:  Libraries                                               TAPCIS
  144.  
  145. this file to the library.  This person may or may not be the author of the
  146. file.  The next line can be decoded as: 
  147.  
  148. TAPCIS.INF  The filename which can be up to six characters followed by a
  149.             period and a 3 character extension.  If the filename was followed
  150.             by "/binary" then it would indicate a file that must be downloaded
  151.             using a protocol. The absence of "/binary" indicates that this is
  152.             an ASCII file which can be read online or downloaded.  Other files
  153.             can be stored in various graphics formats such as GIF.
  154.  
  155. 05-Aug-90   The date the file was submitted to the library
  156.  
  157. 24354       The approximate size of the file in bytes
  158.  
  159. 1788        The number of downloads of this file since it was submitted
  160.  
  161. This file has a long list of keywords to help users find the file. The
  162. description below the keywords explains the contents of the file.  If you want
  163. to download this file press <D>ownload.  TAPCIS stores a script for
  164. downloading the file in the DOS file <forum>.DOW which will be processed the
  165. next time TAPCIS goes <O>nline.  The other commands available are summarized
  166. at the bottom of the screen. Press <F3-Help> for more information.
  167.  
  168. ------------------------------------
  169. Catalog Commands
  170.  
  171.  
  172. <D>         Mark the file downloading the next time online with the autopilot.
  173.  
  174. <Space>     Go on to the next file in the catalog
  175. <Enter>
  176. <Down Arrow>
  177.  
  178. <B>ack      Go back to the previous file in the catalog
  179. <Up Arrow>
  180.  
  181. <1>         Position to the first file
  182.  
  183. <9>         Go to the last file in the catalog
  184.  
  185. <2>         Skip to the top of the next library
  186.  
  187. <F>         Find a string in the keywords and descriptions. You may also
  188.             search on filenames, user IDs, extensions, or any other text in
  189.             the file.
  190.  
  191. <N>         Position to the next occurrence of the search string (if any)
  192.  
  193. <F7-Exit>   Exit the catalog
  194. <Esc>
  195.  
  196.  
  197. ------------------------------------
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. TAPCIS                                               Forums:  Libraries    7-3
  205.  
  206. Download the Marked Files
  207.  
  208. If you mark any files for downloading, the triangle will appear next to the
  209. forum number on the main menu.  Go online with the <O>nline command to
  210. download the files to your computer.
  211.  
  212. TAPCIS goes to the forum with files to download and issues the command "LIB
  213. nn" where nn is the library containing the file.  The program then BROwses the
  214. file so you see which file is about to be downloaded.  It then issues the
  215. command: 
  216.  
  217. DOW/PROTO:B
  218.  
  219. CompuServe asks for the file for your computer.  TAPCIS provides the full
  220. download path from your <P>arameters screen followed by the CompuServe
  221. filename for this file.
  222.  
  223. If another file of the same name is in the download path, TAPCIS prompts you:
  224.  
  225. File exists.  Y to verify or resume; N to overwrite
  226.  
  227. If you wish to have the file currently in your download path overwritten with
  228. the file that is on CompuServe, press <N> within 30 seconds.  TAPCIS beeps
  229. every few seconds to get your attention in case you are not watching the
  230. screen.  If you do not press <N> within 30 seconds, or if you press <Y>,
  231. TAPCIS tells CompuServe that it has a file of a certain length and CRC.  If
  232. CompuServe sees that the file you have on your disk is a partial copy of the
  233. file you've asked to download, it resumes the download from the end of your
  234. file.
  235.  
  236. Otherwise, the download is aborted and your file is left untouched.  You'll
  237. need to delete it and re-select the file using <C>atalog <D>ownload in order
  238. to download the file.
  239.  
  240. If the download fails in the middle, TAPCIS will ask you whether you want to
  241. retain the partial file.  Saving the partial file, then re-trying the download
  242. can save significant time if a large part of the file has already been
  243. captured.  
  244.  
  245. At the top of the screen in Figure 0 is the TAPCIS version number, a note that
  246. the entire session is being captured to ONLINE.LOG (TAPCIS was started using
  247. the G start-up option), and the time the transfer was started.  Below the top
  248. status line is the description of the file being downloaded.
  249.  
  250. The protocol status box at the bottom has at the top a reminder that <F1> will
  251. abort the transfer (after a delay for TAPCIS to convince CompuServe that it
  252. wants to abort).
  253.  
  254. The box shows that the full B Plus Protocol is being used to transfer this
  255. file.  CRC's are being used to detect any errors in the transmission.  The
  256. data in the file is being broken into chunks (packets) of 1K (1024 bytes). 
  257. This is a download of an ASCII file (rather than a binary file).  It is being
  258. stored in the download storage path, C:\TAP\DL in the file TAPCIS.INF.
  259.  
  260. The left section has four columns:  Port, Data, File, and Remaining. The rows
  261. are Received (Rec'd), Sent, Rate (in characters per second), and Percent
  262. efficiency (% Eff).
  263.  
  264.  
  265. 7-4    Forums:  Libraries                                               TAPCIS
  266.  
  267.  
  268. In the example above, 14451 bytes have been received by the modem through the
  269. serial port.  Of that, 14336 bytes were data.  The difference of 115 bytes is
  270. the B Plus protocol overhead.  The File column also shows 14336 bytes.  That
  271. means that this download started from the beginning of the file.  If it were a
  272. restart of an aborted download, the File count will be higher than the Data
  273. count.
  274.  
  275. TAPCIS still needs to receive the remaining 10018 bytes in the file.  If you
  276. add the Remaining figure to the File figure, you get the total length of the
  277. file shown in the top right of the box.
  278.  
  279. On the Sent line you can see that TAPCIS has sent 30 bytes back to CompuServe
  280. to start the download and acknowledge the packets.
  281.  
  282. The Rate and % Eff lines go together.  This call is at 2400 baud, with a
  283. maximum throughput of roughly 240 bytes per second.  The Port Rate shows that
  284. the full 240 cps maximum rate has been achieved for an efficiency rate of
  285. 100%.  In this example we have a clean line, no errors that had to be
  286. retransmitted, and a data efficiency of 99%.
  287.  
  288. Why the discrepancy?  The CompuServe "B Plus" protocol-like any file transfer
  289. protocol-has a certain amount of overhead.  Each packet of data is sent with a
  290. header, data, and some check digits called a CRC.  The CRC is what insures
  291. that the packet was received correctly.  Without the overhead, erroneous data
  292. could be stored in your downloaded file without your knowing it. For binary
  293. transfers the discrepancy will be larger because of the need to mask some 8-
  294. bit characters.
  295.  
  296. The section at the right shows the current time (03:11:47), the elapsed time
  297. of 1 minute, and the estimated time remaining of 0:42.  The estimated time is
  298. based on bytes remaining divided by the current data rate in bytes per second.
  299.  
  300. Under the estimated time remaining are the number of data packets exchanged
  301. and the number of errors detected.  The B Plus protocol is an "error
  302. detecting" protocol.  If an error is detected, the protocol asks for a resend
  303. of the damaged packet.  TAPCIS does not store the data on disk until it has
  304. been received error-free.
  305.  
  306. ------------------------------------
  307. Transfer Log
  308.  
  309. Downloading files without user intervention is one of the ways TAPCIS can save
  310. you time and money.  If you use this feature, it is wise to also turn on
  311. transfer logging so you can later review whether the transfer was completed
  312. properly.  Press <P>arameters from the main menu, then press <L>og until it
  313. says either "Transfers" or "Time and transfers."
  314.  
  315. The status information and file descriptions are logged in the file XFER.LOG. 
  316. You can then review this information using a file viewer, the DOS TYPE
  317. command, or an external editor or file viewer.  TAPCIS does not delete this
  318. log, so you will need to delete the file from DOS using:
  319.  
  320. [C:\TAP]  DEL XFER.LOG
  321.  
  322.  
  323.  
  324.  
  325.  
  326. TAPCIS                                               Forums:  Libraries    7-5
  327.  
  328. ------------------------------------
  329. Downloading Tips
  330.  
  331.   *   Download during off-hours when the system is not heavily loaded for the
  332.       best time and money savings.
  333.  
  334.   *   Download a few files at a time.  You need not go through the entire
  335.       catalog on one pass.  The catalog will remain until deleted by you. 
  336.       However, files do get removed from CompuServe or get switched from one
  337.       library to another.  You should get an updated catalog if the one on
  338.       disk is old.
  339.  
  340.   *   If you start getting beeps during the download, the protocol is
  341.       detecting errors.  If it gets excessive, you should abort and retry the
  342.       downloading.  You can safely save the partial file despite the errors
  343.       reported.  Only valid data gets written to disk.  When you try again,
  344.       the transfer will resume from where it left off.
  345.  
  346.   *   Be sure to check the file size before marking the file for downloading. 
  347.       A file may sound very interesting but may not be worth an hour or two of
  348.       download time.  Some of the best software available online (like TAPCIS)
  349.       is quite large (well over 200K archived).  You may want to ask for
  350.       opinions before spending a lot of money downloading a large (over
  351.       100,000 byte) file.
  352.  
  353.   *   If the download of a series of files is interrupted, you should <K>ill
  354.       the <D>OW file for that forum and go back to the <C>atalog command to
  355.       redo the list of files to download, omitting the ones that already came
  356.       through okay.  TAPCIS won't download the same file twice, but it does
  357.       take 30 seconds or more for each duplicated file to be skipped. If you
  358.       use the <E>dit <D>OW command to remove the files, be sure to remove all
  359.       three lines associated with the file (LIB, BRO, and DOW).
  360.  
  361.   *   Turn on transfer logging and review the XFER.LOG file after a batch
  362.       download of several files is completed.  Delete the log file if you are
  363.       short on disk space.  The log can be useful for determining where, what,
  364.       who, and when a particular file was downloaded.
  365.  
  366.   *   <Alt-Q> is a toggle command that tells TAPCIS that you want to logoff
  367.       after the in-progress file transfer.  If ON, a "Q" appears next to the
  368.       elapsed/remaining times in the status box.  Note:  it can take several
  369.       seconds for this to update.  <Alt-Q> when not doing a protocol transfer
  370.       will send an immediate BYE.
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387. 7-6    Forums:  Libraries                                               TAPCIS
  388.  
  389. ========================================================================
  390. Uploading
  391. ========================================================================
  392.  
  393. Uploading is the process of taking a file from your computer and submitting a
  394. copy to a forum library.  It is one of the few processes not fully automated
  395. by TAPCIS.  Fortunately, the actual uploading is currently free of CompuServe
  396. connect charges (network surcharges do still apply during your upload).
  397.  
  398. First we go online using the <I>nteractive command.  Enter the number of the
  399. forum where you'll be uploading the file when prompted.  TAP dials the phone,
  400. logs in, and goes to the forum.  On the screen you'll be left at a prompt that
  401. says:
  402.  
  403. Forum ! LIB 2
  404.  
  405. You need to enter the command LIB followed by the number of the LIB for your
  406. file.  If you can't remember which LIB is most appropriate, type NAME at the
  407. prompt.  The following dialogue between a user uploading the file
  408. C:\FILES\WEA.ARC demonstrates the uploading process.
  409.  
  410. Upload Dialogue
  411.  
  412. Forum ! LIB 2
  413.  
  414. LIB 2 ! UPL
  415.  
  416. Suspending connect charges...
  417.  
  418. File name: WEA.ARC
  419.  
  420. Transfer types available -
  421.  
  422. 1 ASCII
  423. 2 Binary
  424. 3 Image
  425. 4 Graphic:RLE
  426. 5 Graphic:NAPLPS
  427. 6 Graphic:GIF
  428.  
  429. Enter choice ! 2
  430. File name for your computer: C:\FILES\WEA.ARC
  431.  
  432. <The transfer takes place here.  It begins and ends automatically.>
  433.  
  434. Enter Description (465 chars max, /EXIT when finished):
  435.  
  436. This is a script and documentation file for downloading today's weather and
  437. storing it in the file TODAY.WEA.
  438. /EXIT
  439.  
  440. Keywords: 
  441. SCRIPT WEATHER WEA TODAY
  442.  
  443. Keywords: 
  444. SCRIPT WEATHER WEA TODAY
  445.  
  446.  
  447.  
  448. TAPCIS                                               Forums:  Libraries    7-7
  449.  
  450. This is a script and documentation file for downloading today's weather and
  451. storing it in the file TODAY.WEA.
  452.  
  453. Is this okay (Y or N)? Y
  454. Copying file to Library...
  455. Your request will be processed by the
  456. Sysop as soon as possible.
  457.  
  458. Resuming connect charges.
  459.  
  460. LIB 2 ! OFF
  461.  
  462. Thank you for using CompuServe!
  463.  
  464. Off at 17:41 EST 2-Sep-90
  465. Connect time = 0:03
  466.  
  467.  
  468. ------------------------------------
  469. Upload Tips
  470.  
  471.   *   You can shorten the above dialogue by providing the necessary
  472.       information on a single line as in:
  473.  
  474.       UPL FILENA.EXT/typ:bin
  475.  
  476.       If the file is ASCII, replace "/typ:bin" with "/typ:asc".  Most files
  477.       should be uploaded as binary files!
  478.  
  479.   *   Always archive (ZIP) files over 10K or if multiple files are in the
  480.       "distribution" such as a series of macros or a utility with
  481.       documentation.  Separate files make it difficult to download all the
  482.       files and keep them together.  Archiving also preserves file integrity
  483.       better. 
  484.  
  485.   *   Keywords are important.  Make yours meaningful.  Think about how you
  486.       would try to locate the file if you did not know its name.
  487.  
  488.   *   Descriptions should give a clear picture of the contents and purpose of
  489.       the file.  If it is a demo, say so.  If you are the author, say so and
  490.       give your name.  If you are uploading with permission of the author,
  491.       indicate that and give the authors name (and user ID if any).  The more
  492.       info you provide, the less follow-up required by the sysops.
  493.  
  494.   *   The limit for DEScriptions is 465 characters, for KEYwords 80
  495.       characters, and for Titles 50 characters.
  496.  
  497.   *   Files are "merged" (made visible) by the sysops on a regular basis. 
  498.       Sysops try to verify every upload before the files are made available to
  499.       the forum membership.  This can sometimes take a few days.  If your file
  500.       is not merged after a few days, drop a message to *SYSOP to see if there
  501.       was a problem with the upload.
  502.  
  503.   *   Don't upload files you don't have the right to make available for public
  504.       downloading.
  505.  
  506.  
  507.  
  508.  
  509. 7-8    Forums:  Libraries                                               TAPCIS
  510.  
  511.   *   The maximum length of a file name is 6 characters plus a 3 letter
  512.       extension.  CompuServe will truncate longer filenames.  Also, avoid
  513.       using special characters in the filename.  CompuServe truncates a name
  514.       like MDM_CMDS.ARC to MDM.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570. TAPCIS                                               Forums:  Libraries    7-9
  571.