You are here: start » sysops_guide » file_transfers

File Transfers

File Transfers

Uploading Files

When you upload files you are adding files to the bulletin board system. The files are posted so other users may download the files.

How to Upload Files

In order to upload a file, you must specify the filename(s) you will be uploading and a description for each file uploaded. Once all of the files and descriptions have been entered, you may begin the file transfer.

As an example, we will upload a file called MNHIT110.ZIP. Begin by entering U at a conference command prompt to initiate an upload. PCBoard will display the following prompt:

(1) Enter the Filename to Upload (Enter)=none?

At this prompt, enter the filename which is MNHIT110.ZIP. Now, you are asked to enter a description for the filename that you just entered. You need to enter at least 5 characters for the filename. You are told how many 45 character description lines you can enter. We will enter the following:

Before beginning, enter a description of: MNHIT110.ZIP Begin description with (/) to make upload `Private'.

Enter your text. (Enter) alone to end. (45 chars/line, 12 lines maximum)
? (MANHIT v1.10 -- Utility you can use to enhance)
? (your computer/system security.                )

On the next blank description line, press ENTER to finish entering the description. You will now either be asked for another filename to transfer or the transfer will begin. It all depends on how you answered the Promote to Batch Transfers question in PCBSetup | Configuration Options | File Transfers. If you are asked for another filename, you may enter another filename to transfer or press ENTER to begin the transfer.

The transfer should now begin. There is a different method for uploading from remote or locally. The following describes each.

Remote

You need to transfer a file using your communications program. With most communication programs you can do this by pressing PgUp. You are usually prompted for the protocol you wish to use for the transfer. Make sure you select the same one as you did on the bulletin board system. Once you select the protocol, you are asked for the filename(s) you wish to transfer. Enter the location to find the files you want to upload on your disk and press ENTER. At this point you will see the files being transferred.

Local

Local uploads are a little different because PCBoard is in control. To perform a local upload, you need to make sure you have selected an internal protocol to PCBoard. At the point where you would press u from remote to begin the transfer you will see the following prompt at the top of your screen:

Local Upload Path or Filename? (                         )

In this field, enter the filename(s) you want to upload. For example, if you want to upload a single file called MNHIT110.ZIP that is located in D:\TEMP\, enter D:\TEMP\MNHIT110.ZIP at this prompt. If you want to upload every file in D:\TEMP\, enter D:\TEMP*.*.

If your file transfer is aborted, it may occur for any of the following reasons:

  • You were using an internal protocol, and one or more of the files you were transferring duplicated filenames already on the system. The non-duplicate files (if any) will still be transferred, but you will receive the transfer aborted message to let you know one or more of your files were aborted.
  • You took too long to begin the transfer. The internal protocols in PCBoard give you approximately 60 seconds to begin the transfer. Most external protocols have a built in time-out value as well.
  • If you are prompted for any descriptions after the transfer has taken place, you have done an unannounced upload. This is where you send files you did not inform PCBoard you would be sending. Because PCBoard requires each filename to have a description, it will ask you for a description if it cannot find one.
  • Before PCBoard asks for a description, however, it will check the file to see if it has a FILEID.DIZ in it. If so, the file will be immediately tested without prompting for a description. PCBoard is able to determine if a ZIP, ARJ, LZH, PAK, or ARC file has a FILEID.DIZ file. If it does, the description file will be used to describe the file. If PCBoard is unable to find a description in the file, it will ask for a description of the file.

All files that are successfully transferred will be tested via PCBTEST.BAT if you have enabled the testing of uploads on your system.

Testing Uploaded Files

If you have configured your system to test all uploaded files, all successfully uploaded files will be tested (one at a time) using PCBTEST.BAT. Even if carrier is lost during the transfer, PCBoard will test all files that were successfully transferred. For more information about testing files using PCBTEST.BAT, see the Batch Files chapter of this manual.

Disabling Uploads

There are two methods you can use to disable uploads on your system. You can set the security level required to execute the U command in PCBSetup | Security Levels | User Commands very high so no one can upload. This would effectively disable uploads across the entire system.

If you are looking to disable uploads on a conference by conference basis, you may do that as well. To disable uploads for a particular conference, clear out the field which contains the location of where uploads will be stored. The field you need to clear depends on how you answered the Make All Uploads Private question. If you answered with a Y, clear out the location of private uploads. The following is a sample display:

           Sort   Name/Loc Upload DIR File       Location of Uploads

Public Upld: 0 : C:\PCB\MAIN\UPLOAD : C:\PCB\MAIN\UPLOAD

Private Upld: 0   : C:\PCB\MAIN\PRIVATE           : 

If you answered with an N instead (making all uploads in the conference public), clear out the Location of Uploads for the public upload directory instead.

Determining Duplicates

PCBoard uses a semi-intelligent method to determine if the file that is about to be uploaded is a duplicate of a file already on the system. A list of the filename extensions used by the most popular file compression programs is stored in memory. If it appears that the file is simply compressed with a different program, the file will be rejected as a duplicate.

For example, if you have a file called SPECIAL.ARJ on your system and an attempt is made to upload SPECIAL.ZIP, the file will be rejected as a duplicate. However, a file such as SPECIAL.TXT could be uploaded, because the TXT extension is not used by any compression programs. Therefore, this file most likely has contents that are different from SPECIAL.ARJ.

NOTE: The file extensions that are recognized as being used by compression programs are: ZIP, ARJ, LZH, LHA, ARC, PAK, ZOO, DWC, and EXE.
PCBoard checks the filename being uploaded against entries in DLPATH.LST to determine what files exist on the system. If the file already exists, a message stating that the upload is a duplicate of a file already on the system is displayed. If you have a security level equal to or greater than the value specified by the Level Needed to Overwrite Files on Uploads (PCBSetup | Security Levels | Sysop Commands), you are given the option to remove the file from disk or to continue with the upload.

You may also want to use what is called an ALLPATH.LST (All-Files DLPATH.LST
in PCBSetup | File Locations | Configuration Files). In this file you can list all of the paths you want PCBoard to check when uploading a file. This way you could include download paths from multiple conferences so users do not upload files that may be located in another conference. Since the ALLPATH.LST file is never checked for downloads, you do not compromise the security of your system. If you leave this field blank, PCBoard resorts to using only the DLPATH.LST method for duplicate checking.

Downloading Files

When you download files, you are transferring a file which exists on the bulletin board to your machine.

How to Download Files

In order to download a file, you must enter the filename(s) you want to download. To help find the filenames you want to download, use the L, N, Z, and F user commands. All of these commands will list files. To actually download the file(s), use the D command to download a single file or the DB command to download more than one file. If you have answered Y to the Promote to Batch Transfers question, the D command will behave like the DB command.

You will see the following prompt:

(1) Enter the filename to Download (Enter)=none?

At this prompt enter the filename you wish to download. You may stack multiple filenames at this prompt by separating each filename by either a space or a semi-colon. For example, enter BLADAR10.ZIP to download a file called BLADAR10.ZIP.

If the file is found on disk, you will be shown the filename, how many bytes are in the file, and an estimate of how long it will take to transfer at your current speed. You will then be asked for another filename. If you are finished entering the files you want to download, simply press ENTER.

After the filenames have been entered, you will be ready to begin the transfer. As with uploads, PCBoard treats remote and local transfers differently. The following describes each method:

Remote

You need to transfer a file using your communications program. With most communications program you can do this by pressing PgDn. You are usually prompted for the protocol you wish to use for the transfer. Make sure you select the same one as you did on the bulletin board system. Once you select the protocol, you are asked for the location where you wish to place the files you are about to download. Enter any valid subdirectory or filename in this box as necessary for your communications program. At this point you will see the files being transferred.

NOTE: Some communications programs support what is called auto-downloading. This is where the transfer automatically begins as soon as the communications program recognizes the protocol. This is most common with protocols like Zmodem.

Local

Local downloads are a little different because PCBoard is in control. To perform a local download, you need to make sure you have selected an internal protocol to PCBoard. At the point where you would usually press d from remote to begin the transfer you will see the following prompt at the top of your screen:

Local Download Path? (                                   )

In this field, enter the drive and subdirectory where you want to store the file(s) you are about to download. For example, if you want the files to be stored in D:\TEMP\,
enter D:\TEMP at this prompt.

If your file transfer is aborted, it may mean you took too long to start it.
Internal protocols allow you about 90 seconds before they will abort. Local downloads will abort if you do not type anything in the box within 30 seconds.

If your download is aborted, PCBoard will remember the filenames you typed in and they will remain as flagged files. Therefore, if you attempt to do a download again, you will be asked if you wish to download flagged files.

Flagging Files For Download

You can mark or flag files for download while you are viewing the file listings. When you are viewing file listings, you will notice that the More? prompt has a (F)lag option. When you select this option, you will be asked what filename you would like to flag for download. If the filename you enter is found, you will be shown the filename, file size, and approximate minutes to download. You can continue looking at the file listings without having to begin your transfer immediately.

When you are ready to begin your transfer, simply use the D or DB commands.
You will be asked if you wish to download the files that are flagged for download.

Disabling Downloads

Disabling downloads is a very simple process. To disable downloads across the entire system, you would set the security level in PCBSetup | Security Levels | User Commands for the D command very high.

To disable downloads in a particular conference is very easy. Simply make sure that the DLPATH.LST field in the conference configuration is blank. If it is blank, PCBoard will inform the user that downloads are currently disabled. Below is an example from a conference configuration screen:

Directories : C:\PCB\MAIN\DIRMNU           : C:\PCB\MAIN\DIR.LST
Download Paths (listing only)              : 

Making files FREE for download

A FREE file is considered a file which does not count towards the user's bytes or files downloaded. In other words, if the user has 280k of bytes available for the day and a free file is downloaded, 280k of bytes will still be available for downloading.

To make a file free, you need to use the FSEC file which can be edited via PCBSetup | File Locations | Configuration Files. A file is considered FREE if the password required for the download is FREE. A couple of examples will help illustrate the point best. For example, all files in the G:\FORALL\ subdirectory will be considered FREE files. The entry you would make in the FSEC file looks like the following:

        
          Drive \ Path              File Name    Sec     Password
-------------------------------- -------------- ----- --------------
 G:\FORALL\                       *.*            0     FREE

Because almost all bulletin boards store files on the system as compressed files, you may want to make the utility necessary to uncompress the files a FREE download. For example, the decompression utility may be called ARJ300.EXE. If so, you may want to make the following entry in the FSEC file:

        Drive \ Path              File Name    Sec     Password

——————————– ————– —– ————–

                                  ARJ*.EXE       0     FREE

Notice how the Drive/Path field is left blank. This means that anytime a user downloads a file which begins with ARJ and has an extension of EXE it will be a FREE file.

Batch Versus Single File Transfers

As you know, you must use a file transfer protocol to transfer any files over the modem. As it turns out, some protocols can handle sending multiple files in a single transfer while others may be only capable of sending one file at a time.

If a protocol can send more than one file in a single transfer, it is known as a batch protocol. On the other hand, if the protocol is capable of sending only one file at a time, it is sometimes termed a single file protocol.

If you flag or attempt to download more than one file for a single transfer, PCBoard will only allow you to transfer the files using the batch protocols that are available on the system. If your default protocol is set to a single file protocol, you will be prompted for the batch protocol you wish to use for the transfer.

Aborted Transfers

An aborted file is any file which was not fully transferred. The following details some reasons why files may be aborted:

excessive errors

Almost every protocol has some error-checking routines built in to assure the proper transfer of information. If an error in the transmission is detected the data packet will usually be re-sent. Most protocols also have a built in error limit. For example, if 10 successive errors occur, the protocol may decide to abort the transfer.

line noise

No transmission over phone lines is immune from line noise.
From time-to-time you may experience line noise. If you do not have an error-corrected connection, this may cause transmissions errors and if bad enough, could cause the transfer to be aborted. If you do have an error-corrected connection, it is quite unlikely that the transfer will be aborted (because modems are doing the error correcting automatically).
However, if the line noise is extremely bad, your modem may decide to automatically drop carrier.

dropped bytes

With the influx of high-speed modems into the market it has become more important than ever to have serial port hardware that is adequate enough to handle the speed of the modem. If you plan on using a modem which uses a port speed of 19200 or higher, you should plan on either using an intelligent serial card supported by the /M version of PCBoard or at the very least make sure all of your serial ports have NS16550AFN UARTs installed.

flow control

It is very important that you use the right flow control.
There are two types of flow control–software and hardware. The former is commonly referred to as XON/XOFF flow control and the latter is referred to as CTS/RTS flow control. It is important that your modem and your software be configured to use CTS/RTS flow control exclusively. Protocols such as Ymodem/G assume that flow control is operating properly. If flow control is not working properly, you can lose an excessive amount of characters, etc.

NOTE: If the connection is set to be disconnected once the file transfer has completed and the file transfer aborts, PCBoard will wait 45 seconds instead of the normal 10 seconds.

sysops_guide/file_transfers.txt · Last modified: 2024/01/18 13:59
CC Attribution 4.0 International Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution 4.0 International