ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / COMM / MISC / TAPCIS53.ZIP / TAPDOC.7 < prev next >

Wrap

Text File | 1990-09-28 | 20.6 KB | 571 lines

Section 7 -- Forums: Libraries Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Downloading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Library Search Creating a Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1 Marking Files to Download . . . . . . . . . . . . . . . . . . . . . . 7-2 Catalog Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3 Download the Marked Files . . . . . . . . . . . . . . . . . . . . . . 7-4 Transfer Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5 Downloading Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6 Uploading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7 Upload Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7 Upload Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8 TAPCIS(tm) Documentation Copyright (c) 1990, Support Group, Inc. 800-USA-GROUP, 301-387-4500 ======================================================================== Libraries ======================================================================== The CompuServe forum libraries (LIBs, previously called "data libraries" or DLs) are where files can be uploaded by you for use by others or downloaded from the libraries for use on your computer. The LIBs are numbered just like the message sections. Many forums have LIBs that closely match the corresponding message section. Below you can compare the list of section and library names in the TAPCIS Forum: Libraries Message Sections 1 TAPCIS (tm) 1 TAPCIS Q & A 2 Scripts and Tools 2 Scripts and Tools 3 Modem/HW/OS 3 Modems/HW/OS 4 Problem reports 4 Problem reports 5 Suggestions 5 Suggestion box 6 International 6 International 7 The TAProom 7 The TAProom 8 Threads and stuff 8 Section 8 TAPCIS gives you a list of library names when needed to complete an operation. Online the names are found using the CompuServe NAME command from the function prompt. ------------------------------------ Downloading You can download files using offline commands or by selecting the files when interactive with CompuServe. TAPCIS uses the CompuServe "B+" protocol to do all protocol transfers so that the resulting files are transmitted without uncorrected errors and as efficiently as the communication link allows. ------------------------------------ Library Search Creating a Catalog The way most TAPCIS users download is to first have the program create a catalog of files from the LIBs you select. This catalog includes all the information CompuServe has about the files in the library. You can choose to include all files, files matching a wildcard specification, files less than a certain number of days old, files listed under certain keywords, or a combination of these. Press <L> to start the Library Search command. Enter the forum number if prompted. TAPCIS asks: Search by name ? y/n: N In this example we are not searching the LIBs for a particular name so press <N>o. (If you know the exact name and LIB, you can enter those and have TAPCIS automatically download just that one file). The next prompt requests: Keyword -- <Enter> for all : <Enter> Keywords help to put the many files that can be in a single LIB into categories. Even if you don't know a specific filename, you might guess that WordPerfect macros would have the keyword "MACRO" or "MACROS." Here we're TAPCIS Forums: Libraries 7-1 trying to get a listing of all files so the <Enter> key is pressed to select all keywords. Unfortunately, TAPCIS cannot give you a listing of keywords to choose from. <Enter> or Age in days : <Enter> The above prompt allows you to limit the search to files added within a certain number of days. This is a very convenient way of updating your catalog every week (7 days) or month (31 days). If you have an existing .CAT file TAPCIS will use the age of that file as the default at the Age: prompt. We'll get the full listing by pressing <Enter> (first deleting with backspace any number offered as a default age). TAPCIS then offers a list of available libraries in a box to the right and asks you to choose which ones you want to catalog. You can back out of the command at this point by pressing <Enter> without entering any LIB numbers. The LIB numbers must be separated by spaces and followed by <Enter> when you type them in as shown in the screen above where LIBs 1 (TAPCIS (tm)), 2 (Scripts and Tools), and 3 (Modem/Hardware/Operating System) are to be cataloged. The final question asks: Additional searches? y/n: N If you do not have any additional catalog commands to perform in this forum, press <N>o and TAPCIS will return to the main menu. At the bottom of the screen next to the forum number you'll find the upside-down triangle indicating a LIB action. Press <O>nline to go online and search the data libraries. ------------------------------------ Marking Files to Download Once the catalog is saved in the <forum>.CAT file, you can mark the files for downloading at your convenience. TAPCIS does not show an indicator on the status line for forums with catalogs. Press <C>atalog at the main menu prompt to process the catalog. Answer the forum number prompt if you have more than one forum defined. While the catalog files are being scanned, TAPCIS will show: Files: nnn Sessions: nn Libraries: nn FORUM on the top status line. When all the files have been scanned by TAPCIS, the first entry in the catalog will appear. Each file is shown separately on a screen similar to Figure 0. The status line indicates that this is the first file out of 74 files in the catalog for the TAPCIS Forum. This particular file is from LIB 1. The user ID in brackets [ ]'s above the filename is the number for the person who uploaded 7-2 Forums: Libraries TAPCIS this file to the library. This person may or may not be the author of the file. The next line can be decoded as: TAPCIS.INF The filename which can be up to six characters followed by a period and a 3 character extension. If the filename was followed by "/binary" then it would indicate a file that must be downloaded using a protocol. The absence of "/binary" indicates that this is an ASCII file which can be read online or downloaded. Other files can be stored in various graphics formats such as GIF. 05-Aug-90 The date the file was submitted to the library 24354 The approximate size of the file in bytes 1788 The number of downloads of this file since it was submitted This file has a long list of keywords to help users find the file. The description below the keywords explains the contents of the file. If you want to download this file press <D>ownload. TAPCIS stores a script for downloading the file in the DOS file <forum>.DOW which will be processed the next time TAPCIS goes <O>nline. The other commands available are summarized at the bottom of the screen. Press <F3-Help> for more information. ------------------------------------ Catalog Commands <D> Mark the file downloading the next time online with the autopilot. <Space> Go on to the next file in the catalog <Enter> <Down Arrow> <B>ack Go back to the previous file in the catalog <Up Arrow> <1> Position to the first file <9> Go to the last file in the catalog <2> Skip to the top of the next library <F> Find a string in the keywords and descriptions. You may also search on filenames, user IDs, extensions, or any other text in the file. <N> Position to the next occurrence of the search string (if any) <F7-Exit> Exit the catalog <Esc> ------------------------------------ TAPCIS Forums: Libraries 7-3 Download the Marked Files If you mark any files for downloading, the triangle will appear next to the forum number on the main menu. Go online with the <O>nline command to download the files to your computer. TAPCIS goes to the forum with files to download and issues the command "LIB nn" where nn is the library containing the file. The program then BROwses the file so you see which file is about to be downloaded. It then issues the command: DOW/PROTO:B CompuServe asks for the file for your computer. TAPCIS provides the full download path from your <P>arameters screen followed by the CompuServe filename for this file. If another file of the same name is in the download path, TAPCIS prompts you: File exists. Y to verify or resume; N to overwrite If you wish to have the file currently in your download path overwritten with the file that is on CompuServe, press <N> within 30 seconds. TAPCIS beeps every few seconds to get your attention in case you are not watching the screen. If you do not press <N> within 30 seconds, or if you press <Y>, TAPCIS tells CompuServe that it has a file of a certain length and CRC. If CompuServe sees that the file you have on your disk is a partial copy of the file you've asked to download, it resumes the download from the end of your file. Otherwise, the download is aborted and your file is left untouched. You'll need to delete it and re-select the file using <C>atalog <D>ownload in order to download the file. If the download fails in the middle, TAPCIS will ask you whether you want to retain the partial file. Saving the partial file, then re-trying the download can save significant time if a large part of the file has already been captured. At the top of the screen in Figure 0 is the TAPCIS version number, a note that the entire session is being captured to ONLINE.LOG (TAPCIS was started using the G start-up option), and the time the transfer was started. Below the top status line is the description of the file being downloaded. The protocol status box at the bottom has at the top a reminder that <F1> will abort the transfer (after a delay for TAPCIS to convince CompuServe that it wants to abort). The box shows that the full B Plus Protocol is being used to transfer this file. CRC's are being used to detect any errors in the transmission. The data in the file is being broken into chunks (packets) of 1K (1024 bytes). This is a download of an ASCII file (rather than a binary file). It is being stored in the download storage path, C:\TAP\DL in the file TAPCIS.INF. The left section has four columns: Port, Data, File, and Remaining. The rows are Received (Rec'd), Sent, Rate (in characters per second), and Percent efficiency (% Eff). 7-4 Forums: Libraries TAPCIS In the example above, 14451 bytes have been received by the modem through the serial port. Of that, 14336 bytes were data. The difference of 115 bytes is the B Plus protocol overhead. The File column also shows 14336 bytes. That means that this download started from the beginning of the file. If it were a restart of an aborted download, the File count will be higher than the Data count. TAPCIS still needs to receive the remaining 10018 bytes in the file. If you add the Remaining figure to the File figure, you get the total length of the file shown in the top right of the box. On the Sent line you can see that TAPCIS has sent 30 bytes back to CompuServe to start the download and acknowledge the packets. The Rate and % Eff lines go together. This call is at 2400 baud, with a maximum throughput of roughly 240 bytes per second. The Port Rate shows that the full 240 cps maximum rate has been achieved for an efficiency rate of 100%. In this example we have a clean line, no errors that had to be retransmitted, and a data efficiency of 99%. Why the discrepancy? The CompuServe "B Plus" protocol-like any file transfer protocol-has a certain amount of overhead. Each packet of data is sent with a header, data, and some check digits called a CRC. The CRC is what insures that the packet was received correctly. Without the overhead, erroneous data could be stored in your downloaded file without your knowing it. For binary transfers the discrepancy will be larger because of the need to mask some 8- bit characters. The section at the right shows the current time (03:11:47), the elapsed time of 1 minute, and the estimated time remaining of 0:42. The estimated time is based on bytes remaining divided by the current data rate in bytes per second. Under the estimated time remaining are the number of data packets exchanged and the number of errors detected. The B Plus protocol is an "error detecting" protocol. If an error is detected, the protocol asks for a resend of the damaged packet. TAPCIS does not store the data on disk until it has been received error-free. ------------------------------------ Transfer Log Downloading files without user intervention is one of the ways TAPCIS can save you time and money. If you use this feature, it is wise to also turn on transfer logging so you can later review whether the transfer was completed properly. Press <P>arameters from the main menu, then press <L>og until it says either "Transfers" or "Time and transfers." The status information and file descriptions are logged in the file XFER.LOG. You can then review this information using a file viewer, the DOS TYPE command, or an external editor or file viewer. TAPCIS does not delete this log, so you will need to delete the file from DOS using: [C:\TAP] DEL XFER.LOG TAPCIS Forums: Libraries 7-5 ------------------------------------ Downloading Tips * Download during off-hours when the system is not heavily loaded for the best time and money savings. * Download a few files at a time. You need not go through the entire catalog on one pass. The catalog will remain until deleted by you. However, files do get removed from CompuServe or get switched from one library to another. You should get an updated catalog if the one on disk is old. * If you start getting beeps during the download, the protocol is detecting errors. If it gets excessive, you should abort and retry the downloading. You can safely save the partial file despite the errors reported. Only valid data gets written to disk. When you try again, the transfer will resume from where it left off. * Be sure to check the file size before marking the file for downloading. A file may sound very interesting but may not be worth an hour or two of download time. Some of the best software available online (like TAPCIS) is quite large (well over 200K archived). You may want to ask for opinions before spending a lot of money downloading a large (over 100,000 byte) file. * If the download of a series of files is interrupted, you should <K>ill the <D>OW file for that forum and go back to the <C>atalog command to redo the list of files to download, omitting the ones that already came through okay. TAPCIS won't download the same file twice, but it does take 30 seconds or more for each duplicated file to be skipped. If you use the <E>dit <D>OW command to remove the files, be sure to remove all three lines associated with the file (LIB, BRO, and DOW). * Turn on transfer logging and review the XFER.LOG file after a batch download of several files is completed. Delete the log file if you are short on disk space. The log can be useful for determining where, what, who, and when a particular file was downloaded. * <Alt-Q> is a toggle command that tells TAPCIS that you want to logoff after the in-progress file transfer. If ON, a "Q" appears next to the elapsed/remaining times in the status box. Note: it can take several seconds for this to update. <Alt-Q> when not doing a protocol transfer will send an immediate BYE. 7-6 Forums: Libraries TAPCIS ======================================================================== Uploading ======================================================================== Uploading is the process of taking a file from your computer and submitting a copy to a forum library. It is one of the few processes not fully automated by TAPCIS. Fortunately, the actual uploading is currently free of CompuServe connect charges (network surcharges do still apply during your upload). First we go online using the <I>nteractive command. Enter the number of the forum where you'll be uploading the file when prompted. TAP dials the phone, logs in, and goes to the forum. On the screen you'll be left at a prompt that says: Forum ! LIB 2 You need to enter the command LIB followed by the number of the LIB for your file. If you can't remember which LIB is most appropriate, type NAME at the prompt. The following dialogue between a user uploading the file C:\FILES\WEA.ARC demonstrates the uploading process. Upload Dialogue Forum ! LIB 2 LIB 2 ! UPL Suspending connect charges... File name: WEA.ARC Transfer types available - 1 ASCII 2 Binary 3 Image 4 Graphic:RLE 5 Graphic:NAPLPS 6 Graphic:GIF Enter choice ! 2 File name for your computer: C:\FILES\WEA.ARC <The transfer takes place here. It begins and ends automatically.> Enter Description (465 chars max, /EXIT when finished): This is a script and documentation file for downloading today's weather and storing it in the file TODAY.WEA. /EXIT Keywords: SCRIPT WEATHER WEA TODAY Keywords: SCRIPT WEATHER WEA TODAY TAPCIS Forums: Libraries 7-7 This is a script and documentation file for downloading today's weather and storing it in the file TODAY.WEA. Is this okay (Y or N)? Y Copying file to Library... Your request will be processed by the Sysop as soon as possible. Resuming connect charges. LIB 2 ! OFF Thank you for using CompuServe! Off at 17:41 EST 2-Sep-90 Connect time = 0:03 ------------------------------------ Upload Tips * You can shorten the above dialogue by providing the necessary information on a single line as in: UPL FILENA.EXT/typ:bin If the file is ASCII, replace "/typ:bin" with "/typ:asc". Most files should be uploaded as binary files! * Always archive (ZIP) files over 10K or if multiple files are in the "distribution" such as a series of macros or a utility with documentation. Separate files make it difficult to download all the files and keep them together. Archiving also preserves file integrity better. * Keywords are important. Make yours meaningful. Think about how you would try to locate the file if you did not know its name. * Descriptions should give a clear picture of the contents and purpose of the file. If it is a demo, say so. If you are the author, say so and give your name. If you are uploading with permission of the author, indicate that and give the authors name (and user ID if any). The more info you provide, the less follow-up required by the sysops. * The limit for DEScriptions is 465 characters, for KEYwords 80 characters, and for Titles 50 characters. * Files are "merged" (made visible) by the sysops on a regular basis. Sysops try to verify every upload before the files are made available to the forum membership. This can sometimes take a few days. If your file is not merged after a few days, drop a message to *SYSOP to see if there was a problem with the upload. * Don't upload files you don't have the right to make available for public downloading. 7-8 Forums: Libraries TAPCIS * The maximum length of a file name is 6 characters plus a 3 letter extension. CompuServe will truncate longer filenames. Also, avoid using special characters in the filename. CompuServe truncates a name like MDM_CMDS.ARC to MDM. TAPCIS Forums: Libraries 7-9