home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pdp10 / tops-10 / direct.hlp < prev    next >
Text File  |  1995-04-05  |  10KB  |  173 lines
  1. DIRECT - Help file for DIRECT %6(441)                           Page 1
  2.  
  3.  
  4. DIRECT is a program to provide a directory listing  of  files  from  a
  5. file-structured  device  such  as  disk  or  DECtapes or from magtapes
  6. written by FAILSAFE, FRS, BACKUP, or DUMPER  (TOPS-20).   The  command
  7. format  is  "listing-file=file1,  file2, . . . " where listing-file is
  8. the file specification  of  where  the  directory  listing  is  to  go
  9. (default  is to the job's controlling terminal) and file1, file2, etc.
  10. are the files to be listed (default device is DSK:, default file  name
  11. and  type  (extension)  are  *, default directory is controlling job's
  12. default path).
  13.  
  14. DIRECT switches (to control output listing format) are:
  15.  
  16. /ACCESS:n       Do an accessing  LOOKUP  (one  which  will  cause  the
  17.                 file's  access  date  to be updated) of any file whose
  18.                 length is "n" blocks or less.   Normally  DIRECT  will
  19.                 not cause the file's access date to be changed.
  20. /[NO]ACCOUNT    Do [not] list th fle's account string.   Default  is
  21.                 /NOACCOUNT.
  22. /ALLOCATED      When listing the file's length  use  the  file's  true
  23.                 physically  allocated  length  rather than the written
  24.                 data length.  Default is /WRITTEN.
  25. /[NO]AUTHOR     Do [not] list the  file's  author  if  the  author  is
  26.                 different from the owner.  Default is /NOAUTHOR.
  27. /BLOCKS         When listing the file's length express the  length  in
  28.                 units of disk blocks (128 words per disk block) rather
  29.                 than words.  Default is /BLOCKS.
  30. /[NO]CHECKSUM   Do  [not]  compute  and  list  the  file's   checksum.
  31.                 Default is /NOCHECKSUM.
  32. /[NO]COMPARE    Suppress directory listing headers and titles as  well
  33.                 as error messages so that the directory listing may be
  34.                 compared  (using,  for  example,  FILCOM)  to  another
  35.                 directory listing.  Default is /NOCOMPARE.
  36. /[NO]DETAIL     Do [not] provide a detailed listing of allknown  file
  37.                 attributes  (such  as  block number of the RIB, etc.).
  38.                 Default is /NODETAIL.
  39. /[NO]DIRECT     Do [not] provide an ASCII directory listing.   Default
  40.                 is /DIRECT.
  41. /[NO]EOTS       When reading a magtape, do [not] stop reading the tape
  42.                 at  logical  end  of tape (two consecutive end of file
  43.                 marks).  Default is /EOTS.
  44. /[NO]ERLOG      Do  [not]  enable  automatic  device  error   logging.
  45.                 Default is /ERLOG.
  46. /FAST           Provide a fast directory listing  consisting  of  only
  47.                 file  name  and  type  (extension)  information.  This
  48.                 avoids having to LOOKUP each file for such information
  49.                 as   the   file's  length,  creation  date/time,  etc.
  50.                 Certain switches such as /CHECKSUM will force a LOOKUP
  51.                 anyway.  Default is /NORMAL.
  52. /[NO]FDTA       When providing a DECtape directory listing,  do  [not]
  53.                 force  the  monitor  to  re-read the DECtape directory
  54.                 block.  Default is /NOFDTA.
  55. /FILES:n        When reading a magtape stop after "n"  physical  files
  56.                 (end  of  file marks) have been read.  Normally DIRECT
  57.                 reads until end of tape (see /EOTS) is encountered.
  58. /[NO]FIND       Do [not] use the "find files" rather than  the  actual
  59.  
  60. DIRECT - Help file for DIRECT %6(441)                           Page 2
  61.  
  62.  
  63.                 physical  device(s)  specified in order to provide the
  64.                 directory listing.  Default is /NOFIND.
  65. /[NO]FLSDIR     Do [not] print the file's device and directory on  the
  66.                 right  hand  side  of  the first line of the directory
  67.                 listing for each different directory listed.   Default
  68.                 is   /FLSDIR   unless  either  /HDSDIR  or  /WIDTH  is
  69.                 specified.
  70. /[NO]FNDBLD     Do  [not]  generate  "find   files"   containing   the
  71.                 directory  information.   If /FDBLD is specified the
  72.                 "find  files"  are  generated  from  the  output  file
  73.                 specification with extensions .FDF and .FPF.  Defaults
  74.                 are device DSK:, filename(s)  FNDDAT,  directory  [-].
  75.                 The  "find  files"  may  be  later  read  by the /FIND
  76.                 switch.  Default is /NOFNDBLD.
  77. /FNDDAT:file    When /FIND  is  specified,  use  "file"  as  the  file
  78.                 specification  of  the  "find  files"  to read for the
  79.                 directory information.  The default "find  files"  are
  80.                 SYS:FNDDAT.FDF  and  SYS:FNDDAT.FPF  if /FNDDAT is not
  81.                 specified, otherwise default device is  DSK:,  filname
  82.                 is  FNDDAT, file types (extensions) are .FDF and .FPF,
  83.                 directory is [-].
  84. /[NO]HDSDIR     Do  [not]  print  the  file's  device  and   directory
  85.                 information  as  a  separate "header" line immediately
  86.                 preceeding the directory listing for each  directory
  87.                 listed.   Default  is  /NOHDSDIR unless both /WIDTH is
  88.                 specified and /FLSDIR is not specified.
  89. /[NO]INDIRECT   Do [not] format the directory listing output in such a
  90.                 manner  that  it can be used directly as command input
  91.                 to  another  program.   Each   file   is   listed   as
  92.                 "dev:file.type[directory]"  on a separate line;  error
  93.                 messages are suppressed;   summaries  are  suppressed.
  94.                 Default is /NORMAL.
  95. /LIST           Use LPT:  as the default output device.
  96. /[NO]MARKS      When reading a magtape, do [not] annotate each end  of
  97.                 file mark encountered.  Default is /NOMARKS.
  98. /[NO]MVOLUME    When reading BACKUP or DUMPER magtapes, do  [not]  ask
  99.                 the user to mount successive reels when end of tape is
  100.                 encountered in the middle of a save set.   Default  is
  101.                 /NOMVOLUME.
  102. /NORMAL         Print  just  the  "normal"  directory  listing   which
  103.                 consists   of   the  file  name,  file  type,  length,
  104.                 protection, creation date, version (if non-zero),  and
  105.                 device  and directory.  /NORMAL is the default listing
  106.                 mode.
  107. /[NO]PRDEVICE   Do [not] always print the device for each file listed.
  108.                 Complete absence of the switch causes the device to be
  109.                 printed  out  only  when  it  is  different  from  the
  110.                 previous  file's device;  /NOPRDEVICE never prints the
  111.                 device;  /PRDEVICE always prints the device.
  112. /[NO]PRDIRECTORY   Do [not] always print the directory for  each  file
  113.                 listed.   Complete  absence  of  the switch causes the
  114.                 directory to be printed out only when it is  different
  115.                 from  the  previous  file's directory;  /NOPRDIRECTORY
  116.                 never  prints  the  directory;   /PRDIRECTORY   always
  117.                 prints the directory.
  118.  
  119. DIRECT - Hlp file for DIRECT %6(441)                           Page 3
  120.  
  121.  
  122. /[NO]PRVERSION  Do [not] always print the file version for  each  file
  123.                 listed.   Complete  absence  of  the switch causes the
  124.                 version to be printed out  only  if  it  is  non-zero;
  125.                 /NOPRVERSION  never  prints  the  version;  /PRVERSION
  126.                 always prints the version (blank filled if zero).
  127. /[NO]RETRY      Do [not] enable automatic error retry when  reading  a
  128.                 file.   /NORETRY  will  generate  an I/O error message
  129.                 even for soft read errors.  Default is /RETRY.
  130. /[NO]REWIND     When reading a magtape, do [not] rewind the tape  both
  131.                 before and after reading it.  Default is /REWIND.
  132. /SLOW           Prints a more detailed directory listing than  /NORMAL
  133.                 (hence it is slower to type) containing the file name,
  134.                 file type, length, protection, access  date,  creation
  135.                 time  and  date,  I/O mode, version (if non-zero), and
  136.                 device and directory.  Default is /NORMAL.
  137. /[NO]SORT       Do [not] format  the  ASCII  directory  listing  in  a
  138.                 format  suitable for reading and sorting.  If /SORT is
  139.                 specified the output listing file will contain no tabs
  140.                 (only  spaces);   date information is strictly numeric
  141.                 in descending  precedence;   all  error  messages  are
  142.                 suppressed from the listing file.  Default is /NOSORT.
  143. /[NO]SUMMARY    Do  [not]  print  the   directory   listing   summary.
  144.                 Complete  absence of the switch prints a summary after
  145.                 each directory listed;  /NOSUMMARY  never  prints  the
  146.                 summary;    /SUMMARY  prints  only  the  summary  (and
  147.                 suppresses  the  regular  file   by   file   directory
  148.                 listing).
  149. /[NO]TITLE      Do [not] print a columnar title line  at  the  top  of
  150.                 each  "page"  of  the  directory  listing.  Default is
  151.                 /NOTITLE for terminals  and  /TITLE  for  non-terminal
  152.                 devices.
  153. /[NO]UNITS      Do [not] print the file's device as a unit name rather
  154.                 than   a  structure  name  (applies  to  disks  only).
  155.                 Default is /NOUNITS.
  156. /WIDTH:n        Sets the width ("n" characters  wide)  of  the  output
  157.                 directory   listing.    DIRECT  will  output  as  many
  158.                 separate file listings across the "page" as  will  fit
  159.                 in  the  specified  width.  Default width is read from
  160.                 the monitor for terminals, and 132 for non-terminals.
  161. /WORDS          When listing the file's length express the  length  in
  162.                 units  of  words  rather than disk blocks.  Default is
  163.                 /BLOCKS.
  164. /WRITTEN        Use the file's data  size  (how  much  data  has  been
  165.                 written  into  the  file)  rather  than the physically
  166.                 allocated  size  when  printng the  file's   length.
  167.                 Default is /WRITTEN.
  168.  
  169.                          [End of DIRECT.HLP]
  170.  
  171. .KJOB
  172. .
  173.