Google
 

Trailing-Edge - PDP-10 Archives - bb-jr93i-bb - 7,6/ap020/direct.hlp
There are 17 other files named direct.hlp in the archive. Click here to see a list.
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
default path).

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 the file's account string.   Default
                    is /NOACCOUNT.
/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.
/BLOCKINGFACTOR:n   Set the number of disk blocks per tape block  read
                    from   tape.    The   default   value   is  4  for
                    compatibility with tapes written by BACKUP without
                    blocking  factor  capability.  The specified value
                    must be in the range of 4 to 96, and be a multiple
                    of  4  disk  blocks.   Due  to KS10 UNIBUS adapter
                    limitations, the maximum blocking factor on a KS10
                    is 56.
/[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  all  known
                    file  attributes (such as block number of the RIB,
                    etc.).  Default is /NODETAIL.
/[NO]DIRECT         Do  [not]  provide  an  ASCII  directory  listing.
                    Default is /DIRECT.
/DTA                List in old DECtape format.
/[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.
/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  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 specified.
/[NO]FNDBLD         Do [not]  generate  "find  files"  containing  the
                    directory  information.   If  /FNDBLD 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 /NOMVOLUME.
/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 mode.
/[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.
/[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.
/[NO]SBRMSG         Do [not] issue  the  'DRTSBR  Skipping  BACKUP/FRS
                    repeater  record'  warnings  upon  encountering  a
                    BACKUP/FRS-formatted  magtape   repeater   record.
                    Default is /NOSBRMSG.
/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 listing).
/[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
                    devices.
/TMPCOR             List in old TMPCOR format.
/[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.
/[NO]WORDS          When listing the file's length, do  [not]  express
                    the  file's  length  in units of words rather than
                    disk blocks.  Default is /NOWORDS.
/WRITTEN            Use the file's data size (how much data  has  been
                    written  into the file) rather than the physically
                    allocated size when printing  the  file's  length.
                    Default is /WRITTEN.

                         [End of DIRECT.HLP]