Trailing-Edge
-
PDP-10 Archives
-
BB-H138C-BM
-
5-documentation/wild.doc
There are 15 other files named wild.doc in the archive. Click here to see a list.
WILD.DOC -- Changes from V7A(325) TO V7D(345)
January, 1982
COPYRIGHT (C) 1974,1975,1976,1981,1982 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND 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. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY
TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE
AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
WLD7D.DOC Page 2
WILD.DOC -- Changes from V7A(325) TO V7D(345)
January, 1982
1.0 SUMMARY
This is a maintenance release of WILD necessary to correct errors in
DIRECT, BACKUP, and other utility programs. Corrections were selected
based upon the dual requirements of having high value and low risk.
The version number of WILD is being changed to make it consistent with
SCAN. This fixes all SPRs received through December, 1981.
WILD version 7D runs on all supported monitors. It has been tested on
TOPS-10 V7.01 and TOPS-20 V4. There are no known deficiencies.
1.1 Function of WILD
WILD is designed to be used as a subroutine called from any program
which needs to perform wild-card lookups on any device. It is needed
since the logic for selecting and reading directories has become quite
involved. Among the special cases handled correctly by WILD are
sub-file directories, NEW:, HLP:, SYSA:, and controller
controller-class and file structure abbreviations.
2.0 CHANGES
327 LCR 07-Jun-76
Make NEW: give correct results [1,5] only
330 LCR 07-Jun-76
Handle '+' notation. Broken by edit [325].
331 LCR 05-Oct-76.
Synchronize the saving of the LOOKUP error
code and the PROTECTION code with the POP's.
Areas affected:E$$LKE:
332 SPR # 10-21940 LCR 21-Feb-77.
Clean up EDIT #327
Areas affected: STR1:
333 Provide a symbol equal to the version number for
version checking by programs like QUEUE. LLN, SPR #
10-22263, 24-Mar-77
WLD7D.DOC Page 3
334 SPR # 10-22140 LCR. 08-JUN-77.
Set on the flag indicating "SEARCHING SYS" when using the
construct SYSA: or SYSB: so that both [1,5] and [1,4] is
searched for these variations.
Areas affected: INSTR:
335 SPR # 10-25314 LLN 12-Jun-78.
Remove edits 326 and 323. This prevents %non-existent
directory errors for certain combinations of directories and
search lists, but restricts the problem solved by 323.
336 SPR # 10-26341 BBE 8-Aug-78
Remove 2 redundant lines from edit 334 before INSTR2:
337 SPR # 10-2644 KPY 5-Oct-78
Fix bug in edit 154, DIR FOO[1,1] yields
%WLDNSF No such files as DSK:FOO.*[FOO]
340 SPR # 10-27435 VLR 15-Feb-79.
Fix bug in edit 331, P1 not preserved.
341 SPRS 10-(28960,28962,29648,29708) TARL 28-JUN-80
Another round with SFDs and ersatz devices. Make .DIR DOC give [5,14]
when pathed into an SFD, while making .DIR DOC:[,,A] give [5,14,A].
Install code @STR8 and remove edit 335. Also fix DIRERR - SFDs will be
zapped @STR8 if needed, so dont zap them here.
342 TARL 29-JUN-80
Clean up listing, and insert form feeds.
343 SPR # 29673 RKB 26-Aug-80
Make DECtapes work again. Affects WILDRR + few.
DIRSTI was being used without index - use T4
344 PY 8-Apr-81
Use extended LOOKUP block for SFDs.
345 PY 21-Aug-81
Change version to 7D to be same as SCAN and HELPER.
Version 7B was never shipped, 7C did not exist.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
WLD7D.DOC Page 4
4.0 INSTALLATION INSTRUCTIONS
To install in any program, relink that program using the new WILD.REL
All programs which are to use WILD version 7D should be checked to
insure that they request WILD, and not a specific version of WILD,
such as WLD7A.
Note that although there are several programs which use WILD, we will
not necessarily rebuild all of them when WILD is released. If the
customer experiences a problem with a program which is fixed by the
new version of WILD, he may rebuild the product at his discretion.
5.0 SUGGESTIONS
Support PATH names.
[End of WLD7D.DOC]
[WLD7A.DOC is appended as an integral part of WLD7D.DOC]
WLD7A.DOC Page 5
WILD.DOC -- Changes from V7 to V7A(325)
July, 1975
1.0 SUMMARY
1.1 This release supports the SCAN guide words of 'AND', 'OR', and
'NOT'. 'OR' take the replacement of "+" in previous versions
for DIRECT and QUEUE. "+" still works for this version, but
will be changed in the next version to mean only its
traditional meaning of file concatenation. This version fixes
all SPRs prior to JAN-1975.
1.2 WILD version 7A runs on all monitors. It has been tested on
6.02. There are no known deficiencies. WILD fully supports
the DATE-75 project.
1.3 WILD version 7A is documented in the specification WILD.RNO.
Also, it is documented implicitly in the software notebook
description of DIRECT, and briefly in chapter one of the system
command manual. Supporting documentation can be found in the
.DOC files for SCAN version 7 and DIRECT version 3.
1.4 Function of WILD
WILD is designed to be used as a subroutine called from any
program which needs to perform wild-card lookups on any device.
It is needed since the logic for selecting and reading
directories has become quite involved under the 5-series
monitor. Among the special cases handled correctly by WILD and
few other user-mode programs are sub-file directories, NEW:,
HLP:, SYSA:, and controller controller-class and file structure
abbreviations. Most Digital supplied utilities will eventually
be converted to use WILD if they perform wild-card operations.
2.0 CHANGES
312 (10-14727) fix chktst to work with forced directory and sfd
313 (10-14841) fixes to code for secondary lookup blocks
314 (10-14839) save protect for lookup error printout
315 (ser s55-076) correct bug to find files if default path is an
sfd and reference is ersatz
316 (qar 3672) handle five deep sfds
317 do not clear directory if structure not mounted
320 add external symbol .frcpp for frcppn.
WLD7A.DOC Page 6
321 add new entry point for .instr which causes frcppn to be set.
322 make .inist and .nxstr entry points.
323 Don't discard SFD's when ersatz device and file is wild.
324 (SPR-17317) Use 'SYS' as 'NEW,SYS' if /NEW enabled and ersatz
device SYS is requested.
325 (SPR 10-17642) allow 'NOT' guide word to work with PPNs.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 CHANGES IN INSTALLATION INSTRUCTIONS
The dummy low-segment file WILDDM has been removed since LINK-10
version 2 (released on the July, 1974 distribution tape) has a switch
/ONLY:LOW which can achieve the same effect and ensures the correct
low segment is included. Thus, all commands which reference WILDDM
should be changed to WILD/ONLY:LOW.
Note that although there are several programs which use WILD and SCAN,
we will not necessarily rebuild all of them when WILD is released.
Typically, the various utilities such as DIRECT and QUEUE and DUMP
will be rebuilt, but major products such as LINK and FORTRAN will not
be rebuilt until their next release. If the customer wishes to
rebuild, he may, but usually the changes to WILD and SCAN do not
warrent the cost of rebuilding and testing.
WLD7A.DOC Page 7
5.0 SUGGESTIONS
Read the directories via super USETI if possible for better speed.
This would also allow a pack to be read when not mounted as a
structure.
Support a switch to control SFD scanning, going to LIB: and SYS:.
This would override the job's default.
Make the routine which outputs "IN USE BY JOB n" be generally
available.
Extend the error message routines to include all the components of a
concatenated specification.
Include /BEFORE, etc., in the error message "NO SUCH FILE AS" since
the file may exist, but it is just excluded by the constraints.
Expand the search logic to allow concatenation of directories which
are different (SPR 10-9943).
(SPR 10-10209) Add switches to control the start and end of files
which match a wild-card. Thus, the user could "restart" on a
specified file. Also, add switches which specify to skip n files and
then do m files.
(SPR 10-102019) Add a switch to do the files in reverse order. This
would catch recent files before older ones.
(SPR 10-13457) Allow the caller to specify a channel which can be kept
OPEN in order to speed up the processing.
[End of WLD7A.DOC]
[Extracts of other WILD doc files are appended as an integral part of
WLD7A.DOC]
WILD.DOC -- Changes from V6 to V7 Page 8
EXTRACTS FROM WLD7.DOC
300 Support the file specification separator guide words of 'AND',
'OR', and 'NOT' as passed from SCAN version 7. Of these, 'OR'
has lower precedence, and 'NOT' is interpretted as though it
were "AND NOT". A file is selected only if it meets the
constraints of one of the sets separated by 'OR'. Within such
a set, all matches must be met including switches such as
/BEFORE and /LENGTH. 'NOT' is interpretted essentially as an
exclusion, i.e., as though the user said "ALL x EXCEPT y".
301 Default to /OKPROTECTION if there are any wild cards. This
will tend to hide protected files from the user in order to not
confuse him.
302 If the input side has more wild cards than the output side,
give the message ?WLDTWC TOO MANY WILD-CARDS ON INPUT FOR
OUTPUT. This means that the user must specify the same number
of wild-cards on input and output.
303 Whenever the user gives a device name which implies more than
one structure, ignore any structures which are single access by
other jobs than the user's.
304 Issue a new warning message if all files which were found (or
all directories) had protection failures. The message is
%WLDAFP ALL FILES PROTECTED file-spec.
305 Issue a new warning message if all files which were found were
rejected either by such switches as /SINCE or by the logical
conditions introduced by edit 300. The message is %WLDAFR ALL
FILES REJECTED BY CONDITIONS file-spec.
306 (SPR 10-13,944) Correct typo in one of the LOOKUP error
messages.
307 (QAR 2760) Add error message %WLDSDP SOME DIRECTORIES PROTECTED
which indicates that the file was not found in any directories
looked at, but some of the directories which matched the spec
where protected against the user.
310 (QAR 2836) Correct a bug introduced in edit 304.
311 Add message %WLDSFP SOME FILES PROTECTED which will be issued
if some files match and also some files or directories which
might have matched could not be accessed. This message can be
suppressed with the switch /OKNONE, which suppresses all of the
summary warning messages.
WILD.DOC -- Changes from V5 to V6 Page 9
EXTRACTS FROM WLD6.DOC
143 Remove a bug which caused [p,pn,*,*,*] and similar
constructions to not work as intended. This construction will
now correctly find all files.
144 Correct a bug in the handling of wild-cards on DECtapes.
145 As a performance improvement, especially for KJOB calling of
QUEUE, delete directory access tables only if the directory
does not belong to the user.
146 Add the capability for the caller to obtain a list of
structures which match the user specified device. In
particular, "SYS" will return the sys-search list; "ALL" will
return the all-search list; "DPA" will return all structures
on RP10 number 0; etc. There are two new entry points, .INSTR
and .NXSTR. The first initializes the proceedure with the
user's device and the /PHYSICAL switch if specified; and skip
returns with a code to indicate whether multiple structures may
be involved. The second takes no argument and returns the name
of the next structure, or 0 when done. These routines are
self-initializing, but can not be used while .LKWLD is in
progress.
147 Convert to use C.MAC and SCNMAC.MAC as universal files.
150 Support the user specified /MESSAGE level from .GTWCH. This
allows the user to obtain either the error prefix, or the
message, or both.
151 Move the routine .PTWRD to .SCAN.
152 Support /MESSAGE switch from SCAN.
153 (SPR 10-12368) Handle UFD names when they occur as a file (not
as SIXBIT).
154 Fix /STR with non-wild names to use the correct directory (if
device forces it) and to issue the correct messages if the file
or directory is missing.
155 If /OKNONE is given, then no error will be listed if the file
is missing. This extends the influence of the switch to
non-wild environments as well as wild ones.
156 (SPR 10-12368) Support the switches /BEFORE and /SINCE on
DEC-tapes.
157 Add an optional argument to .LKWLD to specify the address of a
routine to call whenever end of directory is reached. This
will allow DIRECT to issue its summaries more rapidly.
WILD.DOC -- Changes from V5 to V6 Page 10
160 Add an option bit to cause SFD scanning down to occur at the
end of the owning directory instead of in the middle. This
necessitates a second pass for any directory containing an SFD,
but allows DIRECT to give a cleaner listing when multiple
levels are specified.
161 Support the switches /ABEFORE, /ASINCE, /LENGTH, /ESTIMATE,
/ERSUPERSEDE, and /VERSION.
162 (QAR 1882) More of edit 153.
163 More of edit 161. Also, clean up the handling of the special
error code inserts.
164 More of edit 161.
165 Correct NUL: handling in 135.
WILD.DOC -- Changes from V4 to V5 Page 11
EXTRACTS FROM WLD5.DOC
123 Add a new error message "? NO FILE NAME SPECIFIED".
124 Add routine .SCWLD to handle secondary wild-cards such as
output files.
125 Simplify checks for end of directory list.
126 At location WILDK, replace the HALT with a JRST to recover from
read errors in the directory.
127 Add routines E.LKEN and .TFILB as general purpose SCAN style
typeout blocks.
130 Create a dummy module, WILDDM, which defines a low segment the
same size as WILDs. This will be updated each release.
131 In .SCWLD, if the input and output files are for the same
owner, set the default protection to be xyy where x is from the
system standard file protection and yy is from the input file.
132 Support the DATE75 project when checking the /BEFORE and /SINCE
switches.
133 Support the /OKPROTECTION and /ERPROTECTION switches.
/OKPROTECTION suppresses protection check error messages. This
is the default if the UFD is wild.
134 Correct error in edit 127.
135 Handle device NUL: correctly. NUL: is considered to be a
non-directory device for callers of WILD.
136 (SPR 10-10819) Fix a bug in the DECtape directory logic for
wild-carding which omitted the first file of the directory.
137 Type the correct directory when the UFD has a protection error
and the user was trying to specify the directory itself.
140 Change all error messages to have a unique prefix of six
letters starting with WLD. The message prefixes are:
DEM %directory is empty
DFO ?open failure for xxx in use by job nnn
IOE %error while reading file
IWC ?insufficient wild-cards in input for output
LKE lookup/enter failure (or mnemonic message)
LKP %lookup failure (or mnemonic message)
NDO ?null name in output wild-card
NFS ?no file name specified
NNO ?null directory in output wild-card
NSD %no such directory
WILD.DOC -- Changes from V4 to V5 Page 12
NSF %no such files as
NXD %non-existent ufd
NXU %non-existent ufd
SCO ?open failure on xxx in use by job nnn
SLE %search list empty for device
Each error message has a local symbol defined of the form
E$$xxx where xxx is the unique error suffix.
141 (SPR 10-11421) Verify that /STRS and /PHYSICAL are the same on
all files of a concatenated specification.
142 Correctly store for the caller the pointer to the matching
input file spec.
WILD.DOC -- CHANGES FROM V3 TO V4 Page 13
EXTRACTS FROM WLD4.DOC
100 (INTERNAL) CHANGE TO USE .FX SYMBOLS FROM SCNMAC.
101 USE FX.DFX TO FLAG MFD FIXUPS (USER SPECIFIES EXTENSION .UFD).
THIS GIVES THE CONSISTENT INTERPRETATION OF FILE NAME BEING
IGNORED AND DIRECTORY USED FOR EXTENSION .UFD. ALSO, CORRECT THE
CODE TO HANDLE SYS:.UFD, ETC., CORRECTLY.
102 REMOVE A GLITCH WHICH PROHIBITED RE-ENTRY AFTER A NON-DISK DEVICE
IS USED. BEFORE THIS CHANGE, THE CALLER HAD TO UPDATE THE
INITIAL POINTER AND RESTART WILD.
103 ALLOW BOTH FX.ADD AND .FXTRO FOR THE INCLUSIVE OR FUNCTION. THIS
LAYS THE GROUND-WORK TO SWITCH TO "!" AS THE INCLUSIVE OR
SPECIFICATION IN MATCHING RATHER THAT "+".
104 (SPR 10-7182) ADD DEFENSIVE HALT IN CASE LH(DIRECTORY) IS ZERO.
THIS CAN BE CAUSED ONLY BY AN INTERNAL ERROR OR BY A FILSER BUG.
105 (INTERNAL) REPLACE THE INTERN STATEMENTS BY "::".
106 USE THE CORRECT EXTENSION IN THE LOOKUP ERROR MESSAGE.
107 ADD HANDLING OF WILD-CARDS ON DEC-TAPE. HANDLING OF NON-DISK
DEVICES IS ENABLED BY A NEW BIT IN THE ARGUMENT BLOCK. WHEN SET,
THE OPEN AND LOOKUP BLOCKS ARE SETUP FOR ALL DEVICES. THE
NON-SKIP RETURN IS TAKEN ONLY WHEN THE REQUESTS ARE FINISHED.
110 CORRECT SUBSCRIPTING IN E.DFL ROUTINE.
111 FOR MAG-TAPES, SET OPEN BLOCK DEPENDING UPON THE /DENSITY AND
/PARITY SWITCHES.
112 CHANGE /BEFORE AND /SINCE LOGIC TO CONSIDER -1 AS DEFAULT
BEHAVIOUR.
113 IF THE USER'S PROJECT NUMBER IS GREATER THAN 7, AND THE TARGET
DIRECTORY PROJECT IS LESS THAN 10, THEN IF THE USER TYPED "*" FOR
PROJECT AND NOT "*" FOR PROGRAMMER NUMBER REJECT THE MATCH. THIS
SUPPORTS THE NOTION THAT FOR PROJECTS BELOW 10, THE PROGRAMMER
NUMBER IS INDEPENDENT OF THOSE ABOVE 10. IN PARTICULAR, WITH
LIBRARIES, ETC., BEING DEVELOPED FOR PROJECTS BELOW 10, USERS
LOOKING FOR THEIR FILES IN ALL PROJECTS SHOULD NOT SEE THESE
FILES. IF EITHER THE PROJECT IS EXPLICIT OR THE PROGRAMMER IS
"*", THEN THE OLD BEHAVIOUR IS INDICATED. THUS, [*,*] WILL STILL
SEARCH ALL UFD'S. NOTE THAT [?,X] WILL MATCH PROGRAMMER X IN ALL
DIRECTORIES BELOW PROJECT 10. NOTE ALSO, THAT THE BEHAVIOUR FROM
[1,2] IS UNAFFECTED.
WILD.DOC -- CHANGES FROM V3 TO V4 Page 14
114 HANDLE [1,1].UFD CONSISTENT WITH THE OTHER .UFD HANDLING. THIS
ELIMINATES THE NOTATION OF #X0000YY.UFD[1,1].
115 CORRECT A BUG IN THE MFD CHKACC LOGIC. THIS WAS UNCOVERED BY A
BUG IN TWICE WHICH CAUSED STRANGE UFD PROTECTIONS, BUT THE CODE
SHOULD BE CORRECT ANYWAY.
116 CORRECT BUG INTRODUCED BY 107.
117 ADD ENTRY POINT .CHKTA FOR DIRECT TO CHECK THE BEFORE/SINCE
SWITCHES ON MAGTAPES.
120 CHANGE THE MODULE NAME FROM "WILD" TO ".WILD" TO AVOID ANY NAME
CONFLICTS.
121 ADD SYMBOLS ".WILDZ" AND ".WILDL" FOR THE START AND LENGTH OF THE
LOW SEGMENT AREA.
122 HANDLE NO MFD MESSAGE GRACEFULLY ("NON-EXISTENT MFD ON XXX:").
WILD.DOC -- CHANGES FROM V2 TO V3 Page 15
EXTRACTS FROM WLD3.DOC
THE ONLY CHANGE IS TO CORRECT ONE BUG. THIS BUG CAUSED WILD TO SKIP
THE LAST FILE IN EACH BLOCK OF THE DIRECTORY.
WILD.DOC -- CHANGES FROM V1 TO V2 Page 16
EXTRACTS FROM WLD2.DOC
2.0 EXTERNAL CHANGES
2.1 USER (CONSOLE) CHANGES
2.1.1 SUB-FILE DIRECTORIES ARE FULLY SUPPORTED. IN PARTICULAR, UP TO
FIVE SFDS MAY BE SPECIFIED FOLLOWING THE PROJECT,PROGRAMMER NUMBER.
THESE SFDS MAY INCLUDE BOTH * AND ? WILD CARDS. THE SFDS ARE
SPECIFIED IN SIXBIT SEPARATED BY COMMAS. THUS, FOR EXAMPLE, TO REFER
TO THE FILE NAMED FOO.MAC WITHIN SFD XYZ WHICH RESIDES IN SFD ABC IN
AREA [10,612], ONE TYPES "FOO.MAC[10,612,ABC,XYZ]".
2.1.2 THE DEFAULT DIRECTORY SET BY SETSRC IS FULLY SUPPORTED. THIS IS
NORMALLY INVOKED BY NOT SPECIFYING THE DIRECTORY IN THE COMMAND. IF
IT IS DESIRED TO SPECIFY THE DEFAULT DIRECTORY EXPLICITLY, THE
NOTATION "[-]" MAY BE USED.
2.1.3 FOR CONVENIENCE, A DIRECTORY REFERENCE TO A DIRECTORY IN THE
USER'S PROJECT OR HIS PROGRAMMER NUMBER MAY BE LEFT BLANK. THUS [,7]
WHEN LOGGED IN AS [10,612], MEANS [10,7]. SIMILARLY, [11,] WOULD MEAN
[11,612]. THIS ALSO CAN BE USED WITH SFDS, SO THE EXAMPLE IN 2.1.1
CAN BE TYPED AS "FOO.MAC[,,ABC,XYZ]". IF THE DEFAULT DIRECTORY IS NOT
THE USER'S LOGGED IN UFD, HIS UFD CAN BE REFERENCED AS "[,]". NOTE
THAT THESE NOTATIONS USE THE USER'S LOGGED IN PROJECT PROGRAMMER
NUMBER, NOT HIS DEFAULT DIRECTORY.
2.1.4 A DEFICIENCY IN VERSION 1 HAS BEEN FIXED. THE NOTATION "+" IS
USED TO COMBINE SEVERAL SPECIFICATIONS INTO ONE WILD CARD SCAN. IT
REPRESENTS AN OR FUNCTION. FOR EXAMPLE, A.B+C.D MEANS ANY FILE NAMED
A.B OR C.D. IN VERSION 1, THIS DID NOT WORK FOR UFDS. IN VERSION 2
IT WORKS FOR ALL CASES.
2.1.5 (SER 1567) WILD NOW HANDLES CONTROLLER CLASS ABBREVIATIONS,
CONTROLLER ABBREVIATIONS, AND STRUCTURE ABBREVIATIONS. THIS IS FULLY
COMPATIBLE WITH THE FILSER INTERPRETATION OF THESE ABBREVIATIONS.
2.1.6 REPORTING OF DIRECTORY LOOKUP ERRORS IS DEFERRED TO THE END OF
LOOKING AT ALL STRUCTURES. THUS, IF AN SFD OR UFD IS MISSING ON ONE
STRUCTURE, BUT PRESENT ON ANOTHER STRUCTURE, NO ERROR WILL BE
GENERATED. THIS IS COMPATIBLE WITH THE FILSER INTERPRETATION.
2.1.7 THE OPEN FAILURE MESSAGE NOW INCLUDES A QUESTION MARK TO MAKE IT
FATAL. IF POSSIBLE, IT ALSO INCLUDES THE JOB NUMBER OF THE JOB WHICH
IS USING THE DEVICE.
2.1.8 THE FILSER LOOKUP ERROR CODE 24 IS SUPPORTED. THIS CODE HAPPENS
IF THE JOB'S SEARCH LIST IS EMPTY. WILD VERSION 1 DETECTED THIS
ITSELF FOR WILD CARD LOOKUPS, BUT IT DEPENDS ON FILSER IF NO WILD
CARDS ARE INDICATED.
WILD.DOC -- CHANGES FROM V1 TO V2 Page 17
2.1.9 THE DIRECTORY WILD CARDING WORKS AS FOLLOWS. A FILE IS A MATCH
ONLY IF IT APPEARS AT THE DEPTH INDICATED BY THE DIRECTORY
SPECIFICATION OR IF 0 MATCHES THE NEXT DEEPER DIRECTORY SPECIFICATION.
THUS, IF THE USER TYPES "[1,2,A,*,C]", FILES WILL MATCH ONLY IN
[1,2,A] (SINCE 0 MATCHES *) AND IN [1,2,A,*,C] (SINCE THIS IS THE
BOTTOM LEVEL).
2.1.10 SPECIAL HANDLING IS PERFORMED WHEN THE USER SPECIFIES .UFD AS
THE EXTENSION. IN THIS CASE, THE PROJECT-PROGRAMMER NUMBER FROM THE
DIRECTORY (AFTER DEFAULTING) IS SUBSTITUTED FOR THE FILE NAME AND THE
DIRECTORY IS SET TO BE THE MFD (1,1).
2.1.11 WHEN THE MONITOR DOES A LOOKUP ON DEVICES SUCH AS SYS: OR
HLP:, IT IGNORES THE DIRECTORY SPECIFICATION UNLESS IT TURNS OUT TO BE
A LOGICAL DEVICE NAME. WILD DOES THE SAME THING.
2.2 CALLER (PROGRAM) CHANGES
2.2.1 WILD NOW OBSERVES THE STANDARD CALLING CONVENTIONS. ACS 1-4 ARE
TEMP AND 5 IS PRESERVED. PARAMETERS ARE PASSED TO IT VIA A POINTER IN
AC 1. THE INDEX TO THE SCAN BLOCK WHICH MATCHED THE REQUEST IS STORED
IN A LOCATION SELECTED BY THE CALLER.
2.2.2 WILD HAS BEEN UPDATED TO USE THE REVISED TYPEOUT ROUTINES IN
SCAN VERSION 2. THE CALLING SEQUENCE TO THESE ROUTINES HAS BEEN
CHANGED TO PASS THE VALUE IN AC 1.
2.2.3 DIRECTORIES ARE LISTED BY CALLING THE NEW ROUTINE (.TDIRB) IN
SCAN VERSION 2. THIS ROUTINE HANDLES SFD FORMAT AND SCAN FORMAT FOR
THE TYPEOUT.
2.2.4 ALL DIRECTORY READING IS NOW ON CHANNEL 0, WHICH IS ASSUMED TO
BE A SCRATCH CHANNEL. BECAUSE OF THIS, ALL DIRECTORIES ARE READ IN
DUMP MODE.
2.2.5 THE DATA READ ROUTINE (.NXDTW) NOW USES A CHANNEL SELECTED BY
THE CALLING PROGRAM. THE DATA CHANNEL IS NOW OPENED BY THE CALLER.
2.2.6 THE FLAG (.WLDFL) WHICH INDICATES WILDCARD VS. MULTIPLE STRS
VS. SIMPLE LOOKUP, NOW HAS A FOURTH STATE-- VALUE -2 MEANS BOTH
MULTIPLE STRS AND WILDCARD.
2.2.7 THE LOOKUP BLOCK IS NOW RETURNED IN A CORE BLOCK POINTED TO FROM
THE ARGUMENT BLOCK. THIS IS SETUP IN STANDARD EXTENDED LOOKUP FORMAT.
2.2.8 A ROUTINE (.CHKTM) HAS BEEN ADDED WHICH WILL VALIDATE THE FILE'S
CREATION TIME AND DATE AGAINST THE /BEFORE AND /SINCE SWITCHES FROM
SCAN. (THESE SWITCHES ARE NOT SUPPORTED IN SCAN VERSION 2).
WILD.DOC -- CHANGES FROM V1 TO V2 Page 18
5.0 INTERNAL CHANGES
5.1 C.MAC AND SCNMAC.MAC ARE USED FOR ALL MONITOR AND PARAMETER
SPECIFICATIONS.
5.2 ALL DIRECTORY READS ARE VALIDATED BY THE CHKACC UUO. THIS REMOVES
A DEFICIENCY IN QUEUE WHICH ALLOWED THE USER TO LIST PROTECTED
DIRECTORIES. THUS WILD CAN NOW BE USED IN ANY PROGRAM RUNNING WITH
JACCT TURNED ON.
5.3 THE INDEX POINTER TO THE FILE SPEC AREA IS NOW IN P1 (AC 5).
5.4 THE DIRECTORY READING CODE HAS BEEN REWRITTEN. IT NOW HANDLES
UFDS AND SFDS IN ONE ROUTINE. WHEN A UFD OR SFD IS FOUND, THE SEARCH
WILL DROP DOWN INTO THAT DIRECTORY IF THERE IS ANY POSSIBILITY FOR A
MATCH. AT END OF DIRECTORY, THE SEARCH WILL RETURN UP ONE LEVEL.
LEVELS OF THE DIRECTORY WITHOUT WILDCARDS WILL AVOID THE SCAN AND
ASSUME THE RESULT IMMEDIATELY.
5.5 NO SPRS HAVE BEEN RECEIVED. THE ONLY SER WAS 1567, WHICH IS
ANSWERED.
5.6 WHEN WILD IS DONE WITH A DIRECTORY, IT DOES A CLOSE 100 SO THE
MONITOR WILL DELETE THE ACCESS TABLES. THIS SHOULD DECREASE
INTERFERENCE IN THE DORMANT ACCESS TABLES.
[END OF WILD.DOC]