Google
 

Trailing-Edge - PDP-10 Archives - bb-d549g-sb - drt5.doc
There are no other files named drt5.doc in the archive.


DIRECT.DOC -- Changes from V4(234) to V5(336)
July 1975






























Copyright (C) 1972,1974,1977
Digital Equipment Corporation, Maynard, Mass.


This software is furnished under a license for use only  on  a  single
computer system and may be copied only with the inclusion of the above
copyright notice.  This software, or any other copies thereof, may not
be provided or otherwise made available to any other person except for
use on such system and to one  who  agrees  to  these  license  terms.
Title  to  and  ownership of the software shall at all times remain in
DEC.

The information in this software is subject to change  without  notice
and  should  not  be  construed  as  a commitment by Digital Equipment
Corporation.

DEC assumes no responsibility  for  the  use  or  reliability  of  its
software on equipment which is not supplied by DEC.
DRT5.DOC                                                        Page 2


DIRECT.DOC -- Changes from V4(234) to V5(336)
July 1975



1.0  SUMMARY

This release supports the BACKUP project.  It also corrects  all  bugs
reported through SEPT 1975.

DIRECT version 5  runs  on  all  monitors.   It  has  been  tested  on
6.01/5.07.   It  fully supports the DATE-75 project.  DIRECT version 5
fully supersedes all previous versions.

DIRECT version 5 is documented in the system command  manual.   It  is
also  documented  in  the  program  specification DIRECT.RNO.  Related
documentation can be found in the doc files for WILD  version  7A  and
SCAN version 7B.

DIRECT performs a directory listing of any  of  several  media.   Most
commonly,  it  is  used to obtain a directory listing of the disk.  It
can produce a similar listing of a FAILSAFE, BACKUP, or FRS mag  tape.
It  can  also  analyze a tape for the presence of tape labels (both in
ASCII and SIXBIT) as well as SAVE files.  DIRECT can  also  produce  a
listing  of  TMPCOR  and  of DECtapes.  Its output can be formated for
speed, for compactness, for completeness (even extreme detail), or for
sorting by SORT.



2.0  EXTERNAL CHANGES

None.



3.0  KNOWN BUGS AND DEFICIENCIES

If  /SORT  on  several  file  specs  with  distinct  directories,  the
directories  will  not  be  listed  (even  if  concatenated).  This is
because  of  the  notion  that  distinct  directories   can   not   be
concatenated (in WILD) and that distinct requests to DIRECT (separated
by commas) are treated separately.



4.0  INSTALLATION INSTRUCTIONS

Compile with JOBDAT, C and SCNMAC as universals on UNV:, and Load with
SCAN, HELPER, and WILD on REL:.  For example, change:
     .LOAD U+C,U+SCNMAC,DIRECT,SCAN.REL,WILD.REL,HELPER.REL
to:
     .LOAD DIRECT
DRT5.DOC                                                        Page 3


5.0  INTERNAL CHANGES

Edit #

235    (SPR 10-14,824) Correct an error in the FRS tape format.

236    (SPR 10-14,820) Remove the dot before the extension in /F  mode
       when also requesting /SORT.

237    (SPR 10-14,828) Fix a problem in which  file  constraints  were
       being ignored in /F mode.

240    (SPR 10-14,942) Fix a problem that junk labels were causing  an
       ill.  mem.  ref.

241    (SPR 10-14,972) Fix an incorrect MFS error message  during  FRS
       directories.

242    (SPR 10-14,975) Fix FRS tape error processing  to  prevent  ill
       uuo, etc.

243    (SPR 10-15,399) Fix a bug in FRS handling  which  gave  %DRTJFS
       error for null files.

244    (SPR 10-15,717) Fix  a  bug  causing  all  file  output  to  be
       duplicated on the TTY:  after a prefix-only DRTLKE.

245    (SPR 10-16,555) Fix a bug which caused the subtotals to be  off
       by one file in some cases.  Show units only when /UNITS.

246    (SPR 10-16,552) When /SORT/WIDTH, don't place the directory and
       structure on a separate line.

300    (SPR 10-15,415) Improve edit 243.

301    Fix several bugs in handling BACKUP tapes.

302    Support reworked BACKUP format to  the  level  of  /INTERCHANGE
       mode.

303    Change the assembly proceedure to use .REQUEST.

304    Change symbols of the form F$????  to B$????.

305    Fix bugs in checksums from FRS tapes of files whose  length  is
       4(mod 5) blocks.

306    Support .EXE files.

307    (SER 70-427) Fix a bug that the summary line of two single file
       directories included the name of the second.

310    (QAR 2489) List minor versions Z, AZ, and BZ correctly.

311    (QAR 2990) Speed up processing by letting WILD keep  channel  0
DRT5.DOC                                                        Page 4


       open.   This  requires  changes in WILD version 10 to work, but
       will cause no problem with version 7.

312    On LPT:, don't force out lines.

313    (SER 55-134) Clear initial flags so that the routine TCHR works
       ok during initialization.

314    (SER 70-152) Change "input" to "source" in the  error  messages
       to be less confusing.

