CD Shareware Magazine 1997 January/CD_shareware_1-97.iso/DOS/COMUNICA/OFILE18.ZIP/OFILE.DOC

Text File | 1996-10-17 | 12.2 KB | 247 lines

             OFILE.PPE  -  Copyright Slob-Trot Software Oy Ab


               On-Line File manager for PCBoard BBS 15.22 -->

This PPE eliminates the dangers of having to let your Fileoperator into your
DOS (you don't need PCBFILER anymore either), and the danger of your board
hanging while beeing out in the DOS! You can also forget about DOORWAY, since
O-File does not need it.

-  What can you do with O-file?

O-file does the same thing as PCBFILER.EXE. You can Move, Delete and Copy
files from/to any conference and DIR you want while on-line in the BBS! Easy
Flagging/Unflagging, extended keyboard commands (PGUP[S]/PGDOWN[X]/KeyUP[A]/
KeyDOWN[Z]../Description editing.. and so on), and a logfile with information
of who has used the application, so that the SysOp can keep track of when the
File operator has taken care of file handling.

- Installing

  To install Ofile, you must add O-file to your CMD.LST file.
  This can be done with the INSTALL.EXE that is included with O-File.

  The Install Utility Installs O-File to be used by anyone who's security
  level is 10 or higher. If this is not OK, you will have to modify the level
  yourself. The command for running O-File after installing is "OFI".

  Make sure the DISP\ SubDirectory has the SELDISP file in it.

- Usage

When you run it from your board, your conferences will be displayed with a
lightbar on the main board.. Move the lightbar to the desired conference and
press return (or arrow-right) (or forget the lightbar and simply type the
number of the conference, If you have less then 10 conferences you will not
have to press return after the conference number.).

        Functions in Conference list: (V)iew hard-drives
                                      (H)elp screen

Selecting filearea (DIR.LST), Now you should select a directory in the
selected conference. And if you are in the wrong conference you can go back
to the list of conferences with the ESC-key or arrow-left

        Functions in Filearea list:   (V)iew hard-drives
                                      (H)elp screen

You are now in a filelist, with the first line of each file
description representing the file. You can use the following keys for moving
the lightbar: UP, A, DOWN, Z, PGUP, S, PGDOWN, X, HOME, END

Functions in Filelist (DIR.LST) list:

SPACE / RETURN = Flag a file for beeing processed. When you flag the file the
                 Fileline will get lightblue, and the lightbar is moved to
                 the next fileline. The filename you flagged will appear in
                 the upper right corner of the screen, and the "Amount of
                 flagged files" counter in the lower right corner is
                 increased to the current amount of flagged files. (the second
                 value is the amount of total files in the dirlist.)

H - (Help)     = Shows a helpscreen with quick help information about the
                 functions available.

V - (View)     = View the full File description for the file the lightbar
                 stands on. When pressed the filelines will be overwritten
                 with the Description for the file. You can press any key
                 to go back to the filelist.

E - (Edit)     = Edit the file description for the file the lightbar stands
                 on. After edited you can select between saving or restoring
                 old description. Description is not saved into physical file.

T - (Type)     = Executes the Batchfile you have specified in PCBSETUP for
                 Viewing files in your BBS (usually PCBVIEW.BAT). This way
                 you can view the contents of the files you have.

F - (Filter)   = Filter out only those descriptions matching a search
                 criteria. After using this function only the descriptions
                 that matched the search criteria will be listed. The criteria
                 is not case sensitive. The function is similar to the "Z"
                 function in PCBFILER.EXE.

R - (Read)     = After using the filter function you might want to read all
                 files into the list again, without having to lose the flagged
                 files. By pressing "R" and selecting (YES) at the question
                 all files will be read into the list again.

C - (Copy)     = Will ask if you are sure that you want to copy the files, and
                 if you select yes, you will be prompted for the destination
                 conference, and after that for the destination directory.
                 when you have selected the destination directory the files
                 and descriptions will be copied into the destination
                 directoty. (You will then have duplicate files on your
                 system, unless you delete the original later!)

M - (Move)     = Will ask if you are sure that you want to move the files to
                 another directory, and if you select yes you will be
                 prompted for a destination conference, and for a destination
                 directory in the conference. When you have selected the
                 destination the files & descriptions will be moved to the
                 destination.

D - (Delete)   = DELETES the flagged files, Use with caution !!!
                 When pressed you will be asked if you want to delete the
                 flagged files, and if you select yes you will be prompted
                 again (ARE YOU SURE blablabla.. ) and if you select yes the
                 second time the files & descriptions will be deleted from
                 your hard-drive and the DIR file.

N - (Nuke)     = A nice concept developed by someone else & Now included in
                 O-File. Nuking gives you some options to select from:
                 1) Leave a zerobyte file on hd or not
                 2) Delete description from list or add a NUKED ansi to desc.
                 3) Send uploader a message that he has been nuked (yes/no)
                    The message is located in: DISP\NUKE.MES
                 4) Remove the uploaders credits. If You select yes, then
                    the follwing question will be asked:
                 5) The multiplier to be used when nuking (If you enter
                    "1" then the original filesize will be used if you enter
                    "2" then the nukeamount is 2*FileSize etc..
                    "3" then the nukeamount is 3*FileSize etc..

                 The Nukeamount will be included in the ansi added to the
                 description. (at the position of the @NUKESIZE@ code in
                 NUKEANSI.PCB).

                 Nuke searches the DOWNLOAD.TXT specified in PCBOARD.DAT for
                 the user that uploaded the file. DOWNLOAD.TXT is searched
                 backwards, thus hopefully finding the uploader faster and
                 finding the last one that uploaded the file (if a file has
                 been uploaded before & deleted etc..). This feature was
                 added on request.

ESC - (Ready)  = If no files are flagged when pressing ESC(APE) you will be
                 returned to the list of directories. If you have flagged
                 files a screen with options is displayed, and the options
                 are basically the same as the functions mentioned above.
                 (COPY, MOVE, DELETE, BACK, View flagged files and Quit),
                 selecting any of the options does what the option stands
                 for. You can ususally in O-File return to a previous level
                 with the ESC-Key (exept in the Screen of options where you
                 press (B)ack for the filelist.).


- The configuration file (OFILE.CFG)

There are several options in the configuration file (line1 - line9):

You can edit theese manually or with the OCONFIG.EXE that is supplied with
O-File. We recommend using OCONFIG since it is especially made for this task.

LINE #1 : Strip chars under 31 when displaying dirlists and Descriptions.
          Can be YES or NO. The stripping of the descriptions will be a
          little bit slower if set to YES.

LINE #2 : Write note in LOGFILE.LOG for every time files are processed.
          Can be YES or NO. If set to NO nothing will be written into the
          logfile when processing files.

LINE #3 : Check for users conference flags. If this is set to YES the user of
          O-File can only access conferences where he has the "R"egistered
          flag set. You can prevent the fileoperator from knowing about
          possible private conferences this way.

LINE #4 : Display only conferences with fileareas in Conf list (YES/NO).
          If this is set to "YES" only those conferences with other fileareas
          then the Upload directories will be included (providing that the
          other settings allows the conference to be included).

LINE #5 : Display conference allthough PRIVATE UL dir is the only dir in the
          conference. If this is set to "YES" conferences with a Private
          upload directory will be included in the list of conference
          (providing that the other settings allows the conference to be
          included).

LINE #6 : Display conference allthough PUBLIC UL dir is the only dir in the
          conference. If this is set to "YES" conferences with a Public
          upload directory will be included in the list of conference
          (providing that the other settings allows the conference to be
          included).

LINE #7 : Write notification in CALLERX (caller log file) each time that
          O-File is started and ended. "YES" =  Write notification
          "NO" = Do not write notification.

LINE #8 : Conference in which to place NUKE messages to users.

LINE #9 : Strip Colorcodes from file descriptions when editing or viewing
          them. WARNING: The Diz editor goes crazy when you edit descriptions
          with @Codes or colorcodes in them. The saved version of the diz
          should anyhow be correct. This feature was added on request.

- The DISP directory

There should be a file called SELSCRN in the DISP Directory. That is the
screen with options if pressing ESC at the filelist with files flagged.


- Other

There are two DOS Executables in the Ofile directory. These are used by
O-File. OFILE.EXE processed the flagged files, and DISKINFO.EXE reads your
hardrives and returns the information to Ofile in the DISKINFO.CAP file. we
are using EXE's for doing these tasks, because of certain restrictions in the
PPL language (and because EXE's are alot faster then PPE's).

One known problem with O-file is that When O-File shells out to dos (to run
ofile.exe) you will loose free memory. This is not a flaw in O-File, it is a
problem with PCBoard's internal shelling routines (15.22). In 15.3 there
seems to be less memory loss when shelling to dos.

Future enhancements might be: Description cloning, re-reading dir.lst by
                              getting the dizzes out of files. flagging &
                              downloading.

- Claims & Licence

Slob-Trot Software Oy Ab is the owner of this application, and gives you
the user the right to evaluate the application for 30 Days. If you would like
to use it further you must register the application with Slob-Trot Software.

OFILE.PPE and all files belonging to the application is Copyrighted Software.
No Distriution or Copying is allowed without the written permission of Slob-
Trot Software Oy Ab. This evaluation copy may be used for evaluating purposes
for 30 days. Modifying of the code or debugging the software is NOT allowed.

Slob-Trot Software is NOT responsible for any damage, harm, economical loss
or anything else that may occur because of OFILE.PPE. You use the software
at your own risk.

Slob-Trot Software Oy Ab reserves the right to change this licence without
notice.

-----------------------------------------------------------------------------
Bugreports & Comments & Questions are welcome at : "[e-mail]"

Slob-Trot Software Oy Ab
Uudenkaupungintie 5 B
00350 HELSINKI
FINLAND

PHONE: [phone] (Business hours 09:00-17:00 Local time(GMT+2))
FAX: [phone]
BBS: [phone]  (8,N,1)