1 DIRECTORY_SCAN
 SCAN is a directory management utility written entirely in the TPU editing
 language.  To run SCAN, simply type SCAN and a directory specification.
 The directory specification can not only be a directory but a wildcard
 list of files as well.  The files found will appear on the screen in an
 editing window.  You can then use the function keys, arrow keys, keypad
 keys, and GOLD sequence keys to perform functions on those files.  Please
 refer to the KEYPAD_DIAGRAM for definitions of the editing keys. 

 SCAN can even be used as a limited user interface.  Errors for attempted
 operations are displayed to the user.  If the operation, such as a RENAME
 for example, succeeds, then a new directory listing is made and displayed.
 Thus you are interupted only where there is an error.

 The editing environment is a mix of All-in-1 "like" GOLD-key sequences
 and some of the EDT keypad sequences.  The directory being SCANned is
 displayed in an editing window.  The "end of buffer" text is the total
 number of files in the directory.  Like EDT, you may perform some commands
 multiple times by hitting the GOLD key, a numeric amount, and a keystroke
 that you want repeated.  The numeric amount is not echoed to the screen.

 Beneath the directory window is a message window where the last three
 warning messages appear.  For some operations, such as COPY, a prompt line
 will be temporarily overlaid on the last line of the screen in the
 message window.
2 AGAIN
 Key: PF3

 This key will search forward for the next occurance of the search text.
 If the search text occurs on the current cursor line, no advance is made.
2 ANOTHER
 Keys: GOLD-A, CTRL/A

 These keys will perform do another listing of the current directory and
 redisplay in the directory window.  No other operation on the files in
 the directory is performed.

 This key is useful if you suspect files are being created or deleted
 in your current directory and a new look at the directory would be useful.
2 BOTTOM
 Keys: GOLD-B, Keypad-7, GOLD-Keypad-4, CTRL/B

 These keys will move the cursor to the bottom of the directory beyond the
 last file.