315    Add unsupported feature tests around the mag tape code.

316    Extend edit 302 to full support of BACKUP format as written  by
       TOPS-10  including the possibility of files not starting at the
       beginning (as in a continuation tape).

317    Add /COMPARE to  suppress  all  overhead  lines.   This  allows
       simple input to FILCOM.

320    (SER 55-219) Fix /WIDTH to work with all combinations of  input
       switches such as /NORMAL.

321    Remove the wait for line-printer unavailable.  The line printer
       is  now  treated  just  like  any  other  device and if none is
       available, will generate an open failure message.  If  the  old
       behaviour is desired, reassemble with FT$LPW set to 1.

322    Add /INDIRECT to  generate  an  indirect  file  rather  than  a
       directory  listing.   This changes the default output extension
       to be .CCL.  This will allow the file to  be  used  as  command
       input  to  programs which do not themselves support wild-cards.
       In this mode, each file occupies one line without  any  blanks.
       Each file includes its structure and directory explicitly.

323    (QAR 3647) Correct a bug in the print decision if /UNITS.

324    Remove extra blank lines inadvertently inserted by edit 307.

325    Use JOBDAT as a UNIVERSAL file.  Change all externals to be ##.

326    Fix a bug which ignored the directory of the output file.

327    Remove all blank lines on a /SUMMARY.

330    Permit /W for dectapes too.

331    Fix listing of BACKUP format mag-tape with SFD's.

332    (SPR-17317) Search SYS after NEW if ersatz device SYS requested
       and /NEW enabled.

333    Make version checking for .EXE files work.

334    Make [226] work when explicit extension given (or not a disk).
DRT5.DOC                                                        Page 5


335    Clean up listings under /TITLE (note that the  "SPOOLING"  word
       is not really handled - spaced - correctly yet).

336    Fix /NOPRDEVICE /NOPRDIRECTORY with /INDIRECT.



6.0  SUGGESTIONS

Sort capabilities should be built in.

Versions and checksums should be available on DECtapes.

Versions should be available on ASCII files.   One  suggestion  is  to
search  5  lines  into  the  file looking for % followed by a standard
version number.

The title logic and column logic should be expanded to handle DECtapes
and to allow the user more control over the report.

(SPR 10-9943) Add a super grand total to cover an entire mag tape.

(SPR 10-12,805) When labelled  tapes  are  supported  by  the  system,
indicate the actual recorded tape density.

(SPR 10-14,278) Have /ETAIL/SORT format output  on  a  line  per  file
basis, conducive to sorting.

(SPR 10-15,458) Support /SINCE, etc., on DECtapes.

(QAR 2813) On /F/W, put a blank line before and after each  line  with
structure/directory.
DRT5.DOC                                                        Page 6


                               APPENDIX
                           DIRECT MESSAGES


%DRTATM AND ANOTHER TAPE MARK

%DRTDDM DATA MISSED, STATUS stat, IN DIRECTORY BLOCK ON dev

%DRTDPE PARITY ERROR, STATUS stat, IN DIRECTORY BLOCK ON dev

%DRTDTM DOUBLE TAPE MARK

%DRTIDE ERROR stat WHILE READING mta FILE filspc

%DRTILL INCORRECT LENGTH FOR LABEL

%DRTJFS JUNK DURING BACKUP/FRS SAVE SET

%DRTJSS JUNK IN SAVE SET

%DRTLKE lookup error FILE filnam

%DRTLOE LISTING DEVICE OUTPUT ERROR, STATUS stat

%DRTMFS TAPE MARK DURING BACKUP/FRS SAVE SET

%DRTMFT MORE THAN 200 FILES IN TMPCOR

%DRTMTM MISSING TAPE MARK AFTER LABEL

?DRTNDD SOURCE DEVICE NOT A DIRECTORY DEVICE dev

?DRTNEC NOT ENOUGH CORE--NEED cor

?DRTNSD NO SUCH DEVICE dev

?DRTNTD TMPCOR NOT SUPPORTED IN THIS MONITOR

?DRTOPE OUTPUT ENTER FAILED ON FILE nam

?DRTOPO OUTPUT OPEN FAILED ON DEVICE dev

?DRTOWI OUTPUT WILD-CARD ILLEGAL

%DRTPET PREMATURE END OF TAPE IN SAVE SET

?DRTTFR DATA ERROR READING DECTAPE DIRECTORY, STATUS stat

?DRTTMI TOO MANY SOURCE FILES
DRT5.DOC                                                        Page 7


%DRTTSM TAPE STARTS WITH TAPE MARK

?DRTUDV SOURCE DEVICE OF UNKNOWN TYPE dev



[End of DRT5.DOC]

[DRT4.DOC is appended as an integral part of DRT5.DOC]
DRT4.DOC                                                        Page 8


DIRECT.DOC -- Changes from V3(152) to V4(234)
September 1974



