Help is available for the following topics:
1022 4UP ADUMP AJ APLBAS ARP ASSIGN ATTACH BACKUP BRACK
CALCOM CALEND CANCEL CDCEOF CHANGE COBOL COMMAN COMPIL CONTRO COSTS
COUNT CPUNCH CREATE DATESW DDT DEBUG DECLAR DELETE DEMOS DETACH
DIRECT DISK EBCDIC ECHO EMPIRE FAILSA FAL FILES FORDDT FORFLO
FORTH FORTRA FROM10 GCS GENCOM GLIM GRIPE GT40 HELP HLPALL
HLPSQZ HOLIDA HPPLOT IMSL INDEX JOB KDPLDR KERMIT KILL KJOB
LABDMC LASER LIBRAR LINED LINK LOGIN LSTMAI MAKVIR MASTER MCROSS
MONITO MOUNT MS MTA MTTOPT MUPPET NAME NCP NETWOR NFT
NOTICE NYPLAN OLDNOT OMNIGR OPR PACMAN PAL10 PASSWO PASWRD PHONES
PLOT POUT PUB QUEUE REATTA REDUCE RENAME RENBR RERUN RSXFMT
RSXRED SAAM SAVE SDPL SED SEDONL SEDOTH SEE SEND SEWER
SIXPRT SMALL SORT SPACIN SPIKE STAFF STATIS STREK SUPCAL SUPSUB
SYSDPY SYSTEM TAPCOP TECMAC TEK TEKVEW TERMIN TIME TIP TO10
TOPS TREK TREND TYPFIL USERS USNMRG VAXTAP VERIFY WHO XVFU
DIRECT - Help file for DIRECT %6(441) Page 1
DIRECT is a program to provide a directory listing of files from a
file-structured device such as disk or DECtapes or from magtapes
written by FAILSAFE, FRS, BACKUP, or DUMPER (TOPS-20). The command
format is "listing-file=file1, file2, . . . " where listing-file is
the file specification of where the directory listing is to go
(default is to the job's controlling terminal) and file1, file2, etc.
are the files to be listed (default device is DSK:, default file name
and type (extension) are *, default directory is controlling job's
DIRECT switches (to control output listing format) are:
/ACCESS:n Do an accessing LOOKUP (one which will cause the
file's access date to be updated) of any file whose
length is "n" blocks or less. Normally DIRECT will
not cause the file's access date to be changed.
/[NO]ACCOUNT Do [not] list th fle's account string. Default is
/ALLOCATED When listing the file's length use the file's true
physically allocated length rather than the written
data length. Default is /WRITTEN.
/[NO]AUTHOR Do [not] list the file's author if the author is
different from the owner. Default is /NOAUTHOR.
/BLOCKS When listing the file's length express the length in
units of disk blocks (128 words per disk block) rather
than words. Default is /BLOCKS.
/[NO]CHECKSUM Do [not] compute and list the file's checksum.
Default is /NOCHECKSUM.
/[NO]COMPARE Suppress directory listing headers and titles as well
as error messages so that the directory listing may be
compared (using, for example, FILCOM) to another
directory listing. Default is /NOCOMPARE.
/[NO]DETAIL Do [not] provide a detailed listing of allknown file
attributes (such as block number of the RIB, etc.).
Default is /NODETAIL.
/[NO]DIRECT Do [not] provide an ASCII directory listing. Default
/[NO]EOTS When reading a magtape, do [not] stop reading the tape
at logical end of tape (two consecutive end of file
marks). Default is /EOTS.
/[NO]ERLOG Do [not] enable automatic device error logging.
Default is /ERLOG.
/FAST Provide a fast directory listing consisting of only
file name and type (extension) information. This
avoids having to LOOKUP each file for such information
as the file's length, creation date/time, etc.
Certain switches such as /CHECKSUM will force a LOOKUP
anyway. Default is /NORMAL.
/[NO]FDTA When providing a DECtape directory listing, do [not]
force the monitor to re-read the DECtape directory
block. Default is /NOFDTA.
/FILES:n When reading a magtape stop after "n" physical files
(end of file marks) have been read. Normally DIRECT
reads until end of tape (see /EOTS) is encountered.
/[NO]FIND Do [not] use the "find files" rather than the actual
DIRECT - Help file for DIRECT %6(441) Page 2
physical device(s) specified in order to provide the
directory listing. Default is /NOFIND.
/[NO]FLSDIR Do [not] print the file's device and directory on the
right hand side of the first line of the directory
listing for each different directory listed. Default
is /FLSDIR unless either /HDSDIR or /WIDTH is
/[NO]FNDBLD Do [not] generate "find files" containing the
directory information. If /FDBLD is specified the
"find files" are generated from the output file
specification with extensions .FDF and .FPF. Defaults
are device DSK:, filename(s) FNDDAT, directory [-].
The "find files" may be later read by the /FIND
switch. Default is /NOFNDBLD.
/FNDDAT:file When /FIND is specified, use "file" as the file
specification of the "find files" to read for the
directory information. The default "find files" are
SYS:FNDDAT.FDF and SYS:FNDDAT.FPF if /FNDDAT is not
specified, otherwise default device is DSK:, filname
is FNDDAT, file types (extensions) are .FDF and .FPF,
directory is [-].
/[NO]HDSDIR Do [not] print the file's device and directory
information as a separate "header" line immediately
preceeding the directory listing for each directory
listed. Default is /NOHDSDIR unless both /WIDTH is
specified and /FLSDIR is not specified.
/[NO]INDIRECT Do [not] format the directory listing output in such a
manner that it can be used directly as command input
to another program. Each file is listed as
"dev:file.type[directory]" on a separate line; error
messages are suppressed; summaries are suppressed.
Default is /NORMAL.
/LIST Use LPT: as the default output device.
/[NO]MARKS When reading a magtape, do [not] annotate each end of
file mark encountered. Default is /NOMARKS.
/[NO]MVOLUME When reading BACKUP or DUMPER magtapes, do [not] ask
the user to mount successive reels when end of tape is
encountered in the middle of a save set. Default is
/NORMAL Print just the "normal" directory listing which
consists of the file name, file type, length,
protection, creation date, version (if non-zero), and
device and directory. /NORMAL is the default listing
/[NO]PRDEVICE Do [not] always print the device for each file listed.
Complete absence of the switch causes the device to be
printed out only when it is different from the
previous file's device; /NOPRDEVICE never prints the
device; /PRDEVICE always prints the device.
/[NO]PRDIRECTORY Do [not] always print the directory for each file
listed. Complete absence of the switch causes the
directory to be printed out only when it is different
from the previous file's directory; /NOPRDIRECTORY
never prints the directory; /PRDIRECTORY always
prints the directory.
DIRECT - Hlp file for DIRECT %6(441) Page 3
/[NO]PRVERSION Do [not] always print the file version for each file
listed. Complete absence of the switch causes the
version to be printed out only if it is non-zero;
/NOPRVERSION never prints the version; /PRVERSION
always prints the version (blank filled if zero).
/[NO]RETRY Do [not] enable automatic error retry when reading a
file. /NORETRY will generate an I/O error message
even for soft read errors. Default is /RETRY.
/[NO]REWIND When reading a magtape, do [not] rewind the tape both
before and after reading it. Default is /REWIND.
/SLOW Prints a more detailed directory listing than /NORMAL
(hence it is slower to type) containing the file name,
file type, length, protection, access date, creation
time and date, I/O mode, version (if non-zero), and
device and directory. Default is /NORMAL.
/[NO]SORT Do [not] format the ASCII directory listing in a
format suitable for reading and sorting. If /SORT is
specified the output listing file will contain no tabs
(only spaces); date information is strictly numeric
in descending precedence; all error messages are
suppressed from the listing file. Default is /NOSORT.
/[NO]SUMMARY Do [not] print the directory listing summary.
Complete absence of the switch prints a summary after
each directory listed; /NOSUMMARY never prints the
summary; /SUMMARY prints only the summary (and
suppresses the regular file by file directory
/[NO]TITLE Do [not] print a columnar title line at the top of
each "page" of the directory listing. Default is
/NOTITLE for terminals and /TITLE for non-terminal
/[NO]UNITS Do [not] print the file's device as a unit name rather
than a structure name (applies to disks only).
Default is /NOUNITS.
/WIDTH:n Sets the width ("n" characters wide) of the output
directory listing. DIRECT will output as many
separate file listings across the "page" as will fit
in the specified width. Default width is read from
the monitor for terminals, and 132 for non-terminals.
/WORDS When listing the file's length express the length in
units of words rather than disk blocks. Default is
/WRITTEN Use the file's data size (how much data has been
written into the file) rather than the physically
allocated size when printng the file's length.
Default is /WRITTEN.
[End of DIRECT.HLP]