[VAX81B.PSDVMS]AAAREADME.TXT


        R E A D M E . 1 S T 

M. Erik Husby
Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444

This directory contains several programs which have proved very usefull
at our installation.



                TESTFILE

This is a program which called from DCL will determine the status of the
given file.  The results are returned in two DCL symbols. 
TESTFILE.BLI - the source.  complied and linked with the commands: 
        $ bliss testfile
        $ link testfile
Used by defining the symbol 
        $ TESTFILE:==$testfile
TESTFILE.EXE - an executable version.
TESTFILE.HLP - some help and examples of its use.
TESTFILE.LIS - a BLISS which can be edited to produce a macro source 
file.
TESTFILE.OBJ - the object file.


                BHDRIVER & NLSYMB

The blackhole device and null print symbiont are used to dispose of
batch logs and other files on a daily basis.  During the day, batch
logs which do not need to be printed but which may need to be looked
at are queued to the print queue BLACK_HOLE.  Then at midnight,
a command procedure is run which starts a device queue using the
null symbiont which simply deletes all files queued to it. By 
waiting until midnight to delete the log, a user can look at it or 
really print it if needed.  


BHDRIVER.MAR - the source for the black_hole device driver.  Patterned
on the NLDRIVER but with device characteristices to satisfy the
JOB_CONTROLER.  
BUILDBH.COM - command procedure to assemble and link the BHDRIVER.

NLSYMB.MAR - The source for the null symbiont.  Compiled and linked with 
the commands:
        $ macro nlsymb
        $ link nlsymb

To install the Black_hole device, the following commands are used:
                                                      Page 2


        $ run sys$system:sysgen
        LOAD SYS$SYSTEM:BHDRIVER
        CONNECT BH/NOADAPTER/DRIVER=BHDRIVER
        $ !
        $ !     To create some black_holes, we will do a copy to one.
        $ !     This will cause them to multiply.
        $ copy sys$system:bhdriver.exe bh:

To create the BLACK_HOLE print queue, the following command is used:
        $ initialize/queue/noflag/noenable_generic_printing black_hole

To queue a batch log to the BLACK_HOLE, include the following command in
the batch job.
        $ assign black_hole sys$print

MRCLEAN.COM - a command procedure used on a daily basis to drain the 
BLACK_HOLE print queue.


                PARSFILE
PARSFILE is a command procedure which will break a file specification 
into its various parts.

PARSFILE.COM - the command procedure.
PARSFILE.HLP - Help and examples.


                WFLP

WFLP is a progam to read DIGITAL word processing floppies (WPS-78) and 
produce VMS editable files.  This is much faster then using WPIP if you
need copies of several documents on the floppy.

WFLP.BLI - the source. Compiled and assembled with the commands:
        $ bliss wflp
        $ link wflp

WFLP.LIS - A BLISS listing which can be edited to produce a macro source 
file.
WFLP.OBJ - the object file.
WFLP.EXE - A executable version.

To run WFLP the user must have LOG_IO privilege.
To execute WFLP mount the floppy as a foreign disk and then run WFLP.
It will give you a directory of the floppy and then ask what file to 
copy from it

Note: There is one known bug - ruler records are sometimes incorrectly
translated into text.


                LIST

LIST is a compatablity mode program which lists files on VT52, VT100's 
and TEKTRONIX 4010 series scopes.  LIST will list the file a page at a 
                                                      Page 3


time.  Commands may be given to LIST to skip lines, skip to the end or 
begining of the file, and delete the file.  LIST will attempt to put the
scope into the most favorable mode to display the file.  VT100's will be
put into 132 character mode if the file contains lines longer than 80 
characters.  The different character sizes of the TEKTRONIX scopes will 
be used as needed.  LIST will also optionaly display control characters 
using the symbols that EDT does. LIST takes RSX11M wild card 
file specifications (ie no wild characters).  Combinding wild card 
capablity with the file delete command makes cleaning up a directory a 
very easy task.  

CHKCMD.MAC - source file.
LIST.MAC - source file.
LISTIO.MAC - source file.
MAKNAM.MAC - source file.
MRKPNT.MAC - source file.
RSXMSG.MAC - source file.
SCREEN.MAC - source file.
WRTBUF.MAC - source file.
LIST.OLB - object library.
LISTBLD.CMD - taskbuild command procedure.
LIST.CMD - command procedure to assemble and build LIST.
LIST.EXE - VMS executable version.
LIST.HLP - Help and examples.


                VAXNET

This is an enhanced version of the terminal communication package distributed
on a previous DECUS tape.  This version has the capablity of sending all
sorts of files. Files like task images are first encoded into ASCII before
sending.  It is also possible to log the complete terminal session to a 
disk file.  Complete documentation is included.  

SEE ALSO AAAREADME.1ST ON THIS DIRECTORY.