1.0  SUMMARY This release  supports  the  DATE-75  project.   It  uses
standard  error messages, and cleans up a number of problems.  It adds
the ability to get the author during normal listings,  and  gives  the
user  control  over  the  printing  of the directory and device.  This
version changes the logic so that SFD contents are printed  after  the
entire  owning  directory  instead  of when the SFD is found.  It also
corrects all bugs reported through SPR 10-13,574 (June, 1974).

DIRECT version 4 runs on all monitors.  It has been tested on 5.06 and
6.01/5.07.   It  fully supports the DATE-75 project.  DIRECT version 4
fully supersedes all previous versions.

DIRECT version 4 is documented in the system command  manual.   It  is
also  documented  in  the  program  specification DIRECT.RNO.  Related
documentation can be found in the doc files for  WILD  version  6  and
SCAN version 5.

DIRECT performs a directory listing of any  of  several  media.   Most
commonly,  it  is  used to obtain a directory listing of the disk.  It
can produce a similar listing of a FAILSAFE or FRS mag tape.   It  can
also analyze a tape for the presence of tape labels (both in ASCII and
SIXBIT) as well as SAVE files.  DIRECT can also produce a  listing  of
TMPCOR  and  of  DECtapes.   Its output can be formated for speed, for
compactness, for completeness (even extreme detail), or for sorting by
SORT.



2.0  EXTERNAL CHANGES

None.



3.0  KNOWN BUGS AND DEFICIENCIES.

If  /SORT  on  several  file  specs  with  distinct  directories,  the
directories  will  not  be  listed  (even  if  concatenated).  This is
because  of  the  notion  that  distinct  directories   can   not   be
concatenated (in WILD) and that distinct requests to DIRECT (separated
by commas) are treated separately.
DRT4.DOC                                                        Page 9


4.0  INSTALLATION INSTRUCTIONS

Compile with C and SCNMAC as universals instead of as parameter files.
For example, change:
     .COMPILE C+SCNMAC+DIRECT
to:
     .COMPILE U+C,U+SCNMAC,DIRECT
where U.MAC contains "%.C==-3".



5.0  INTERNAL CHANGES

Edit #

153    (SPR 10-9943) Ensure that the last sub-total is always issued.

154    (SPR 10-10979) Avoid an ILLEGAL UUO message on  some  forms  of
       command errors.

155    (SPR 10-10590) Avoid the spurious (and  incorrect)  message  NO
       FILES on a MTA:/F.

156    Correct bug when creating the buffer ring for magtapes.

157    Cancelled by edit 227.

160    If output is not to  the  TTY:,  force  all  summaries  so  the
       terminal user can see what is happening.

161    (SPR 10-9981) Reject NUL: gracefully.  This test works only  in
       monitors since 6.01/5.07.

162    Support the DATE-75 project.

163    Handle  a   potentially   infinite   number   of   input   file
       specifications.  Actually, the limit is when core runs out.

164    Standardize the error  messages.   Add  prefixes  of  the  form
       DRTxyz.  See the appendix to this document for a list of DIRECT
       error messages.

165    Support   SFD's,   /DENSITY/PARITY,   etc.,   in   the   output
       specification by calling SCAN'S routine, .STOPN.

166    Give the correct message (file name) when there is an I/O error
       on magtape.

167    More of edit 163.

170    More of edit 155.

171    (SPR 10-????) Print the left half of .RBELB in octal, since  it
       is the error CONI.
DRT4.DOC                                                       Page 10


172    When running under 6.01/5.07, use MTCHR. to obtain  information
       in a device (controller) independent fashion.

173    (SPR 10-10324) Add a % at the start of  the  message  FILE  NOT
       FOUND to allow batch jobs to test for this condition.

174    (SPR 10-11580) Add switches to  control  the  printing  of  the
       structure  (device)  and  directory.   The  default remains the
       same, but the structure and/or directory can be  forced  on  by
       the  switches  /PRDEVICE  and  /PRDIRECTORY  respectively.  The
       inverse switches  are  /NOPRDEVICE  and  /NOPRDIRECTORY,  which
       restore  the  default  bahaviour.  Also add the ability to list
       the author in the normal directory listing.  This is controlled
       by the switch /AUTHOR and its default inverse, /NOAUTHOR.

175    Suppress a message which reported a TOTAL OF 0 FILES.

176    More of edit 162.

177    More of edit 173.

200    (SPR 10-11233) In a /DETAIL, compute and print the block number
       (decimal) of the RIB.

201    Count the blocks used on a DECtape listing and issue a  summary
       line like the disk.

202    Suppress the titles on a DECtape or TMPCOR directory listing.

203    Comment out the  code  to  support  BACKUP/RESTORE  format  mag
       tapes.

204    Change assembly proceedure  to  use  C.MAC  and  SCNMAC.MAC  as
       UNIVERSAL files.

205    Print summaries before any  subsequent  error  messages.   This
       also  has  the  benefit  of  issuing  summaries at the end of a
       directory  instead  of  delaying  while   looking   for   other
       directories.

206    Always print UFD names as [p,pn] rather  than  as  normal  file
       names.

207    Use the  new  feature  in  WILD  to  list  the  contents  of  a
       sub-directory after the entire main directory instead of in the
       middle.