2 CLEAR
 Keys: GOLD-`, F14

 These keys will clear the messages displayed in the message window beneath
 the directory name bar.
2 COM
 Key: GOLD-@

 This key will execute the current file as a command file in a spawned
 subprocess.  The default directory for the subprocess will be your current
 default directory, not the directory being SCANned.
2 COPY
 Key: GOLD-C

 This key is for copying files.  SCAN will ask for a filename and copy
 the current file to that given name.  If no directory name is given for
 the copy, the file will be created in the current directory displayed
 on the screen.
2 DAYTIME
 Key: GOLD-\

 This key shows the current day and time.
2 DCL
 Keys: DO, GOLD-X

 When this key is struck, SCAN will ask for a DCL command to execute.
 The command is sent to the subprocess attached to the currently SCANned
 directory.  No interaction via the keyboard is available after the
 command is sent.
2 DEAD
 Keys: GOLD-space, other keypad keys with no assignment

 This key is a dead key.  It performs no operation and simply soaks
 up keystrokes.
2 DOWN
 Keys: Down-arrow, RETURN, ENTER, Keypad-0

 Striking this key will advance the cursor to the next file in the
 directory.  If the cursor is beyond the last file in the directory,
 a warning message appears in the message window.
2 EDIT
 Keys: SELECT, Keypad-period, GOLD-E, CTRL/E

 This key is context sensitive on the file type: if it is a .EXE file
 then SCAN will run it in a subprocess; if it is a .DIR file then SCAN
 will set the directory default down into it. Anything else is assumed
 to be a text file and the DCL EDIT command will be used to edit the
 current file.

 It is important to note that the editing journal file will be found
 in the SYS$LOGIN directory.  If SCAN doesn't have write access to that
 directory, editing will not be possible.
2 EMPTY
 Keys: INSERT-HERE, GOLD-!

 Using these keys will create a new, empty file. SCAN will ask for a
 filename to create. The file is created similarly to the DCL command
 $COPY NL: <filename>
2 EXIT
 Keys: GOLD-Z, CTRL/Z, F10

 This key will exit SCAN and make the current default directory -- the
 one currently being scanned -- the process default directory.  If you
 don't wish your default directory to change, use a QUIT command such
 as GOLD-Q.
2 FIND
 Keys: FIND, GOLD-Keypad-PF3

 This key will ask for text to find in the directory window.  The search
 operates on the directory text, not the contents of the files.  If the
 text is completed by hitting the keypad 5 key, a backward search;
 otherwise a forward search is performed.  If no search text is entered,
 the previously entered text is used for the search.

 If the search succeeds, the cursor is always placed at the beginning of
 the filename containing the search text.  If the search fails, the cursor
 is not moved and a warning message appears in the message window.
2 FULL
 Keys: GOLD-F, CTRL/F

 This key will perform a full directory display on the current file.
 SCAN will display a prompt waiting for a keystroke prior to redisplaying
 the directory window.
2 GO
 Keys: GOLD-G, CTRL/G

 This key will create a subprocess and run the current file in it.
2 HIGHDIR
 Key: Left-arrow, GOLD-Up-arrow

 This key will move the current directory up to the previous directory.
2 Hints
 SCAN is familiar in some ways, but also a bit unlike any other utility
 that probably used before.  Here's some hints to help your operation
 of it.
3 DCL
 SCAN has a command GOLD-X for sending commands to the DCL sub-process.
 When you enter a command, remember that the default directory for that
 command will be the directory currently on the screen.  This makes
 commands like PURGE very useful to you.
3 Directories
 SCAN was designed, of course, for scanning directories.  That doesn't
 mean literally directories only.  SCAN will present files for any
 valid wildcard specification that can be given to the DCL DIRECTORY
 command.

 Valid SCAN directory specifications can be:

    DUA1:[DECUS.VAX001]

    .LIS

    FOOBAR

    [-.TEST]*.%%MAN;0

 or whatever you like.  Just remember if DIRECTORY will like it, so
 will SCAN.
3 Prompts
 SCAN will often prompt for a response to a command, such as GOLD-R for
 rename a file.  SCAN will prompt and expect you to enter the new file
 name.  If for some reason you change your mind, just hit the RETURN
 key.  SCAN will recognize that there was no new name entered and not
 do anything.

 On the other hand, if you do want to enter something at a prompt
 remember that the handy line-editing commands are available to you if
 you want to use them.
3 Repeating
 SCAN will allow repeat counts to be entered for many commands.  To
 enter a repeat count, hit the GOLD key, the keyboard number keys for
 the number of times you want, and then the command you want repeated.

 Example: To repeat going up directories 14 times, enter

   <GOLD>14<GOLD><UP-ARROW>

 The numeric part won't echo to the screen.  So, if you're unsure about
 which numeric keys you've hit or how many times, use a dead-key
 (like GOLD-space) to cancel the repeat count.

 If an error occurs while repeating, SCAN will stop looping.  Also,
 you can't stop the repeating once it starts -- except by that ugly
 CTRL/Y -- so watch out.
3 SCAN$BATCH_QUEUE
 You can control the default batch queue for SCAN by defining this
 logical name. Example:

   $ DEFINE SCAN$BATCH_QUEUE SUPER_BATCH
3 SCAN$EDITOR
 You can control the editor used by SCAN by defining this logical
 name equal to the DCL command name. Examples:

   $ DEFINE SCAN$EDITOR EDIT/TPU

 Would invoke EVE.

   $ DEFINE SCAN$EDITOR LSEDIT

 Would use the Language Sensitive Editor as the SCAN editor.
3 SCAN$INIT
 The subprocess controlled by SCAN can be tailored by defining this
 logical to equate to a filename. The text in the file is sent to
 the subprocess prior to SCAN starting.
3 SCAN$INIT_MESSAGE
 Normally all TPU informational and success messages are suppressed
 for the processing of the SCAN$INIT initialization file. If this
 logical is defined to be YES those messages will appear.
3 SCAN$PRINT_QUEUE
 You can control the default print queue for SCAN by defining this
 logical name. Example:

   $ DEFINE SCAN$PRINT_QUEUE FANCY_PRINT
2 HOME
 Keys: GOLD-M, F9

 This key will set the current directory to SYS$LOGIN.
2 Installation
 To use SCAN, add the following command to your LOGIN.COM file.  System
 managers: you might want to add this to the system login for all users.

   $ DS*CAN == "EDIT/TPU/SECTION=SYS$LIBRARY:DIRECTORY_SCAN/NOCOMMAND"

 If you happen to have a conflict with another command, you might wish
 to select something else, such as DI*SCAN for example, to invoke SCAN.

 The GOLD-E edit file command uses the default editor defined for the DCL
 EDIT command.  If you want to use a particular text editor for your
 editing session, you may redefine the DCL EDIT command, or better yet,
 define a logical called SCAN$EDITOR that contains the name of your
 favorite editor, such as EDIT/TPU or LSEDIT.

 SCAN uses an external program to perform some system operations.  This
 program is called SYS$SHARE:SCAN_EXTERNAL.EXE and there should be a system
 logical pointing to it called TPU$CALLUSER.  If you are getting errors
 because SCAN cannot find this shared code, see the system manager so it
 can be installed.

 If you wish to select different default print and/or batch queues, SCAN
 will translate logicals called SCAN$PRINT_QUEUE and SCAN$BATCH_QUEUE.  If
 you change the default queues (GOLD-O) SCAN will define these logicals
 for you for the current process so they can be retained over multiple
 SCAN sessions.
2 KEYPAD_DIAGRAM
 GOLD-A  Redisplay directory      +----+---------+     +----+----+----+----+
 GOLD-B  Bottom of directory      |HELP| Do DCL  |     |GOLD|Next|Srch|Dele|
 GOLD-C  Copy file                +----+---------+     +----+----+----+----+
 GOLD-D  Go to start-up directory |Find|Make|Dele|     |Botm|Next|    |    |
 GOLD-E  Edit/Run/Down in subdir  +----+----+----+     +----+----+----+----+
 GOLD-F  Full directory           |Edit|Prev|Next|     |    |    |Dele|    |
 GOLD-G  Exit and go              +----+----+----+     +----+----+----+----+
 GOLD-J  Type out file to screen       | Up |          |    |    |    |    |
 GOLD-L  Go to previous directory +----+----+----+     +----+----+----+Down|
 GOLD-M  Move to SYS$LOGIN        |Udir|Down|Ddir|     |  Down   |Edit|    |
 GOLD-N  New directory            +----+----+----+     +---------+----+----+
 GOLD-O  Set output defaults      GOLD-\    Show date and time
 GOLD-P  Print file               GOLD-DEL  Clear away messages
 GOLD-Q  Quit SCAN                GOLD-UP   Move up to parent directory
 GOLD-R  Rename file              GOLD-DOWN Move down into subdirectory
 GOLD-S  Submit as batch job      FIND      Search for text
 GOLD-T  Top of directory         INSERT    Make an empty file
 GOLD-V  Show version             REMOVE    Delete file
 GOLD-X  Enter DCL command        SELECT    Edit/Run/Down into subdirectory
 GOLD-Z  Exit and set directory   PREV      Reverse a screen
 GOLD-!  Make an empty file       NEXT      Advance a screen
 GOLD-@  Execute in subprocess    UP        Go to previous file
 GOLD-$  Spawn subprocess         DOWN      Go to next file
2 LAST
 Keys: GOLD-L, CTRL/L

 This key will move back to the previously entered directory specification.
2 NEW
 Keys: GOLD-N, CTRL/N

 This key is used to change the directory specification to SCAN.  If no
 new directory name is entered, the operation is aborted.
2 NEXT
 Keys: NEXT-SCREEN, Keypad-PF2, Keypad-8

 This key will advance sixteen files in the directory window.
2 NO_DEFINITION
 Keys: various

 This key has no definition and thus no significance within SCAN.
2 OPTION
 Key: GOLD-O

 This command is for changing the default output queues.  The items that
 can be set are:

    o  Default print queue for GOLD-P

    o  Default batch queue for GOLD-S

 When SCAN is started, the print queue is defaulted to SYS$PRINT, the
 batch queue to SYS$BATCH.
2 ORIGINAL
 Keys: GOLD-D, CTRL/D

 This key moves to the default directory at the time SCAN was started.
2 PREV
 Key: PREVIOUS-SCREEN

 This key will retreat sixteen files in the directory window.
2 PRINT
 Keys: GOLD-P, CTRL/P

 This key will print the current file to either the queue selected with
 the GOLD-O command (the default) or a queue you select.
2 QUIT
 Keys: F8, GOLD-K, GOLD-Q

 This key will exit from SCAN.  The default directory will not be changed
 from where it was when SCAN was started.  If you DO wish to have the
 default directory become the one being scanned, use an EXIT command such
 as GOLD-Z.
2 REFRESH
 Keys: GOLD-W, CTRL/R, CTRL/W

 This key will repaint the terminal screen.
2 REMOVE
 Keys: REMOVE, Keypad-6, Keypad-PF4

 This key will delete the current file.
2 RENAME
 Key: GOLD-R

 This key will let you change the name of a file.  SCAN will prompt for the
 new name and change the current file to that name.
2 SPAWN
 Key: GOLD-$

 This key will create a DCL subprocess.  When ready to return to SCAN, log
 out of the subprocess with the LOGOUT command.
2 SUBDIR
 Keys: Right-arrow, GOLD-Down-arrow, GOLD-Keypad-0, GOLD-Return, GOLD-Enter

 This key will move the directory down into a subdirectory file.  An error
 is returned if the current file is not a directory file.
2 SUBMIT
 Key: GOLD-S

 This key will submit the current file to the batch queue selected with
 the GOLD-O command (default) or a queue you select, using the /NOPRINT
 option.
2 TOP
 Keys: GOLD-T, GOLD-Keypad-5

 This key will move the cursor to the top of the directory window.
2 TPU
 Key: GOLD-[, GOLD-Keypad-7

 This key will allow a TPU command to be entered and executed.  This is for
 the die-hard TPU hackers and other wierdos.
2 TYPE
 Keys: GOLD-SELECT, GOLD-Keypad-period, GOLD-J

 This key will use the DCL TYPE/PAGE command to list the current file to
 the screen.  To finish the TYPE early, hit CTRL/Z or the F10 key.
2 UP
 Keys: Up-arrow, CTRL/H, F12

 This key will move the cursor up to the previous file.
2 VERS
 Keys: GOLD-V, CTRL/V

 This key will display the current program version and author:

    David Spencer
    Foundation Health Corporation
    2600 V Street
    Sacramento, CA  95818
    (916) 732-4300
