
                                                                        o o
                                                                      ____oo_
                               F I L E L i s t               1991    /||    |\
                                 Version 2.0                  BNV     ||    |
                             for Dos, Unix & Vms            MARMITA   `.___.'


███████▓▓▓▓▓▓▓▒▒▒▒▒▒▒░░░░░░░   T Z A P A W A R E   ░░░░░░░▒▒▒▒▒▒▒▓▓▓▓▓▓▓███████


                 Author.........Bill N. Vlachoudis
                 Address........Eirinis 4
                                TK555 35 Pilea
                                Thessaloniki Greece
                 Computer addr..cdaz0201@Grtheun1.EARN
                                vlachoudis::olymp.grtheun.our.edu [192.104.147.1]
                 Telephone......(31) 322-805
                 Date...........Nov-1991



This program is NOT a copyrighted software. However, all the files may be
copied and shared with others, so long as no charge is made, and it is
unmodified copied in its entirety.





What is FILEL?
==============

FILEList is a usefull utility found on IBM VM/CMS systems, it is basically
a shell, but not so high level as all the other shells, so its closer to
the opperating system. When FILEL is invoked it displays a list of the files
like as DIR does, but in a full screen editing environment where you can
issue DOS commands (or from the host operating system) against the files
directly from the displayed list.



Install and Run filel
=====================
There is no any kind of installation for FILEL. Just copy FILEL.EXE,
PROFILE.FLL and FILEL.HLP to a directory you have with various tools.
To run filel, simply type FILEL in the command line, or FILEL <pattern>
where the pattern is used if you want display some specific files. For
information about the pattern see below and also see the CD command (below).



Pattern
=======
Filel V2.0 has now smart pattern matching for the files. It uses the
same wild characters as dor does and some more
    *        for 'all'
    ?        for one character  (see DOS)
    + or &   for 'and'
    ^ or !   for 'except'

ie.   *.com + *.exe         Display all .COM and all .EXE files
      *.com + *.exe ^as*n.* Display all .COM and all .EXE files
                            except all those that begin with "as" and
                            end in "n"



Issuing Commands From the List
==============================

On its full screen display, you can issue commands for a file directly
from the line on which a file is displayed.  You do this by moving the
cursor to the line that describes the file, typing the command in
the space provided to the left of the file name, and then pressing
the ENTER key to execute the command.

When you press the ENTER key, all commands typed on one screen are
executed, and the screen is restored to its previous state.
However, the list is updated to reflect the current status of the
files.

Symbols can be used to represent operands in the command to be
executed.



The following symbols can be used:
==================================

    /    if the slash "/ " is followed with a space then it is
         substituted to the complete fileid
                 [drive]:[path\]filename.ext

 If "slashoption" is ON (see below) then after slash "/" you can
 enter one or more of the following special symbols.
 If "slashoption" is OFF, slash "/" if it is followed with a blank
 character " " will be interpreted as the complete name
 (drive:\directory\name.ext), otherwise it will not affect the
 line entered. ie "COPY /b / + HAHA.TXT BINGO.TXT" will be translated
 as "COPY /b NAME.EXT + HAHA.TXT BINGO.TXT"

    /n   means the file name displayed on the line. (substituted)

    /t   or
    /e   means the file extension displayed on the line. ie ".COM"

    /d   means the directory path name for the file.
         With an ending backslash.  ie "PASCAL\PROGS\"

    /any any other character "x" will cause the same character
         to be displayed on the line. Usefull when you want
         to pass an option to the command.
         ie.  COPY //b / +assign.com outfile.*
             is interpreted as
              "COPY /b c:\dos\filname.ext +assign.com outfile.*"

    Any combinations of the above symbols can be used.  For example:

    /ne    means: file name followed by file extension.

    /dne   means: file path, name, and extension type,
           and it is equivalent to "/ " alone.

    /en    means: file extension followed by file name.

    /nne   means file name followed by file name and file extension.

    /      a simple slash in front of a file will cause the file
           to be executed. Usefull to run programs


Special Symbols Used Alone:
===========================

    The following special symbols can be typed alone on the lines of
    the FILELIST display.  They have the following meanings:

    =    means execute the previous command for this file.  Commands
         are executed starting at the top of the screen.  For example,
         suppose you enter the ERASE command on the top line.  You
         can then type an equal sign on any other line(s).  Those
         files preceded by equal signs are erased, by pressing the
         RETURN key.

    ?    means display the last command executed.  The command is
         displayed on the line in which the ? is entered.



Full Screen Editing:
====================

A sample of FILEList screen


 Path = C:\DOS\*.*           *Header*                FILEL20 (c) BNV 1991
 Cmd           Name      Ext      Size     Time        Date
               ..          < DIR >       12:32:56   1-Jan-1990
  *Cmd Area*   APPEND    EXE      5825   12:32:56   1-Jan-1990
               ASSIGN    COM      1561   12:32:56   1-Jan-1990
               ATTRIB                      :32:56   1-Jan-1990
               BACKUP     * File area *    :32:56   1-Jan-1990
               CGA                         :32:56   1-Jan-1990
  _ *Cursor*   CHKDSK    COM      9850   12:32:56   1-Jan-1990
               COMP      COM      4214   12:32:56   1-Jan-1990



  F1          F2 Refresh  F3 ....etc...     *Reserved lines*
  F5 ...etc...
  ====>   *CmdLine*
  Overstrike      Line = 1  *Status* iles = 8    Total Size = 32467




When FILEL is invoked, it searches for a  file PROFILE.FLL  in the current
directory and in the directory from where the FILEL.EXE was found. Profile
can have commands like those that are entered in the cmdline.



Commands that can be entered from cmdline are:
==============================================

* blabla         Anything that starts with * is ignored as a comment
=                Executes the last command
CMS  cmd         Executes a host command
DCL  cmd              -//-
DOS  cmd              -//-
HOST cmd              -//-
VMS  cmd              -//-

BOTTOM           Goes to the bottom of the file
BOT                   -//-
CD               Change directory, and searching pattern  (see below)
COLOR            Changes screen colors (see below)
DEF              Defines a key (see below)
INT2E ON|OFF     (++For DOS only++) Interrupt 2E the back door of COMMAND.COM.
                 If you specify "INT2E ON", filelist will execute very fast
                 the commands! (Default value if OFF)
                 *Warning! It is possible that FILEL wont work well with
                 INT2E set on, since INT 2E is an undocument function of
                 COMMAND.COM
KEYBOARD101 ON|OFF   (++For DOS only++) if it set to ON then F11 and F12
                 keys will be recognized. (Default is OFF)
GLOBAL ON|OFF    If global is ON, FILEL will search for commands in the
                 entire list of files. If global is OFF then searching
                 will take place only in the currect screen (DEFAULT=OFF)
QUIT             Quit from filel
QUERY [key]      Query for key, (wildchars can be used ie: *F*)
REFRESH          Updates the list with the new files in the directory
RESERVED1 str    Displays the 'str' to the reserved line 1.
RESERVED2 str          -//-
REVERSE          Reverse (up side down) the list of files (can be used
                 with sorting to reverse the order of files)
SLASHOPTION ON|OFF  Slash option controls whether the characters after
                 slash "/" that you've typed on a file, will be
                 handled as special characters (see above).
                 For example if you type on the file HAHA.BLA the command
                        TYPE /N.*
                 with slashoption ON it will be interpreted as "TYPE HAHA.*"
                 with slashoption OFF it will be intrpreted as
                 "TYPE /N.* HAHA.BLA"
                 Default value is ON. Since that special characters are
                 not used very often it is good idea to set it to OFF.
SNAME            Sorts the files by the name.
STYPE            Sorts the files by the file type
SEXT                  -//-
SSIZE            Sorts the files by the size
SDATE            Sorts the files by the date/time
STIME                 -//-
TOP              Goes to the top of the list
TRANSLATE ON|OFF If translate is ON,files will be displayed in lower case
                 and directories in uppercase. (DEFAULT=OFF)
                 (Has no effect in UNIX)
:nnn             Goes to the line 'nnn'
/[pattern]       Searches for the pattern from current line till end of list
[+/-]nnn         Moves UP/DOWN nnn lines
cmd              Anything that is not recognized as a command from the FILEL
                 is passed to the host system.



Change Directory:
==================

(* For DOS users *)

   CD {{drive:}|newdir\}{pattern}

   CD command in cmdline changes the drive, directory and pattern.
   To change the pattern just enter "CD newpattern"
   ie. CD *.EXE    to display all the .EXE files in the current directory
   To change the working directory enter "CD newdir\"
   note that a backslash "\" must be at the end of the new directory
   ie. CD ..\      or    CD   A:\   or   CD C:
   Or you can combine the above two together
   ie. CD \LANGUAGE\PROGS\FILELIST\*.?


(* For VAX/VMS users *)

   CD  {logicalname or disk:}{[directory]}{pattern}{;version}

   CD for VAX/VMS follows the syntax of the SET DEFAULT command, except
   that pattern can be added after the directory.
   ie.
           CD STA1:[CACZ.VLACHOUDIS.FILELIST]*.C
   will display all versions of the C programs in the STA1 subdirectory
           CD STA1:[CACZ.VLACHOUDIS.FILELIST]*.C;
   only the latest version of each .C file.
           CD [-]
   will go up one directory
           CD SYS$EXAMPLES:
   will go to the direcotry specified by the logical name SYS$EXAMPLES



Colors
======

   COLOR  area color

     where 'area' can be one of the following:
       ARROW          arrow '====>' in the cmdline
       CMDLINE        cmdline color
       CURSORMODE     Cursors mode Insert/Overwrite msg at status line
       FILEAREA       The area with the list of files
       HEADER         Header
       RESERVED       The reserved lines
       STATUS         The status line at the bottom of the screen
       WORKING        The blinking working msg


 (* For DOS users *)

     and 'color' can be one of the following:
       BLACK          DARKGRAY
       BLUE           LIGHTBLUE
       GREEN          LIGHTGREEN
       CYAN           LIGHTCYAN
       RED            LIGHTRED
       MAGENTA        LIGHTMAGENTA
       BROWN          YELLOW
       LIGHTGRAY      WHITE

    Note: The background color can not be changed


  (* For VAX/VMS users *)

    since colors aren't exist on our VT420 terminals, the COLOR command in
    filelist can only change the attributes of the specified field

          NORMAL                    UNDERLINE
          BOLD                      BOLD_UNDERLINE
          BLINK                     BLINK_UNDERLINE
          BOLD_BLINK                BOLD_BLINK_UNDERLINE
          REVERSE                   REVERSE_UNDERLINE
          BOLD_REVERSE              BOLD_REVERSE_UNDERLINE
          BLINK_REVERSE             BLINK_REVERSE_UNDERLINE
          BOLD_BLINK_REVERSE        BOLD_BLINK_REVERSE_UNDERLINE



Key definitions:
================

DEF key command

    Valid keys are:
    ===============
       BKSP             HOME
       ENTER            END
       ESCAPE           PGUP
       TAB              PGDN
       F1 - F12         LEFT
       INSERT           UP
       DEL              RIGHT
       S_TAB            DOWN

       `0123456789-=[];'./\

       Use the prefix
          S_    for Shift
          C_    for Control         (can take and all keys from A to Z
          A_    for Alt key         (can take and all keys from A to Z

    Or even the code of the key 'nnn'. For extended codes add 256

    (* For VAX users *)
    prefixes S_ and A_ are not recognized, and there are also the
    keys
       HELP, DO,  FIND,  INSERT,  REMOVE,  SELECT,  PREV, NEXT
       F1  - F20
       PF1 - PF4
       E0  - E9  from the numeric keypad


    Command can be:
    ===============

        CURSORUP          Move cursor UP
        CURSORDOWN        Move cursor DOWN
        CURSORRIGHT       Move cursor RIGHT
        CURSORLEFT        Move cursor LEFT
        END               Moves cursor to the last char in line
        HOME              Move cursor to the first column in line
        TAB               Move cursor to next tab
        BACKTAB           Move cursor to previous tab

        CURSORHOME        Move cursor to HOME and cmdline
        CURSORFLIP        Flip from cmdline and last possition in file
        CURSORTOGGLE      Insert/Overwrite

        BACKSPACE         Backspace on character
        CLREOL            Clear from cursor position to end of line
        DELETE            Delete one character
        RESETLINE         Resets the line where cursor is on
        RETRIEVE          Retrieve last executed commands

        BOTTOM            Go to the bottom of the list
        TOP               Go to the top of the list
        ONELINEUP         Scroll one line up
        ONELINEDOWN       Scroll one line down
        PAGEDOWN          Go one page down
        PAGEUP            Go one page up

        QUIT              Leave the filelist
        EXECUTE           Executes the commands that are entered in th
        CMND       cmd    Executes a command as if it was entered from
        EXEC     hostcmd  Executes a host command on the file the curs
                          pointing  ie DEF S_F10 EXEC print / (UP
        EXEC/FILEL  -//-  Same as above, except that if the specified
                          is a directory, filelist invokes that direct
                          like CD dirname\
                          ie. DEF F10 EXEC/FILEL XEDIT

        REFRESH           Refresh the list
        REVERSE           Reverse the list
        SNAME             Sort by name
        SNAMEEXT          Sort by name/extension (flips its function)
        SEXT              Sort by extension
        STYPE             -//-
        SSIZE             Sort by size
        SDATE             Sort by date
        STIME             -//-

        NULL              Restores the function of the key



Any comments or ideas about the program,
WILL BE REJECTED!!   :-)




DISCLAIMER

 THE SOFTWARE  REFERENCED MAY BE  FREELY DISTRIBUTED  BY NON-COMMERCIAL
 SYSTEMS AND NON-PROFIT ORGANIZATIONS, AS LONG AS THE DISTRIBUTION FILE
 IS NOT ALTERED, AND NO MORE  THAN A REASONABLE COST-OF-DUPLICATION FEE
 IS CHARGED.

 THE SOFTWARE  REFERENCED  IS MADE  AVAILABLE AS - IS. THE AUTHOR MAKES
 NO WARRANTY ABOUT THE  SOFTWARE AND ITS CONFORMITY TO ANY APPLICATION.
 THE AUTHOR IS NOT RESPONSIBLE FOR ANY DAMAGE, LOSS OF DATA, OF LOSS OF
 MONEY CAUSED BY THIS PROGRAM.