210    Support the /MESSAGE level switch and job's setting  via  SCAN.
       This  allows  the  user  to  control  the issuing of the DRTxyz
       prefix  and  the  message  text.   Also  support   the   option
       /MESSAGE:ADDRESS for the ease of debugging.

211    Remove a bug that occasionally  listed  the  directory  on  two
       lines.
DRT4.DOC                                                       Page 11


212    To save typeout time, if /F and not /WIDTH, then  separate  the
       file name and extension with a dot instead of a tab.

213    Support SIXBIT tape labels.

214    (SPR 10-11,493) Force output when at the end of a directory  in
       /F/W mode.  This makes the listing complete sooner, but doesn't
       affect the final result.

215    (SPR 10-12,805) Indicate that  the  density  and  parity  of  a
       magtape  are those that the tape is being read under instead of
       the ones it was written under.

216    (SPR 10-12,995) When a parity error is  encountered  reading  a
       DECtape,  make  the  message  be a warning and proceed with the
       directory listing.

217    Don't force output on a tab.

220    (SPR 10-13,049) Implement /SUMMARY on DECtape and TMPCOR.

221    (SPR 10-13,048) Implement /CHECKSUM, /AUTHOR,  and  /ACCESS  to
       work correctly when /F is specified.

222    On magtape directory listings, exclude the copy of  the  LOOKUP
       block in the checksum;  this will make the totals and subtotals
       agree with the result from the disk.

223    Handle /F/SUMMARY to not include "0 blocks".  In this case, the
       summary  message  will  now  be  "total of n files".  Normally,
       however, /F/SUMMARY will include the block count  since  it  is
       specifically accumulated.

224    Fix miscellaneous bugs introduced since version 3.

225    Add switch /FDTA and /NOFDTA to complement it  which  indicates
       that  the  DECtape  directory is to be read quickly (from core)
       instead of from the tape each time.

226    (QAR 2173) Allow output of a  DECtape  directory  to  the  tape
       whose directory is being taken.

227    Remove edit 157.

230    Support FRS format magnetic tapes.

231    Flag the switches which are global commands since they can  now
       preceed the "@" of an indirect request.

232    Allow SWITCH.INI to specify  file  specific  switches  such  as
       output protection, /PHYSICAL, and /AFTER.

233    Support the WILD version 7 implementation of /OKPROTECTION.  If
       this  is  set  (it is the default if there are any wild-cards),
       then protected files are not listed.  If all matching files are
DRT4.DOC                                                       Page 12


       protected,  then  WILD  issues  the warning message %WLDAFP ALL
       FILES PROTECTED.

234    (Update  of  157  and  227)  Make  the   default   setting   be
       /ERPROTECTION  unless  the user specifies /OKPROTECTION.  Thus,
       protected files and directories will be  listed,  unlike  other
       programs using WILD, which will suppress protected files except
       for a warning if there were any.  Specifying  /OKPROTECTION  if
       there  are  wild cards will give the same results as the normal
       WILD default.  If the WILD default is  really  desired,  DIRECT
       can be reassembled with the unsupported feature test FT$IFP=1.



6.0  SUGGESTIONS

Sort capabilities should be built in.

Versions and checksums should be available on DECtapes.

Versions should be available on ASCII files.   One  suggestion  is  to
search  5  lines  into  the  file looking for % followed by a standard
version number.

The title logic and column logic should be expanded to handle DECtapes
and to allow the user more control over the report.

(SPR 10-9943) Add a super grand total to cover an entire mag tape.

(SPR 10-12,805) When labelled  tapes  are  supported  by  the  system,
indicate the actual recorded tape density.
DRT4.DOC                                                       Page 13


                               APPENDIX
                           DIRECT MESSAGES


%DRTATM AND ANOTHER TAPE MARK

%DRTDDM DATA MISSED, STATUS stat, IN DIRECTORY BLOCK ON dev

%DRTDPE PARITY ERROR, STATUS stat, IN DIRECTORY BLOCK ON dev

%DRTDTM DOUBLE TAPE MARK

%DRTIDE ERROR stat WHILE READING mta FILE filspc

%DRTILL INCORRECT LENGTH FOR LABEL

%DRTJSS JUNK IN SAVE SET

%DRTLKE lookup error FILE filnam

%DRTLOE LISTING DEVICE OUTPUT ERROR, STATUS stat

%DRTMFT MORE THAN 200 FILES IN TMPCOR

%DRTMTM MISSING TAPE MARK AFTER LABEL

?DRTNDD INPUT DEVICE NOT A DIRECTORY DEVICE dev

?DRTNEC NOT ENOUGH CORE--NEED cor

?DRTNSD NO SUCH DEVICE dev

?DRTNTD TMPCOR NOT SUPPORTED IN THIS MONITOR

?DRTOPE OUTPUT ENTER FAILED ON FILE nam

?DRTOPO OUTPUT OPEN FAILED ON DEVICE dev

?DRTOWI OUTPUT WILD-CARD ILLEGAL

%DRTPET PREMATURE END OF TAPE IN SAVE SET

?DRTTFR DATA ERROR READING DECTAPE DIRECTORY, STATUS stat

?DRTTMI TOO MANY INPUT FILES
DRT4.DOC                                                       Page 14


%DRTTSM TAPE STARTS WITH TAPE MARK

?DRTUDV INPUT DEVICE OF UNKNOWN TYPE dev



[End of DRT4.DOC]

[DRT3.DOC is appended as an integral part of DRT4]
DRT3.DOC                                                       Page 15


DIRECT.DOC -- Changes from V2 to V3(152)
October 1972



1.0  SUMMARY

THIS RELEASE SUPPORTS THE USER PROFILE  FILE  "SWITCH.INI".   IT  ALSO
CORRECTS  ALL  BUGS  REPORTED  THROUGH  SPR 10-8314.  IT ALSO INCLUDES
SEVERAL NEW MAG-TAPE SWITCHES.

DIRECT VERSION 3 RUNS ON ALL MONITORS.  IT HAS BEEN TESTED  ON  5.04A,
AND  5.05.   DIRECT  VERSION 3 FULLY SUPERSEDES ALL PREVIOUS VERSIONS.
IT ALSO FULLY SUPERSEDES LOOKFL.

DIRECT VERSION 3 IS DOCUMENTED IN THE MAY, 1972, UPDATE TO THE  SYSTEM
COMMAND  MANUAL.   IT  IS ALSO DOCUMENTED IN THE PROGRAM SPECIFICATION
DIRECT.RNO.  RELATED DOCUMENTATION CAN BE FOUND IN THE DOC  FILES  FOR
WILD VERSION 4 AND SCAN VERSION 3.

BEWARE OF THE FOLLOWING FORMAT CHANGES IN /SORT  OUTPUT.   DIRECTORIES
ARE  NOW  INCLUDED IF A WILD-CARD IS SPECIFIED IN THE DIRECTORY (126).
THEY ARE  LISTED  IN  FIXED  FORMAT  (137).   THE  VERSION  COLUMN  IS
ALLOCATED  15  CHARACTERS,  PUSHING THE STRUCTURE AND DIRECTORY FIELDS
ONE TAB TO THE RIGHT (8 COLUMNS) (150).  ON MAGTAPES, THE STRUCTURE IS
ALWAYS INCLUDED (151).



2.0  EXTERNAL CHANGES

NONE.



3.0  KNOWN BUGS AND DEFICIENCIES.

IF  /SORT  ON  SEVERAL  FILE  SPECS  WITH  DISTINCT  DIRECTORIES,  THE
DIRECTORIES  WILL  NOT  BE  LISTED  (EVEN  IF  CONCATENATED).  THIS IS
BECAUSE  OF  THE  NOTION  THAT  DISTINCT  DIRECTORIES   CAN   NOT   BE
CONCATENATED (IN WILD) AND THAT DISTINCT REQUESTS TO DIRECT (SEPARATED
BY COMMAS) ARE TREATED SEPARATELY.



4.0  INSTALLATION INSTRUCTIONS

NONE.
DRT3.DOC                                                       Page 16


5.0  INTERNAL CHANGES

126  (SPR 10-7613) LIST DIRECTORIES IF WILD  DIRECTORY  AND  /SORT  IS
     SPECIFIED.

127  (INTERNAL) CHANGES  STORAGE  LOCATION  OF  SOME  SWITCHES  TO  BE
     COMPATABLE WITH THE OPTIONS FILE CALL.

130  CALL .OSCAN TO IMPLEMENT THE USER PROFILE "SWITCH.INI".  ALSO ADD
     SWITCH /NORMAL (OR /N) TO OVERRIDE A /FAST IN THE PROFILE.

131  (SPR 10-8314) THE SUMMARY OF LOOKUP ERRORS WAS  PREMATURE.   THIS
     HAS BEEN CORRECTED.

132  (SPR  10-8280)  GRAND  TOTAL  CHECKSUMS  WERE   INCORRECT   (THEY
     DUPLICATED THE LAST FILE).  THIS HAS BEEN CORRECTED.

133  (QAR 149) MAG TAPE SCANNING STOPPED ON THREE RATHER THAN TWO TAPE
     MARKS.  THIS HAS BEEN CORRECTED.

134  (SPR 10-7635) DIRECTORY OF A /U FAILSAFE TAPE PUT THE SUMMARY  IN
     THE WRONG POSITION (DELAYED).  IT ALSO SKIPPED SOME SUMMARY LINES
     FOR THE SAME REASON.  THIS HAS BEEN CORRECTED.

135  MAG  TAPE  DIRECTORIES  DID  NOT  HANDLE   EMPTY   CROSS-SECTIONS
     CORRECTLY.  THIS HAS BEEN CORRECTED.

136  THE RIB WORD (EXTENDED LOOKUP BLOCK) CONTAINING THE CREATION DATE
     AND TIME IN INTERNAL FORMAT IS NOW PRINTED IN HUMAN TERMS (RATHER
     THAN OCTAL).

137  (SPR 10-7613 SUGGESTION) IN /SORT MODE, THE DIRECTORIES ARE GIVEN
     WITH  LEADING  ZEROS  (OR  TRAILING SPACES) TO ALLOW SORTS ON THE
     DIRECTORY FIELD.

140  CORRECTED A FORMATTING BUG IN FIXED FORMAT OCTAL (7).

141  (QAR 177 SUGGESTION) ADDED SWITCHES TO CONTROL REWINDS, NUMBER OF
     TAPE  MARKS  TO PROCESS, AND WHETHER TO STOP AT DOUBLE MARK.  THE
     NEW SWITCHES ARE:
     /EOT AND /NOEOT TO CONTROL DOUBLE MARK.
     /FILES:N TO CONTROL NUMBER OF MARKS.
     /REWIND AND /NOREWIND TO CONTROL THE REWINDS.
     AT THE SAME TIME, ADDITIONAL SWITCHES TO COMPLEMENT EXISTING ONES
     WERE INCLUDED:
     /BLOCKS AS OPPOSITE OF /WORDS
     /WRITTEN AS OPPOSITE OF /ALLOCATED
     /NO FOLLOWED BY CHECKSUM, SORT, OR TITLE

142  CHANGE /MARKS OUTPUT TO INDICATE THE FINAL TAPE MARK AS WELL.

143  CORRECT BUG INTRODUCED BY 127.
DRT3.DOC                                                       Page 17


144  CORRECT BUG INTRODUCED BY 140.

145  RESTORE .JBFF BEFORE EACH OPEN.   THIS  PREVENTS  AN  UNNECESSARY
     GROWTH  IN  SIZE.   ALSO,  ON  DISK  FILES,  DO  AN INBUF 10.  TO
     ESTABLISH A LARGE RING IN CASE OF CHECKSUMMING.

146  ADD /NOSUMMARY, /NODETAIL, AND /NOUNITS TO CANCEL POSSIBLE OPTION
     SETTINGS.

147  IF /DETAIL/SUMMARY, DO  BOTH.   IF  /NOSUMMARY,  NEVER  GIVE  THE
     SUMMARY.   IF /NOUNITS, ALWAYS GIVE THE STRUCTURE (PREVIOUSLY, IF
     THERE WAS NO WILD-CARDING, THE UNIT  WAS  GIVEN;   ALSO,  /DETAIL
     WILL DEFAULT TO /UNITS BUT OBSERVE THE ACTUAL SETTING IF GIVEN).

150  IF /SORT, ALLOCATE 15 COLUMNS  FOR  THE  VERSION  NUMBER  SO  THE
     STRUCTURE AND DIRECTORY ARE IN FIXED POSITIONS.

151  ON MAGTAPES, /SORT WILL ALWAYS INCLUDE THE STRUCTURE SINCE  THERE
     IS  NO  WAY  TO TELL WHETHER THE TAPE REPRESENTS ONE OR MORE FILE
     STURUCTURES.

152  (DEFICIENCY OF VERSION 2)  IF  /SUMMARY,  INCLUDE  VIRTUALLY  ALL
     SUMMARIES  INCLUDING  THOSE  OF  ONE FILE, ETC.  THE ONLY SUMMARY
     OMITTED IS NO FILES AND NO ERRORS ON ONE STRUCTURE.  EVEN IN THIS
     CASE, THE GRAND TOTAL WILL BE LISTED (0 FILES).



6.0  SUGGESTIONS

SORT CAPABILITIES SHOULD BE BUILT IN.

CONSTRAINTS SHOULD BE AVAILABLE FOR FIELDS BESIDES CREATION  DATE/TIME
AND FILE NAME/EXT/DIRECTORY.

VERSIONS AND CHECKSUMS SHOULD BE AVAILABLE ON DECTAPES.

VERSIONS SHOULD BE AVAILABLE ON ASCII FILES.   ONE  SUGGESTION  IS  TO
SEARCH  5  LINES  INTO  THE  FILE LOOKING FOR % FOLLOWED BY A STANDARD
VERSION NUMBER.

AN OPTION SHOULD EXIST TO TYPEOUT THE NAME AND EXTENSION IN OCTAL  FOR
CONVENIENCE OF OCTAL TYPEIN.

THE TITLE LOGIC AND COLUMN LOGIC SHOULD BE EXPANDED TO HANDLE DECTAPES
AND TO ALLOW THE USER MORE CONTROL OVER THE REPORT.

MORE THAN 16 INPUT SPECS SHOULD BE ALLOWED.   THE  DYNAMIC  ALLOCATION
TECHNIQUE IN QUEUE SHOULD BE ADOPTED.



[END OF DRT3.DOC]

[DRT2.DOC IS APPENDED AS AN INTEGRAL PART OF DRT3.DOC]
DRT2.DOC                                                       Page 18


DIRECT.DOC -- CHANGES FROM VERSION 1 TO 2
APRIL 1972



1.0 SUMMARY

THIS RELEASE UPGRADES DIRECT TO USE SCAN VERSION 2 AND WILD VERSION 2.
DIRECT  ALSO  SUPPORTS  SUB-FILE DIRECTORIES AND OTHER FEATURES OF THE
5.05 MONITOR.  THIS VERSION OF DIRECT ALSO READS MAGTAPES IN  FAILSAFE
AND BACKUP FORMATS.

DIRECT VERSION 2 RUNS ON ALL MONITORS.  IT HAS BEEN  TESTED  ON  5.03,
5.04,  AND  5.05.   DIRECT  VERSION  2  FULLY  SUPERSEDES ALL PREVIOUS
VERSIONS.  IT ALSO FULLY SUPERSEDES LOOKFL.

DIRECT VERSION 2 IS DOCUMENTED IN THE MAY, 1972, UPDATE TO THE  SYSTEM
COMMAND  MANUAL.   IT  IS ALSO DOCUMENTED IN THE PROGRAM SPECIFICATION
DIRECT.RNO.  RELATED DOCUMENTATION CAN BE FOUND IN THE DOC  FILES  FOR
WILD VERSION 2 AND SCAN VERSION 2.



2.0 EXTERNAL CHANGES

2.1 DIRECT VERSION 2 USES  SCAN  RATHER  THAN  THE  BUILT  IN  COMMAND
SCANNER.   THIS  GIVES  DIRECT  THE  STANDARD  INDIRECT  FILE  AND CCL
CAPABILITIES.  IT ALSO SUPPORTS ALL STANDARD SWITCHES SUCH AS /RUN.

2.2 SUB FILE DIRECTORIES ARE FULLY SUPPORTED.  SEE SCAN AND  WILD  DOC
FILES FOR FURTHER INFORMATION.

2.3 THE TOTAL LINE NOW INCLUDES THE NUMBER  OF  LOOKUP  FAILURES.   IN
/CHECKSUM MODE, IT ALSO INCLUDES THE AGGRAGATE CHECKSUM.

2.4 IN /SORT MODE,  THE  DATES  ARE  GIVEN  IN  ANSI  STANDARD  FORMAT
"YYYYMMDD" SO THAT THEY CAN BE SORT KEYS.

2.5 THE DIRECTORY IS  LISTED  IN  /SORT  MODE  ONLY  IF  THERE  WAS  A
DIRECTORY WILDCARD.

2.6 THE STRUCTURE IS LISTED IN /SORT MODE ONLY IF MULTIPLE  STRUCTURES
ARE INDICATED.

2.7 IN /WIDTH, THE STRUCTURE AND DIRECTORY ARE LISTED  ON  A  SEPARATE
LINE.

2.8 THE VERSION IS NOW OUTPUT BEFORE THE STRUCTURE AND DIRECTORY.

2.9 THE SPOOLED FILE NAME IS NOW INCLUDED IN  THE  NORMAL  LISTING  IF
NON-ZERO.

2.10 /FAST AND /SUM MAY BE USED  TOGETHER.   THIS  WILL  GIVE  A  FAST
LISTING AND THE FULL SUMMARY.
DRT2.DOC                                                       Page 19


2.11 DIRECT WILL  NOW  GIVE  SUBTOTALS  FOR  EACH  DIRECTORY  ON  EACH
STRUCTURE.

2.12 THERE IS A NEW SWITCH, /WORDS, WHICH WILL PRINT DISK  LENGTHS  IN
WORDS INSTEAD OF BLOCKS.

2.13 THERE IS A NEW SWITCH,  /DETAIL,  WHICH  INCLUDES  EVERYTHING  OF
INTEREST  FROM  THE  EXTENDED  LOOKUP.   THUS,  DIRECT VERSION 2 FULLY
SUPERSEDES LOOKFL.  THE ONE SYNTAX CHANGE FROM LOOKFL IS THE METHOD OF
LISTING THE UFD LOOKUP INFORMATION.  WHEREAS IN LOOKFL, ONE WOULD TYPE
"15,73.UFD", IN DIRECT ONE TYPES "[15,73].UFD".  DIRECT ALSO  SUPPORTS
WILDCARDS IN THIS MODE.

2.14 THE TMPCOR DIRECTORY LISTING NOW INCLUDES THE FREE SPACE FOR THIS
JOB.

2.15 THE + NOTATION IS NOW SUPPORTED ON ALL DEVICES CORRECTLY.

2.16 THE RIB VERSION NUMBER (.RBVER) IS NOW  USED  IF  AVAILABLE.   IN
/DETAIL MODE, BOTH FILE AND RIB VERSIONS WILL BE LISTED IF DIFFERENT.

2.17 "UFD" IS NOT LISTED FOR UFDS.  THE UFDS ARE COMMA CENTERED.  THIS
MAKES THE UFD LISTINGS COMPATIBLE WITH THE NORMAL ONES.

2.18 IF THE INPUT DEVICE IS A MAG TAPE, PROCESS IT IN ITS ENTIRETY  IN
HRI,  SAVE,  FAILSAFE,  AND  BACKUP FORMATS.  ANSI-LIKE LABELS WILL BE
PRINTED.  IF /MARKS IS TYPED, ALL TAPE MARKS (EOFS) WILL BE INDICATED.
THE  TAPE DENSITY AND NUMBER OF CHANNELS WILL BE LISTED.  FOR FAILSAFE
AND BACKUP FORMATS, THE MAG TAPE DIRECTORY WILL BE JUST LIKE THE  DISK
DIRECTORY THAT IT BACKS UP.  THIS INCLUDES /CHECKSUM AND /DETAIL.  THE
STANDARD SWITCHES /DENSITY AND /PARITY  ARE  SUPPORTED.   THE  DEFAULT
DIRECTORY ON MAG TAPE IS [*,*,*...*], NOT [-].

2.19 THE STANDARD SWITCH /PROTECT IS SUPPORTED ON OUTPUT.



3.0 KNOWN BUGS AND DEFICIENCIES.

THE 5.05 PSEUDO-DEVICES OF HLP:, SXS:, ALL:, ETC.  HAVE NOT BEEN FULLY
CHECKED  OUT BECAUSE THE 5.05 MONITOR TESTING IS NOT COMPLETE.  BACKUP
FORMAT HANDLING IS STILL TENTATIVE.  IT WILL BE REVISED WHEN BACKUP IS
RELEASED.

IF ONLY ONE FILE IS BEING LISTED AND /SUMMARY IS  REQUESTED,  THEN  NO
OUTPUT IS GENERATED.  THIS IS BECAUSE NORMAL LISTINGS DO NOT INCLUDE A
TOTAL LINE IN THIS CASE.



4.0 INSTALLATION INSTRUCTIONS

DIRECT NOW ASSEMBLES WITH C.MAC AND SCNMAC.MAC.   IT  IS  LOADED  WITH
SCAN.REL, WILD.REL, AND HELPER.REL.
DRT2.DOC                                                       Page 20


5.0 INTERNAL CHANGES

5.1 AFTER LOOKUPS, A CLOSE 100 IS ISSUED TO DELETE THE ACCESS  TABLES.
THIS SHOULD HELP THE FILSER OPTIMIZATION.

5.2 THE FOLLOWING SPR FIXES HAVE BEEN  INCORPORATED:   10-4872,  4598,
6005, 6279, AND 6368.  THERE ARE NO OUTSTANDING SPRS.

5.3 (SPR 10-6368) IN /SORT MODE,  ALL  TABS  ARE  PREFIXED  BY  ENOUGH
SPACES  TO MAKE THE NUMBER OF CHARACTERS UNIFORM.  THUS ANY COLUMN CAN
BE USED AS A SORT KEY.

5.4 DTA:  DIRECTORY NOW USES 317 MODE.  THIS ALLOWS DEAD RECONING.  IN
5.04  AND  LATER MONITORS, THE TAPE IS NOT PRE-POSITIONED TO BLOCK 98.
INSTEAD, DIRECT COUNTS ON THE MONITOR SWAPPING THE JOB AS NEEDED.

5.5 A BUG WHICH RESULTED IN ERRONEOUS NON-EXISTENT FILE  MESSAGES  HAS
BEEN CORRECTED.

5.6 THE /BEFORE AND /SINCE SWITCHES WILL BE SUPPORTED  WHEN  INSTALLED
IN SCAN.  THE SPACE IS ALLOCATED AND THE CALL TO WILD IS PRESENT.

5.7 THE TYPE/LIST LOGIC AND TITLE LOGIC HAS BEEN  CORRECTED  TO  AVOID
SEVERAL INSTANCES OF DOUBLE OUTPUT.

5.8 TABS AT END OF LINE ARE NOW CORRECTLY SUPRESSED.



6.0 SUGGESTIONS

6.1 SORT CAPABILITIES SHOULD BE BUILT IN.

6.2 CONSTRAINTS  SHOULD  BE  AVAILABLE  FOR  FIELDS  BESIDES  CREATION
DATE/TIME AND FILE NAME/EXT/DIRECTORY.

6.3 VERSIONS AND CHECKSUMS SHOULD BE AVAILABLE ON DECTAPES.

6.4 VERSIONS SHOULD BE AVAILABLE ON ASCII FILES.  ONE SUGGESTION IS TO
SEARCH  5  LINES  INTO  THE  FILE LOOKING FOR % FOLLOWED BY A STANDARD
VERSION NUMBER.

6.5 AN OPTION SHOULD EXIST TO TYPEOUT THE NAME AND EXTENSION IN  OCTAL
FOR CONVENIENCE OF OCTAL TYPEIN.

6.6 THE TITLE LOGIC AND COLUMN LOGIC  SHOULD  BE  EXPANDED  TO  HANDLE
DECTAPES AND TO ALLOW THE USER MORE CONTROL OVER THE REPORT.

6.7  MORE  THAN  16  INPUT  SPECS  SHOULD  BE  ALLOWED.   THE  DYNAMIC
ALLOCATION TECHNIQUE IN QUEUE SHOULD BE ALLOWED.



[END OF DRT2.DOC]