SCAN.DOC -- Changes from V7B(572) TO V7D(630)
January, 1982
COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1972,1974,1977,1981,1982,1986.
ALL RIGHTS RESERVED.
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.
SCN7D.DOC Page 2
SCAN.DOC -- Changes from V7B(572) TO V7D(630)
January, 1982
1.0 SUMMARY
This is a maintenance release of SCAN necessary to correct scanning
errors in LINK, DIRECT, LOGIN, BACKUP, and other utility programs.
Corrections were selected based upon the dual requirements of having
high value and low risk. This fixes all SPRs received through
December, 1981.
Note that SCAN version 7C was not shipped. All version 7C edits are
included in version 7D.
SCAN version 7D runs on all supported monitors. It has been tested on
TOPS-10 V7.01 and TOPS-20 V4. SCAN version 7D depends on WILD version
7D. There are no known deficiencies.
SCAN version 7D is documented implicitly in the software notebook
description of DIRECT, LINK, and MAKLIB. Supporting documentation can
be found in the .DOC files for WILD version 7D.
1.1 FUNCTION OF SCAN
SCAN is designed to be used as a subroutine by programs needing a
command scanner. It supports four basic types of commands. One is
the traditional form of output device(s) = input device(s). In this
case, options are controlled by switches preceded by a slash. The
switches are an abbreviated word. Values for the switch are indicated
by following the switch name by a colon and the value. The second
type of command structure is that each line consists of a verb
followed by arguments (values). To indicate this type of command
string, the prompt character has been made a slash. The third type of
command structure is used when the caller issues a prompt, typically a
dialogue question, and then needs to scan a particular construct. The
fourth type of command structure can be used with the above three to
read the user's profile and change the defaults. For convenience,
SCAN includes a moderate error message facility and a comprehensive
set of type-out routines.
2.0 CHANGES FROM SCN7B TO SCN7D
573 SPR #10-18959
Restore .RBPPN after indirect file lookup for SFD's.
574
Make .CNVDT routines round time instead of truncating.
SCN7D.DOC Page 3
575 SPR #10-19065
Since /XYZ:(A , B ) is legal, allow /XYZ:( A , B )
576 SPR #10-19852
When specifying date/times with weekdays,
allow times a full week into the future, and not more
than a full week into the past.
577 SPR #10-21716
Disallow multiple ='s on the same line (cancel edit
515), since they don't work and can't be fixed (local switches).
600 SPR # 10-21465 LCR 21-JAN-77.
Stop SCAN from resetting the starting address stored in .JBSA
when running a program from the CCL entry point. The MONITOR
no longer offsets the address at .JBSA when the offset is 0 or 1.
NOTE: C was changed to MACTEN.
areas affected: RESTRT:, E.IFL.
601 SPR # 10-21869 CLRH 17-MAR-77
Correction to edit 570 to not wipe out /BEFORE switch.
602 SPR # 10-24777
Remove a useless HALT in .QSCAN routine
603 SPR # 10-24773 WCL JUNE-27-78
Fix command scanning for SFD's; avoid use of quoting
Areas affected: FILDR3
604 SPR # 10-26448 WCL AUG-24-78
Rethink Edit 603; it broke error reporting of non-existant
SFD's if * or ? specified
Areas affected: FILDR3, .TISQT
605 GMU 09-Oct-78
If new bit FS.IFI is set in flags word of .ISCAN call,
make indirect file invocations illegal. Used by the
File Daemon.
606 SPR # 10-25056 BBE 12/16/78
Last SFD spec getting dropped with multiple level searches
with cmd line of the form DIR [A,B,C,D] E.F,G.H,I.J
607 GMU 3/3/80
Fix off-by-one bug if .TRDXW was called with a radix
greater than 10.
610 SPR # 10-29905 RKB 8/19/80
Allow null SFD specs to be filled in with PATH. UUO
change "?Null SFD illegal" to "?Null SFD beyond depth of PATH"
currently under an off conditional, not supported.
611
Change version scheme to allow customer edits greater than 3.
SCN7D.DOC Page 4
612 PY 17-Mar-81
Remove the FS.NCM flag from /MESSAGE, /OPTION, and /NOOPTION
613 TARL 30-May-81
Add entry point .TOFEB to perform same function as .TOLEB, but
using a pointer to a FILOP block.
614 SPR # 10-31175 PY 29-Jun-81
Fix problem with [-] if edit 610 is installed.
615 SPR # 10-30948 PY 29-Jul-81
Remove the SCNNFT and SCNNPS errors. If a future date
is requested and the date typed is really in the past
or vice versa, allow the date as there are many cases
where it is useful to do so.
616 SPR # 10-31381 PY 5-Aug-81
Fix TYIIGC to keep B.INDC accurately as the number of
characters. This fixes an off by one bug with TMPCOR
files which lose the last character if they end on a
word boundary.
617 PY 7-Aug-81
Fix sequence numbers and page marks in indirect files to
work even if they span a block.
620 SPR # 10-31399 PY 18-Aug-81
Fix bug in edit 610 which affects five deep SFDs and
/BEFORE or /SINCE.
621 PY 18-Aug-81
Search UUOSYM, MACTEN instead of C. Update compilation
instructions.
622 PY 19-Aug-81
If CCL, check the left half of the name if the right half
is zero. This prevents COMPIL class commands from getting
lost if TMP is assigned or a path.
623 PY 20-Aug-81
When using a byte pointer for a switch, check for
exact match with the value instead of the mask.
624 PY 24-Sep-81
Fix edit 623 so that switches with multi-word byte
pointers are compared properly.
625 PY 19-Oct-81
Once more with multi-word byte pointers. Either zero
or minus one is acceptable to indicate that a switch
has not been seen. Seperate out the multi-word tests
so the code is shorter and less complex.
SCN7D.DOC Page 5
626 PY 24-Nov-81
With edit 622 installed, the TMPCOR file name may be
in the left half of .RBPPN instead of the right half.
Check for this case when deleting the TMPCOR file.
627 PY 27-Dec-81
Add the global symbol .OPTN, same value as local symbol
OPTION.
630 PY 28-Dec-81
Fix bug when printing out numbers in .TRDXW with a radix
greater than ten.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
To install in any program, relink that program using the new SCAN.REL
All programs which are to use SCAN version 7D should be checked to
insure that they request SCAN, and not a specific version of SCAN,
such as SCN7B.
Note that although there are several programs which use SCAN and WILD,
we will not necessarily rebuild all of them when SCAN is released. If
the customer experiences a problem with a program which is fixed by
the new versions of SCAN and WILD, he may rebuild the product at his
discretion.
5.0 SUGGESTIONS
Allow use of an extended channel to be used instead of time-sharing
channel 0.
Allow long file names on TOPS-20 in a format acceptable to the COMPT.
UUO.
Permit SCAN to run or be called from extended sections.
Add a HELP command, similar to HELP:SWITCHES which will describe the
keywords and/or arguments to the switches.
Support PATH names.
Allow nested indirect files.
[SCN7B.DOC is appended as an integral part of SCN7D.DOC]
SCN7B.DOC Page 6
SCAN.DOC -- CHANGES FROM V7A TO V7B(572)
JUNE 1975
1.0 SUMMARY
This is a maintenance release of SCAN necessary to correct command
scanning errors in LINK-10 and to support BACKUP. Corrections were
selected based upon the dual requirements of having high value and low
risk, however, it is recommended that this version NOT be used to
build other programs. There are no functional changes from version
7A. This fixes all SPRs received through 10-16,159 (June, 1975).
SCAN version 7B runs on all monitors. It has been tested on
5.10/6.02. SCAN version 7B depends on WILD version 7 or later. There
are no known deficiencies. This version fully supports the DATE75
project.
SCAN version 7B is documented implicitly in the software notebook
description of DIRECT and DUMP. Supporting documentation can be found
in the .DOC files for WILD version 7 and DIRECT version 4.
1.1 Function of SCAN
SCAN is designed to be used as a subroutine by programs needing a
command scanner. It supports four basic types of commands. One is
the traditional form of output device(s) = input device(s). In this
case, options are controlled by switches preceded by a slash. The
switches are an abbreviated word. Values for the switch are indicated
by following the switch name by a colon and the value. The second
type of command structure is that each line consists of a verb
followed by arguments (values). To indicate this type of command
string, the prompt character has been made a slash. The third type of
command structure is used when the caller issues a prompt, typically a
dialogue question, and then needs to scan a particular construct. The
fourth type of command structure can be used with the above three to
read the user's profile and change the defaults. For convenience,
SCAN includes a moderate error message facility and a comprehensive
set of type-out routines.
2.0 CHANGES FROM SCN7A TO SCN7B
555 Call FILSTK in .OSCAN to memorize SWITCH.INI defaults.
556 Set verb mode flag FLVERB in .VSCAN before calling SETPR4.
557 Store first value for /LENGTH in P.XXX area.
560 if UFD appears as -1, typeout as [*,*].
SCN7B.DOC Page 7
561 Prevent OSCAN from copying remaining sticky switches to all files
in T-mode.
562 (10-15,267) Edit 515 fails at monitor level.
563 (10,16,159) PSCAN sometimes types too any prompts.
564 Use 6.02 table if available to get login time.
565 (10-15,694) Correct use of .PTMAX.
566 Allow spaces after comma on multiple values for switches
567 Add TENEX feature test code
570 Correct length of BLT transfer in FILSTK so date swithces will
not get clobbered when a directory is typed.
571 Don't defeat ^O before dispatching to user prompt routine. Let
user routine do it itself if needed.
572 Make .TYPRE (preemptive input ) work reasonably. Basically,
ignore /RUN and CCL or command mode if preemptive input. (So
preemptive call to .TSCAN won't exit or do a run.)
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
With version 7, the dummy low-segment file SCANDM 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 SCANDM should be changed to SCAN/ONLY:LOW.
Note that although there are several programs which use SCAN and WILD,
we will not necessarily rebuild all of them when SCAN 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 SCAN and WILD do not
warrent the cost of rebuilding and testing. Software products are
supported only with the version of SCAN and WILD with which they have
been released, because they have not been tested with other versions.
SCN7B.DOC Page 8
5.0 SUGGESTIONS
Allow indirect files to nest. This would make their behavior be more
like COMPIL. This would also allow the option file to be used while
using @ files.
Implement iteration loops with ().
Implement the pattern "x 'TO' y" in TSCAN.
Implement 'LIST' and 'OBJECT'.
Make SCAN (and perhaps WILD) be a separate segment which can be
GETSEGged when needed.
Add a routine which can input a SIXBIT symbol name (i.e., allowing % $
and .).
SPR 10S-031) Add a standard switch to specify the number of lines per
page.
Add a routine like .SWMAX which would verify that the result is in a
specified range (.SWMAX only allows the range 0-max).
Add a routine to issue system-wide standard messages, such as FNF FILE
NOT FOUND.
Add an option to .OSCAN to allow the caller to specify a secondary key
(or list of secondary keys) and allow .OSCAN to match these against
ranges in the SWITCH.INI file. This could allow a program such as
LOGIN to select a different line depending upon which terminal the
user was using.
QAR 1975) Add an option to the /MESSAGE switch to suppress the
constant text portions and just output the parameters.
Change .OSCAN so that it will not look for SWITCH.INI on LIB:.
SPR 10-13457) Allow the caller to optionally specify a permanent
channel to use for indirect files so that channel 0 does not have to
be time-shared.
Change the setting of FT$UEQ to remove "_".
Have "?" not match null characters.
Implement some form of dialogue mode.
Remove the current use of space as a separator within a file
specification. Remove the old defaulting mechanism triggered by the
file name.
[End of SCN7B.DOC]
[SCN7A.DOC is appended as an integral part of SCN7B.DOC]
SCN7A.DOC Page 9
SCAN.DOC -- Changes from V7 to V7A
March 1975
1.0 SUMMARY
This is a maintenance release of SCAN necessary to correct command
scanning errors in LINK-10 and to support BACKUP. Corrections were
selected based upon the dual requirements of having high value and low
risk, however, it is recommended that this version NOT be used to
build other programs. There are no functional changes from version 7.
This fixes all SPRs received through 10-15,266 (February, 1975).
SCAN version 7A runs on all monitors. It has been tested on
5.07/6.01. SCAN version 7A depends on WILD version 7 or later. There
are no known deficiencies. This version fully supports the DATE75
project.
SCAN version 7A is documented implicitly in the software notebook
description of DIRECT and DUMP. Supporting documentation can be found
in the .DOC files for WILD version 7 and DIRECT version 4.
1.1 Function of SCAN
SCAN is designed to be used as a subroutine by programs needing a
command scanner. It supports four basic types of commands. One is
the traditional form of output device(s) = input device(s). In this
case, options are controlled by switches preceded by a slash. The
switches are an abbreviated word. Values for the switch are indicated
by following the switch name by a colon and the value. The second
type of command structure is that each line consists of a verb
followed by arguments (values). To indicate this type of command
string, the prompt character has been made a slash. The third type of
command structure is used when the caller issues a prompt, typically a
dialogue question, and then needs to scan a particular construct. The
fourth type of command structure can be used with the above three to
read the user's profile and change the defaults. For convenience,
SCAN includes a moderate error message facility and a comprehensive
set of type-out routines.
2.0 CHANGES
542 (SPR 10-15001) Detect illegal date-time formats before defaults
are filled in. Thus, the phrase "following word" will be more
understandable to the user.
543 (SPR 10-15,266) When handling a parenthesis pair surrounding a
set of file specifications, delay clearing the sticky defaults
until they have been applied to the last file specification
within the parentheses.
SCN7A.DOC Page 10
544 (SPR 10-15135 on LINK) Create a new (internal) facility in SCAN
which allows the caller to preempt the current input source, and
force all characters for editing to come from the user terminal.
545 Clear core at the very start of .ISCAN instead of on the second
page.
546 Define the global symbol "%%%SCN" which is the current major
version number.
547 Correct a bug introduced by edit 357. In verb mode, allow file
switches to appear as verbs whether or not they have values.
550 If the caller of .TSCAN declares both multiple outputs and that
inputs and outputs can be mixed, then do not require a =. This
is needed for proper functioning of LINK.
551 In verb mode, at end of each line, clear any sticky devices, etc.
Only sticky switches are kept across lines.
552 Corect a bug in edit 551. Clear non-switch flags in P.MOD and
P.MODM between lines.
553 Make .CLSNS routine internal.
554 Clear negative flag before reading a UFD.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
With version 7, the dummy low-segment file SCANDM 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 SCANDM should be changed to SCAN/ONLY:LOW.
Note that although there are several programs which use SCAN and WILD,
we will not necessarily rebuild all of them when SCAN 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 SCAN and WILD do not
warrent the cost of rebuilding and testing. Software products are
supported only with the version of SCAN and WILD with which they have
been released, because they have not been tested with other versions.
SCN7A.DOC Page 11
5.0 SUGGESTIONS
Allow indirect files to nest. This would make their behavior be more
like COMPIL. This would also allow the option file to be used while
using @ files.
Implement iteration loops with ().
Implement the pattern "x 'TO' y" in TSCAN.
Implement 'LIST' and 'OBJECT'.
Make SCAN (and perhaps WILD) be a separate segment which can be
GETSEGged when needed.
Add a routine which can input a SIXBIT symbol name (i.e., allowing % $
and .).
SPR 10S-031) Add a standard switch to specify the number of lines per
page.
Add a routine like .SWMAX which would verify that the result is in a
specified range (.SWMAX only allows the range 0-max).
Add a routine to issue system-wide standard messages, such as FNF FILE
NOT FOUND.
Add an option to .OSCAN to allow the caller to specify a secondary key
(or list of secondary keys) and allow .OSCAN to match these against
ranges in the SWITCH.INI file. This could allow a program such as
LOGIN to select a different line depending upon which terminal the
user was using.
QAR 1975) Add an option to the /MESSAGE switch to suppress the
constant text portions and just output the parameters.
Change .OSCAN so that it will not look for SWITCH.INI on LIB:.
SPR 10-13457) Allow the caller to optionally specify a permanent
channel to use for indirect files so that channel 0 does not have to
be time-shared.
Change the setting of FT$UEQ to remove "_".
Have "?" not match null characters.
Implement some form of dialogue mode.
Remove the current use of space as a separator within a file
specification. Remove the old defaulting mechanism triggered by the
file name.
[End of SCN7A.DOC]
[SCN7.DOC is appended as an integral part of SCN7A.DOC]
SCN7.DOC Page 12
SCAN.DOC -- Changes from V6 to V7
September 1974
1.0 SUMMARY
This release adds the concept of guide words which allow the language
to be somewhat more general and mnemonic. Together with changes to
WILD, this release generalizes the wild-card matching so the user can
or and and specifications to match. The user can also exclude certain
patterns of files from the match. This release also lays more
groundwork to evolve SCAN to agree with the proposed DEC standard
command language. This fixes all SPRs received through 10-13,999
(September, 1974).
SCAN version 7 runs on all monitors. It has been tested on 5.07/6.01.
SCAN version 7 depends on WILD version 7 or later. There are no known
deficiencies. This version fully supports the DATE75 project.
SCAN version 7 is documented implicitly in the software notebook
description of DIRECT and DUMP. Supporting documentation can be found
in the .DOC files for WILD version 7 and DIRECT version 4.
1.1 Function of SCAN
SCAN is designed to be used as a subroutine by programs needing a
command scanner. It supports four basic types of commands. One is
the traditional form of output device(s) = input device(s). In this
case, options are controlled by switches preceded by a slash. The
switches are an abbreviated word. Values for the switch are indicated
by following the switch name by a colon and the value. The second
type of command structure is that each line consists of a verb
followed by arguments (values). To indicate this type of command
string, the prompt character has been made a slash. The third type of
command structure is used when the caller issues a prompt, typically a
dialogue question, and then needs to scan a particular construct. The
fourth type of command structure can be used with the above three to
read the user's profile and change the defaults. For convenience,
SCAN includes a moderate error message facility and a comprehensive
set of type-out routines.
2.0 CHANGES
401 (QAR 2424) Fix edit 365 so that the DIRECT and QUEUE commands
with no arguments work correctly.
402 (SPR 10-13,999) Same fix as edit 530.
501 (SPR 10-13597) Make .TSTRG reentrant so it can be used
recursively.
SCN7.DOC Page 13
502 (QAR 2384) Let @ work to DECtapes.
503 Allow the user to specify /MESSAGE:(ALL,NOxx) to mean all except
xx. Similarly, allow the user to specify /MESSAGE:(NONE,xx) to
mean only xx. This syntax works for all bit-valued switches.
504 (QAR 2439) Allow /RUN to be specified on a monitor command line
and have it work correctly.
505 Add :LOGIN as a mnemonic date-time to mean the time this user
last logged in. For example, /SINCE:LOGIN would refer to all
those files since the last LOGIN. Note that if there are several
jobs logged in under a particular ppn, then this will be the last
one to have logged in.
506 Add standard switch /EXIT which works just like /RUN except that
the program will exit to the monitor when all work is done.
507 Add the concept of guide words as defined in the proposed DEC
standard command language. These are standard mnemonic words
which are always enclosed within asingle quotes. Internally,
they are treated as a single meta-character. Edits 510 and 523
start to define actual guide words.
510 Add three file specification separators as guide words. These
may be used to combine several file specifications into one
concatenated file specification. It is the concatenated file
specification which actually is used by WILD to match against a
file. The separator 'AND' means that the conditions on both
sides of the separator must both be met for the file to match.
The separator 'OR' means that either condition may be met in
order to match. The separator 'NOT' means that the condition to
the left must me met and that the condition to the right can not
be met for the file to match. 'AND' and 'NOT' are of the same
precedence and are evaluated before 'OR' is. This follows the
normal Boolean precedence rules. Note that the standard file
constraint switches such as /SINCE are part of the analysis of
whether a file matches a particular specification. Note that in
DIRECT and QUEUE, "+" had the meaning of 'OR'. This is still
true in version 7 of WILD but will be changed in version 10. All
existing files which depend on this should be converted to use
'OR' before that release. Note that most programs will not care
about the difference, nor will most users.
511 Lay the groundwork to remove "_" as a separator which means the
same thing that "=" does. The code to remove it is under the
conditional FT$UEQ. In a future release the conditional will be
changed to remove "_".
512 Allow "*" to be used at the end of a file name, etc.. This means
the same as specifying enough "?" to fill out the field. For
now, the meaning of "?" will be left the same, but in the future
"?" will be changed to not match null. Therefore, all cases
where null should validly be matched should be changed to use "*"
instead (it is also easier to type).
SCN7.DOC Page 14
513 Add routine .OSDFS to apply the SWITCH.INI (.OSCAN) defaults to a
file specification itself. By calling this for each file
specification, calling programs can allow all file specification
switches to be supplied from SWITCH.INI.
514 Allow everything except partial file specifications to appear
before the "@". Anything so specified will be concatenated onto
the first line of the indirect file. Similarly, allow the
indirect file specification to be followed by other commands.
Anything so specified will be processed after the last line of
the indirect file. These changes allow the DIRECT and QUEUE
monitor commands to have a syntax much closer to that of the
COMPILE-class commands.
515 (QAR 1975) Allow several equal signs on the same command line.
When this happens, the treatment is exactly the same as if the
separator before the file specification preceeding all but the
first equal sign on a line was end-of-line.
516 Don't set the default DSK: if only global switches were
specified. This requires that the global switches be flagged
with FS.NFS in the SWTCHS macro.
517 Remove the vestiges of dialogue mode since it violates the proper
use of escape and was never implemented. Leave as a research
project determining the best way to implement a dialogue mode.
520 Add mnemonic date-times of NOON and MIDNIGHT. NOON always refers
to noon of today; MIDNIGHT refers to 00:00 or 24:00 depending on
whether the switch takes past or future values. Thus, for
example, "/SINCE:MIDNIGHT" refers to last midnight and
"/AFTER:MIDNIGHT" refers to midnight tonight.
521 (SPR 10-13,836) Improve the .SAVEn routines to save six locations
and to store the flags on the stack without increasing the
execution time.
522 In order to conform with the proposed DEC standard command
language, accept "%" as a prefix for a component of a file
specification known as an attribute. Since TOPS-10 has no such
concept currently, ignore any such field.
523 Add the additional guide words of 'TO', 'FROM', 'INPUT',
'OUTPUT', 'SOURCE', 'LIST', and 'OBJECT'. These are defined by
the proposed DEC standard command language to preceed the file
specifications of the appropriate meaning. Within the current
algorithms in SCAN only 'FROM', 'INPUT', and 'SOURCE' are
meaningful, and these are only useable as synonyms for "=".
Thus, it is now possible for the user to say ".COPY x 'FROM' y",
but it is not yet possible for him to say ".COPY y 'TO' x".
524 Remove a possible HALT after errors within an indirect file.
525 (SPR 10-13,818) Remove a minor piece of internal confusion on the
prompting logic.
SCN7.DOC Page 15
526 (SPR 10-13,818) Remove an internal flag which was redundant.
527 (SPR 10-13,817) Do not suppress the leading spaces at the start
of a continuation line.
530 (SPR 10-13,999) Fix a bug introduced in version 5 which did not
allow a monitor command to be continued.
531 Allow or-bit value switches to take a default. In particular,
default /MESSAGE occuring without any values to be
:(PREFIX,FIRST,CONTINUATION).
532 Add a new switch, /TMPFIL. This switch takes a pair of values in
the form /TMPFILE:name:string. The string is stored in the
TMPCOR or .TMP file named in the command. The .TMP file name is
prefixed with the job's number to follow the CCL conventions.
This can be used to setup one or more CCL files prior to a /RUN.
This would typically be done in a SWITCH.INI or indirect file.
533 (SPR 10-13,943) In programs which take multiple output
specifications such as FORTRAN-10, detect as an error the absence
of an "=" in the command line. The message is "?SCNESM EQUAL
SIGN MISSING".
534 In order to move closer to the proposed DEC standard command
language, introduce the notation of parentheses to indicate the
scope of user specified defaults. In particular, any components
of a file spec typed just before the left parenthesis become
defaults for those specs within the parentheses. For example,
typeing "X:FOO(.A,.B)" stands for "X:FOO.A,X:FOO.B". In the next
version of SCAN, the old practice of components of a spec typed
before the file name becoming defaults will be removed. Thus,
and .CTL and .CCL files should be modified to the new notation.
This new notation also removes the need to allow spaces within a
file spec; so these should also be removed since a future
version of SCAN may disallow spaces within the spec. Spaces
adjacent to other separators such as "=" and "," will still be
legal.
535 Allow several indirect files to be specified on the same command
line. Thus, for example, ".DIRECT@A,@B" will now work as
expected.
536 Add additional density values of 1600 and 6250 to agree with the
assignments in the 5.07 and 6.02 MTCHR. UUO.
537 In the new routine .OSDFS, do not default anything except
switches.
540 Correct bug in edit 535.
541 Don't recognize quide words within a quoted string.
SCN7.DOC Page 16
2.1 SCNMAC Changes
101 Add guide words as characters 4000-4002.
102 Clarify the meaning of FS.NFS to indicate that the switch has
global reference, rather than being part of a file specification.
Add the flag FS.NCM which is to be used internally within SCAN to
indicate that a particular switch does not constitute a command.
103 Add guide word characters 4003-4011.
104 Remove the ASK macro which was never implemented.
105 Expand FX.DEN to three bits to match the MTCHR. UUO. This
requires moving it left in the word.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
The dummy low-segment file SCANDM 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 SCANDM
should be changed to SCAN/ONLY:LOW.
Note that although there are several programs which use SCAN and WILD,
we will not necessarily rebuild all of them when SCAN 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 SCAN and WILD do not
warrent the cost of rebuilding and testing.
Do not reload Queue with this version of SCAN as there is an obscure
bug awhich will not let Queue automatically print out a log file at
KJOB Time.
Also, do not reload CREDIR with this version of SCAN, because
reloading gives inconsistent symbol definitions.
Other CUSP's dependent on SCAN have been reloaded and are included on
the October Monitor Tape.
SCN7.DOC Page 17
5.0 SUGGESTIONS
Allow indirect files to nest. This would make their behavior be more
like COMPIL. This would also allow the option file to be used while
using @ files.
Implement iteration loops with ().
Implement the pattern "x 'TO' y" in TSCAN.
Implement 'LIST' and 'OBJECT'.
Make SCAN (and perhaps WILD) be a separate segment which can be
GETSEGged when needed.
Add a routine which can input a SIXBIT symbol name (i.e., allowing % $
and .).
SPR 10S-031) Add a standard switch to specify the number of lines per
page.
Add a routine like .SWMAX which would verify that the result is in a
specified range (.SWMAX only allows the range 0-max).
Add a routine to issue system-wide standard messages, such as FNF FILE
NOT FOUND.
Add an option to .OSCAN to allow the caller to specify a secondary key
(or list of secondary keys) and allow .OSCAN to match these against
ranges in the SWITCH.INI file. This could allow a program such as
LOGIN to select a different line depending upon which terminal the
user was using.
QAR 1975) Add an option to the /MESSAGE switch to suppress the
constant text portions and just output the parameters.
Change .OSCAN so that it will not look for SWITCH.INI on LIB:.
SPR 10-13457) Allow the caller to optionally specify a permanent
channel to use for indirect files so that channel 0 does not have to
be time-shared.
Change the setting of FT$UEQ to remove "_".
Have "?" not match null characters.
Implement some form of dialogue mode.
Remove the current use of space as a separator within a file
specification. Remove the old defaulting mechanism triggered by the
file name.
[End of SCN7.DOC]
[SCN5.DOC is appended as an integral part of SCN7.DOC]
SCN5.DOC Page 18
SCAN.DOC -- Changes from V4 to V5
May 1974
1.0 SUMMARY
This release supports the error message standard and introduces the
/MESSAGE level switch. This release also adds switches to constrain
wild-carding by access date and file size. It also adds switches to
specify output file's estimated size and version number. It adds two
new types of switches, one stores bits in the value, the other takes
the prefix "NO". One CMCO and a number of bugs and deficiencies have
been fixed including all SPRs recieved through April 25, 1974
(10-13045).
SCAN version 5 runs on all monitors. It has been tested on 5.06 and
5.07/6.01. SCAN version 5 depends on WILD version 6 or later. There
are no known deficiencies. This version fully supports the DATE75
project.
SCAN version 5 is documented implicitly in the software notebook
description of DIRECT and DUMP. Supporting documentation can be found
in the .DOC files for WILD version 6 and DIRECT version 4.
1.1 Function of SCAN
SCAN is designed to be used as a subroutine by programs needing a
command scanner. It supports four basic types of commands. One is
the traditional form of output device(s) = input device(s). In this
case, options are controlled by switches preceded by a slash. The
switches are an abbreviated word. Values for the switch are indicated
by following the switch name by a colon and the value. The second
type of command structure is that each line consists of a verb
followed by arguments (values). To indicate this type of command
string, the prompt character has been made a slash. The third type of
command structure is used when the caller issues a prompt, typically a
dialogue question, and then needs to scan a particular construct. The
fourth type of command structure can be used with the above three to
read the user's profile and change the defaults. For convenience,
SCAN includes a moderate error message facility and a comprehensive
set of type-out routines.
2.0 CHANGES
276 Move .PTWRD to SCAN from WILD. Put it and .GTWRD and .MKMSK into
a separate, new module named .GTPUT. These are simple utility
routines which may be useful without all of SCAN.
277 Add a new type of switch value. This type is indicated by the
flag FS.OBV and has the property that the result is OR-ed into
the value word. The left half will end with a mask of what was
SCN5.DOC Page 19
controlled and the right half will have a 1 if the value was set.
If the value is a list of keywords, then also allow "ALL" or
"NONE" to set all bits or clear all bits. These can not be
abbreviated.
300 Add a new switch, /MESSAGE. This takes values which are or-ed
together to control the verbosity of error messages. The values
to /MESSAGE are:
PREFIX include 6-character error mnemonic
FIRST include text from first line of message
CONTIN include continuation lines of message
Each of these can be preceeded by "NO" to complement its effect.
The default setting is obtained from the monitor where it is set
by LOGIN version 55. The default typically is
/MESSAGE:(PREFIX,FIRST). Also add the location .FLVRB which
contains the setting from the /MESSAGE switch. Add routine
.VERBO which returns in AC1 right adjusted the bits from /MESSAGE
after defaults have been applied.
301 Modify the routine .CLRFL to take an argument which suppresses
clearing switches. This solves a problem when scanning a switch
which takes a file as an argument.
302 Add a new option bit to .TSCAN which allows input and output
specifications to be mixed. This is useful for programs which
may need input files on the left of = or output files to the
right.
303 Convert all SCAN error messages to include a standard prefix as
determined by /MESSAGE.
304 Allow a device to preceed the command name on a rescan.
305 Add mnemonic dates of "yesterday", "today", and "tomorrow".
306 Add new type-out routine, .TVERW which types a value in the
.JBVER format.
307 Change .SAVEn routines to be reentrant, interruptable, and
slightly faster.
310 In .GTNOW routine, if the GETTAB is available, use it instead.
311 Include a slightly cleaner form of date conversion.
312 Make the symbol ".MYPPN" internal for the convenience of LOGIN.
313 Correct a number of deficiencies when .PSCANing including the
handling of ^Z and RUN xyz (...).
314 Improve messages which include "following word" to always give
the right format.
SCN5.DOC Page 20
315 Add a new typeout routine, .TDTYM, which types a word in internal
"universal" date/time format.
316 Add a new switch macro, "SN", which takes value one unless the
word is prefixed by "NO", in which case the value is 0. With
this macro, the user can also give the switch name with value 0
or "NO" to indicate "not the switch" (same as /NOswitch) or 1 or
"YES" to indicate the switch (same as /switch). The NO or YES
can be abbreviated.
317 (SPR 10-12400) Don't allow /RUN when not logged in.
320 Fix the handling of the indirect file on non-directory devices to
handle multiple buffers.
321 Add a further option to /MESSAGE, namely :ADDRESS, which will
cause SCAN's error printer to include the address of the error
message routine for debugging convenience.
322 Extend edit 313 to handle multiple .PSCAN calls correctly.
323 Correct edit 312.
324 (SPR 10-12439) Avoid error messages if the CCL file is missing.
If the cause is missing directory, etc., the message will be
suppressed.
325 Allow duplicate switches with the same value without giving an
error message.
326 (SPR 10-12416) Correctly diagnose time values with the hours
greater than or equal to 24 as an error.
327 Add an entry point, .QSCAN, which is to be used when .PSCANing
for all but the main question. It doesn't initialize quite as
strongly.
330 (SPR 10-12,344) Improve the error message when there is junk
after the indirect file spec in an indirect specification.
331 Detect the case that /BEFORE and /SINCE don't overlap with the
result that nothing could ever match. Issue a new message for
this case.
332 Create routine .STOPB which is like .STOPN but has the path block
as an argument. This is in a separate module to allow it to be
loaded in separate segments from SCAN.
333 Add a new routine .ERMSG which will issue the prefix and initial
text of an error message.
334 Change ".SCNDC" to "$SCNDC".
335 More of edit 327.
SCN5.DOC Page 21
336 Add routine to type out a value which is a core size. It
verifies that the value is an exact number of pages or K
(depending upon processor type) and then outputs it with a P or K
suffix. If the number is not exact, it is output as words with a
W suffix. The core-size input routine has been expanded to allow
W as a suffix to mean words. Similarly, it will also allow a
suffix of B to mean blocks (128-words).
337 Add routines .BLOKW/C and .TBLOK to input and output units of
file size. On input, the same suffixes that can be used for core
input are valid (W, B, P, or K), with the value defaulting to
blocks if no suffix is specified. The output routine will type
the number as blocks with a B suffix if exact; otherwise, it
will type it as words with a W suffix.
340 Add routine .TOLEB to type out a file specification in
OPEN/LOOKUP format.
341 More of edit 277.
342 More of edit 316.
343 To aid the users, make a compatible change to invoke switch
processors with a PUSHJ. If the processor wants the value
range-checked, it still must call .SWMAX. Otherwise, it can
non-skip return to store the value (same as calling .SWDPB) or
skip-return to not store (same as .SWDON).
a344 Add option to .OSCAN to supply a list of the primary option file
keys. Thus, for example, QUEUE could specify both QUEUE and
PRINT on a .PRINT command so the user can specify different
defaults for different commands.
345 To correctly support edit 344, read and process all lines of the
SWITCH.INI file. Previously, the first matching line terminated
the processing. Now, every matching line will be processed.
This is consistent with the handling of other .INI files in the
system.
346 Add several new switches and associated error messages. /ABEFORE
and /ASINCE are exactly like /BEFORE and /SINCE except that they
constrain the access date rather than the creation date. /LENGTH
takes two file sizes separated by a colon to constrain the file
size. The first size is the minimum file length which will
match, and the second is the maximum. If the first is omitted, 0
is the lower limit; if the second is omitted together with its
preceeding colon, then +infinity is the upper limit. If the
minimum is greater than the maximum, SCAN will issue the message
SCNLVI to indicate that the lengths are inconsistent.
There are also three new output switches: /ERSUPERSEDE,
/VERSION, and /ESTIMATE. /ESTIMATE specifies the estimated file
size, and /VERSION specifies the file version (contents of
.RBVER). The /VERSION switch uses a new input routine, .VERSW,
which accepts a standard version pattern as input. /ERSUPERSEDE
SCN5.DOC Page 22
works only on 5.07/6.01 and later monitors and will result in an
error if the file already exists (would be superseded).
347 Compute the logged in status dynamically for LOGIN. There is a
new routine, .ISLOG, which does this.
350 Fix a deficiency which did not handle end of file at the end of
an indirect specification correctly.
351 (SPR 10-13,045) Correct a bug which happened if DEBUG=0.
352 (QAR 1975) Fix bug in edit 316.
353 (QAR 1975) Allow .VSCAN to use .OSCAN at startup time.
354 (QAR 1975) Clear ^O on the first fatal error message.
355 (QAR 1975) Define a sub-module, .TNEWL, which is called from the
error message module. It will force the output to the beginning
of the line. The routine supplied in SCAN currently just calls
.TCRLF. If the user has supplied his own routine, then load SCAN
in /SEARCH mode to eliminate this one.
356 Define two error message entry points. E.DSI issues the message
that double switch is illegal. If the option file is being
processed, then it does not issue an error message. E.SVR issues
the message that switch value is required.
357 In verb mode, allow a file specification to include switches
which modify file specs. Thus, for example, the DUMP command
INPUT, which takes one file spec as its value, can include
switches such as /PHYSICAL, but not such as /RUN. The legal
switches are those commands which point to the SCAN or user
file-specific regions as defined in the call to .VSCAN. Also,
when a file-modifying switch is given as a verb, have it become
the sticky default. Remove the old hack of preceeding a verb
with "." to indicate default.
360 In verb mode, allow a command call via the RUN command. If the
program has a monitor command, or if the user invokes it with
(...) on the command, then treat any unquoted / as separating
verbs (i.e., the same as end of line). Thus, for example, DUMP
can be invoked as:
.RUN DUMP (/IN:FOO /DUMP:ALL)
to dump all of file foo.
361 More of edit 352.
2.1 SCNMAC CHANGES
71 Define FS.OBV.
SCN5.DOC Page 23
72 Define symbols of the form JWW.?? which are the values returned
by the routine .VERBO.
73 Define FS.MIO for .TSCAN calls.
74 Fix the test for maximum default to correctly allow -1.
75 Add switch type SN.
76 Add the SCAN words .FXABF, .FXASN, .FXFLI, .FXFLM, .FXEST, and
.FXVER for the switches /ABEFORE, /ASINCE, /LENGTH, /ESTIMATE,
and /VERSION. Add the byte FX.SUP for the switch /ERSUPERSEDE.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
Note that although there are several programs which use SCAN and WILD,
we will not necessarily rebuild all of them when SCAN 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 SCAN and WILD do not
warrent the cost of rebuilding and testing.
5.0 SUGGESTIONS
Allow indirect files to nest. This would make their behavior be more
like COMPIL. This would also allow the option file to be used while
using @ files.
Allow .OSCAN to handle default file switches as well as general
switches.
Implement iteration loops with ().
Implement verbal separators to allow commands such as "COPY A TO B" or
"COPY B FROM A".
Make SCAN (and perhaps WILD) be a separate segment which can be
GETSEGged when needed.
Add a routine which can input a SIXBIT symbol name (i.e., allowing % $
and .).
Add a switch which causes an exit to the monitor. This would
occasionally be useful in indirect files.
SCN5.DOC Page 24
(SPR 10S-031) Add a standard switch to specify the number of lines per
page.
Add a routine like .SWMAX which would verify that the result is in a
specified range (.SWMAX only allows the range 0-max).
Add a routine to issue system-wide standard messages, such as FNF FILE
NOT FOUND.
Add an option to .OSCAN to allow the caller to specify a secondary key
(or list of secondary keys) and allow .OSCAN to match these against
ranges in the SWITCH.INI file. This could allow a program such as
LOGIN to select a different line depending upon which terminal the
user was using.
(QAR 1975) Add an option to the /MESSAGE switch to suppress the
constant text portions and just output the parameters.
(QAR 1975) Treat the command .XXX A=B, C=D as two separate commands
(lines).
[End of SCN5.DOC]
[SCN4.DOC is appended as an integral part of SCN5.DOC]
SCN4.DOC Page 25
SCAN.DOC -- Changes from V3 to V4
November 1973
1.0 SUMMARY
This release gives the caller more control of the environment when
SCAN is running. It also add support for quoted strings and multiple
switch values. A number of bugs and deficiencies have been fixed
including all SPRs recieved through October 10, 1973 (10-11663). This
version incorporates fixes to problems found during the testing of
FORTRAN-10 and LINK-10.
SCAN version 4 runs on all monitors. It has been tested on 5.06.
SCAN version 4 depends on WILD version 4 or later. There are no known
deficiencies. This version fully supports the DATE75 project.
SCAN version 4 is documented implicitly in the software notebook
description of DIRECT and DUMP. Supporting documentation can be found
in the .DOC files for WILD version 4 and DIRECT version 3. A formal
specification for SCAN is under development.
1.1 Function of SCAN
SCAN is designed to be used as a subroutine by programs needing a
command scanner. It supports four basic types of commands. One is
the traditional form of output device(s) = input device(s). In this
case, options are controlled by switches preceded by a slash. The
switches are an abbreviated word. Values for the switch are indicated
by following the switch name by a colon and the value. The second
type of command structure is that each line consists of a verb
followed by arguments (values). To indicate this type of command
string, the prompt character has been made a slash. The third type of
command structure is used when the caller issues a prompt, typically a
dialogue question, and then needs to scan a particular construct. The
fourth type of command structure can be used with the above three to
read the user's profile and change the defaults. For convenience,
SCAN includes a moderate error message facility and a comprehensive
set of type-out routines.
2.0 CHANGES
174 Add switches /NOSTRS, /NOPHYSICAL, and /ERNONE which are the
defaults and the opposite of /STRS, /PHYSICAL, and /OKNONE.
175 Add /NOOPTION switch to suppress option file logic.
176 Fix a bug in .PSCAN which came up if the program was invoked by a
monitor command and had no arguments.
SCN4.DOC Page 26
177 Add a defensive HALT to ensure that .OSCAN is called only at end
of line.
200 (Many SPRs) Detect the user error of giving "0" as project or
programmer number.
201 Add code to clear sticky defaults on each line of .VSCAN and
.PSCAN.
202 Make two more error messages (E.INCL and E.ILSC) be declared
INTERN.
203 Correct a bug in handling of directories in switches which take a
file specification as their value.
204 Add code to pre-clear the .NMUL area on each switch.
205 Fix /HELP:SWITCHES to give a clean printout if the caller has
supplied no switches. Also, declare .SWHLP to be INTERN for
.PSCAN callers.
206 (SPR 10-9709) Add code to print wild project and programmer
numbers with "*" and "?" instead of "7".
207 (SPR 10-10004) Rework /RUN code for better consistency. In
particular, if commands appear on the same line as the /RUN
switch, process those commands before the switch. This then
allows the /RUN switch to appear in the option file, SWITCH.INI.
Switches which take files as arguments will now go to the
caller's exit routine if specified. N.ZER and N.EZER are now
INTERN for .PSCAN callers.
210 Correct a bug which incorrectly tested multiple word switches for
duplication.
211 Add code and a new error message to distinguish in keyword switch
values the difference between unknown values and ambiguous
values.
212 Remove tests for old style alt-modes. 175 and 176 will now be
legitimate characters. The old behaviour can be restored with
the unsupported feature test FTALT==1.
213 Set FX.NDV even if no file specification is typed.
214 (SPR 10-10123) Remove PURESW since it does not work, is
unsupported, and /H to LOADER is easier.
215 Create a dummy file SCANDM.MAC which can be loaded with other
overlays of multi-segment programs to reserve SCAN's low-seg
area. This will be updated with each release of SCAN.
216 Support FS.NFS (see SCNMAC edit 55).
217 Support FS.LRG (see SCNMAC edit 56).
SCN4.DOC Page 27
220 Change symbol U.MOUT to FS.MOT.
221 Add routines .CKNEG and .SENEG. Declare them INTERN for caller's
special numeric scan routines.
222 Implement a new routine .STOPN to convert file specifications
from SCAN format to OPEN and LOOKUP format. This routine
disallows wild-cards, but fully supports SFDs and the /DENSITY
/PARITY and /PHYSICAL switches. Use this routine for indirect
files and /RUN processing.
223 Add code to handle commands on the same line as the monitor
commands R, RUN, or START. If the program is started with one of
these and the same line has a left parenthesis, then the text
within parentheses will be the command to the program. After
finishing this command, SCAN will return to monitor command
level. Thus, for example, the user can type:
.RUN DIRECT (/F/W)
and get the same effect as running the program and giving it the
command /F/W and then typing ^C.
224 Add code to accept device TMPxxx: for indirect files. If the
device does not exist, try TMPCOR using the first three
characters of the file name. If that fails, try
DSKxxx:nnnaaa.TMP where nnn is the job number in decimal with
leading zeroes and aaa is the first three characters of the file
name.
225 Add new routines for the caller, .PSH4T and .POP4T which push and
pop the four temporary ACs.
226 Add new routines to scan a single core argument with optional K
and P suffixes (.COREW and .COREC). Add switch routine .SWCOR
for a switch which takes a core argument as its value. Add
switch /RUNCORE:core arg which sets the core size to be used in
the next /RUN switch.
227 Support FS.NUE (see SCNMAC edit 61).
230 Add new routines to handle quoted strings. .TICQT and .TISQT
will set quote mode (usually to be on a double quote (")). In
quote mode, all characters are passed literally including
multiple spaces. pairs of the quote character represent the
quote character. End of line will terminate the quote. Thus,
for example, to represent the string -- 2+3"5 -- the user would
type "2+3""5". Allow file names and extensions to be quoted.
Add routines .SIXQW and .ASCQW to read quoted strings. If the
string starts with neither quote, then it can contain only
alphabetics and numerics. Add routines .SWASQ and .SWSXQ to
handle switches with quoted string values.
231 Add routine .KLIND for LINK-10 to call on a /GO switch; it kills
off the indirect file including deleting TMP files. Call this
routine on a /RUN switch.
SCN4.DOC Page 28
232 Add multiple switch values in .TSCAN and .PSCAN modes. These are
exercized by the user typing /switch:(val1,val2,...valn). These
require the calling program to accept the values via the special
switch value exit routine.
233 Handle lower case in .TICAN.
234 Add routine .REEAT to cause the last character to be seen again
(reeaten).
235 Require that switch values end with a non-alphanumeric.
236 Add switches /OKPROTECTION and /ERPROTECTION for WILD.
237 Support FS.VRQ (SCNMAC edit 65).
240 Make all errors during .OSCAN appear as warning messages.
241 Handle .VSCAN sticky values for multiple word values except for
file verbs.
242 Change user's apply sticky routine to be called before allocating
space.
243 Add routine .CLRFL which the caller can call to clear the file
area.
244 Internal change only.
245 In .TSCAN mode, recognize @ only at start of line.
246 Add another argument to .ISCAN to allow the caller to control
(issue) all prompt characters.
247 Cancelled by edit 271.
250 Correct a bug in the date defaulter. This bug had the effect
that if the user typed /AFTER:21 at 21:10, meaning "after 2100
tomorrow", the result was actually "after 2200 today". The
correct meaning is now implemented.
251 Correct a bug in the MONRT. logic which resulted in a bug when
called from QUEUE and not logged in.
252 For the convenience of 2741 users, allow < and > as synonomous to
[ and ].
253 On an indirect file with no extension specified, if the .CCL file
is not found, try the extension .CMD before trying the null
extionsion.
254 Fix bug introduced in edit 200.
SCN4.DOC Page 29
255 (SPRs 10-11399, 10-11423) Correct a bug which kept the values of
the /BEFORE and /SINCE switches from applying to all succeeding
files when typed before the file name.
256 In the type-out routine, correctly type all 5 SFDs.
257 Handle years greater than 2000 in the date typer.
260 Fix bug introduced in edit 224.
261 (SPR 10-11663) Allow Jan-1-1964 in dates.
262 (QAR 1400) Print "." after ".KJOB".
263 Add new routine .MNRET which always returns to the monitor.
264 Change .PSCAN to never handle the /RUN switch automatically. Add
a routine .RUNCM which will handle the /RUN switch if typed and
return otherwise.
265 Modify edit 230.
266 Correct a bug in .PSCAN when called in the middle of a line.
267 (QAR 1396) When in command line mode (from a monitor command such
as ".DIRECT") if the command is continued, issue the prompt.
270 Modify edit 223.
271 Cancel edit 247.
272 Adopt "!" as an alternate comment character to agree with the
standard DEC language commenting character.
273 When scanning an octal value, allow a trailing "." to force
decimal. Ignore a trailing "." on decimal values.
274 Add a new error message when the user omits the value of a
date/time switch: "Value missing in date/time".
275 Correct a bug introduced in edit 207.
2.1 SCNMAC Changes
53 Add comments to the definitions of .FX... area to indicate under
what conditions each field is 0.
54 Add defensive PRINTXs to the SWTCHS macro.
55 Add flags concept to the switch tables. Implement FS.NFS for
switches which do not constitute a command such as /RUN.
56 Add FS.LRG to allow default and maximum values which are greater
than 2**17.
SCN4.DOC Page 30
57 Add FS.MOT definition for flags on call to .TSCAN.
60 Add definition of flags to .TDIRB call.
61 Add FS.NUE to suppress caller exit on this switch.
62 Clean up listing of first page.
63 Allow * construction in keyword values to indicate that a single
letter abbreviation is acceptable.
64 Add FX.PRT for /OKPROTECTION switch.
65 Add FS.VRQ to indicate a switch for which the value is required.
66 Remove the symbol FX.ADD which was obsoleted by edit 50 in
version 3.
67 Test bad arguments to the SWTCHS macro only during pass 2. This
eliminates some pass 1 error messages.
70 More of 67.
3.0 KNOWN BUGS AND DEFICIENCIES
None.
4.0 INSTALLATION INSTRUCTIONS
None.
SCN4.DOC Page 31
5.0 SUGGESTIONS
Add an output-only switch, /VERSION, which would take standard -10
format version numbers as argument. This would then be used to
specify .RBVER when the file is ENTERed.
Allow indirect files to nest. This would make their behavior be more
like COMPIL.
Allow .OSCAN to handle default file switches as well as general
switches.
Implement iteration loops with ().
Implement verbal separators to allow commands such as "COPY A TO B" or
"COPY B FROM A".
Make SCAN (and perhaps WILD) be a separate segment which can be
GETSEGged when needed.
[End of SCN4.DOC]
[SCN3.DOC is appended as an integral part of SCN4.DOC]
SCN3.DOC Page 32
SCN3.DOC -- Changes from V2 to V3
October 1972
1.0 SUMMARY
This release adds two new modes of command scanning. The first is
"PSCAN", which handles partial line scanning, such as dialogue
programs. The second is "OSCAN" which is sed during all SCANs to read
optional user defaults from a user profile file. In addition, the
/BEFORE and /SINCE switches have been added. These allow the user to
subset wild-file selection to cover only those files created before
and/or since a specific date-time. Many internal changes have been
made and all SPR's have been answered. Many internal routines have
been made available to the caller.
SCAN version 3 runs on all monitors. It has been tested on 5.04A, and
5.05. SCAN version 3 depends on WILD version 4. There are no known
deficiencies.
SCAN version 3 is documented implicitly in the software notebook
description of DIRECT and DUMP. Supporting documentation can be found
in the .DOC files for WILD version 4 and DIRECT version 3. A formal
specification for SCAN is under development.
1.1 Function of SCAN
SCAN is designed to be used as a subroutine by programs needing a
fairly complex command scanner. It supports four basic types of
commands. one is the traditional form of OUTPUT DEVICE(s) = INPUT
DEVICE(s). In this case, options are controlled by switches preceded
by a slash. The switches are an abbreviated word. Values for the
switch are indicated by following the switch name by a colon and the
value. The second type of command structure is that each line
consists of a verb followed by arguments (values). To indicate this
type of command string, the prompt character has been made a slash.
The third type of command structure is used when the caller issues a
prompt, typically a dialogue question, and then needs to scan a
particular construct. The fourth type of command structure can be
used with the above three to read the user's profile and change the
defaults. For convenience, SCAN includes a moderate error message
facility and a comprehensive set of type-out routines.
2.0 CHANGES
130 (INTERNAL) All internal statements have been removed. All
routines which seemed at all useful to the caller have been
defined with "::".
131 (SPR 10-7212) When indirect files had continuation lines,
spurious "#" were output. This is fixed.
SCN3.DOC Page 33
132 (SPR 10-7212) "@TTY:" worked for only one line. The test has
been changed to restrict only dectapes to a single block indirect
file.
133 (INTERNAL) Tab equivalence testing is now a separate routine from
the other equivalences (which are all control characters). This
allows specialized handlers, such as quoted string scanners, to
take advantage of the control equivalences. The new entry point
is .TICHT.
134 (INTERNAL) A trivial bug in .CNVDT was fixed.
135 Add the inverse routine to .CNVDT. The new routine, called
.CNTDT converts an internal format date-time word to the system
format date and MSTIME.
136 Create .PSCAN to implement SCAN for callers which need partial or
dialogue scanning. The first program to use this mode will be
LOGIN, which is currently under development. This mode requires
the caller to issue the prompt (which might be a question) and
then call the various routines to SCAN an element of the result,
such as a file spec or a sixbit name.
137 Change ALLDON to .ALDON so that calling programs can handle end
of file. (Useful primarily in PSCAN mode).
140 (INTERNAL) When a CLRBFI is issued, the SCANPC is cleared so that
blank discarding (beginning of line), etc., are reset.
141 (INTERNAL) Range tests were added to .CNVDT and .CNTDT to defend
against junk arguments consistently.
142 Add two more arguments to .ISCAN call. one is the address of a
routine to do TTY input (unless SCAN is reading from an indirect
file). The other is the address of a routine to do a MONRET
(exit if error or ^z).
143 (INTERNAL) Change all references to use .FX symbols in SCNMAC and
change the name of the run argument storage area to N.XXX.
144 Add /BEFORE and /SINCE switches. Both require arguments of
general date-time format, restricted (and defaulting) to the
past. The effect is to constrain wild-card lookups to fail
unless the selected file was created in the range of /SINCE
through /BEFORE. If either is not specified, /BEFORE defaults to
+INFINITY and /SINCE to 1-Jan-64.
SCN3.DOC Page 34
DATE-TIME is of the following general format: An optional sign
(+ or -), an optional date, and an optional time. if a sign is
specified, it indicates past or future. (Both /BEFORE and /SINCE
imply past, so + is illegal and - is ignored but accepted.) If
both date and time are present, a colon separates the two fields.
Spaces are illegal from the start of the switch through the end
of its value (as with all switches). Two basic meanings of the
argument are allowed: RELATIVE and ABSOLUTE. Relative specifies
a distance from now, absolute specifies a specific date and time.
A relative value is of the form: optional number of days
followed by a "D", required hours, optional minutes, and optional
seconds (seconds implies minutes). If days are absent, the time
must be preceeded by a "+" or "-". Subfields are separated by
colons. Thus, "-3D:4:27:21" means three days four hours twenty
seven minutes and twenty one seconds ago. Similarly, "+4" means
four hours from now.
An absolute value is of the form: optional weekday or date, and
optional time of day specification. A time of day is of the form
hour (twenty four hour clock), optional minute, and optional
second. Fields are separated by colons. Weekdays are the days
of the week or any unique abbreviation. Dates are of the form:
day of month, hyphen, mnemonic month; or mnemonic month, hyphen,
day of month; or month of year, hyphen, day of month. The month
can be abbreviated. Each of the three forms of date can be
followed by an optional year specification of the form: hyphen
followed by one, two, or four digits. Given the knowledge that a
date is in the past or future (either implicit from the switch or
specified by "+" or "-"), any unspecified subfields are filled in
so that the result is the "next or last occurance of the
specified date". In this case, if the time is omitted, it means
00:00:00 if past or 23:59:59 if future. Thus, for example:
/AFTER:SAT After 23:59:59 Next Saturday
/DATE:-WED Date of 00:00:00 Last Wednesday
/SINCE:JUL-3-70:12 Since 3-July-1970 at Noon.
/BEFORE:25-FEB Before Last Feb 25th.
145 Cancelled by 153.
146 Null file specifications are no longer flushed. Previously this
resulted in poor results in queue which will be cured when queue
is updated to call SCAN.
147 (INTERNAL) More of 144.
150 Add .OSCAN which handles option files. When called, OSCAN reads
file "DSK:SWITCH.INI[,]/PHYSICAL" (i.e., the user's profile)
(mnemonic for switch initialization) to find user specific
defaults. This file consists of lines of the form program name
followed by an optional colon and option name. The program name
is an argument to .OSCAN (default is from .GTPRG) and the option
name is the value of the /OPTION switch (see 151). No
abbrebviations are allowed to the program name or option name.
SCN3.DOC Page 35
The rest of the line is switches with optional values separated
by "/", ",", or " ". These switches supply defaults for switches
not specified by the user, but are ignored if the user specifies
the switch explicity. The list of switches which the user can
type need not be the same as the list from the profile file, but
usually they should be the same.
For example, if the user decided that he normally prefered /FAST
format directory listings, he could create a line in the file
named SWITCH.INI in his UFD. This line would be:
"DIRECT /fast" and all his directory listings would be in /FAST
format unless he typed /NORMAL or /SLOW (the complements of /FAST
in direct). Similarly, if the user found that the DUMP defaults
were not to his liking, he could create a line
"DUMP/IRADIX:8/ORADIX:8" and DUMP would always start off in octal
mode. He could then add a line
"DUMP:DECIMAL/IRADIX:10/ORADIX:10" and he could use the command
"/OPTION DECIMAL" to DUMP in order to switch it to decimal radix.
151 Add new switch /OPTION:OPTION-NAME to specify the default option
of this program (see 150).
152 Add entry .SWFIL to SCAN a file specification for a file switch.
153 Cancel edit 145.
154 Correct bugs in 150 when option file is missing. The lookup
error can be 0, 1, 23, or 24 to avoid an error message.
155 Add routine .TERRP which types the leading question mark and text
of error messages
156 Split SCAN into four sub-modules--.SCAN, .TOUTS, .CNTDT, and
.SAVE to handle scanning, typing, date conversion, and preserved
AC saving. There is still one source and one .REL file, but a
subset of modules can be selected by library searching SCAN.REL.
157 Create universal SCNDCL to pass parameters to the four
submodules.
160 Handle numbers in the illegal character message.
161 Update LASCHR on string input (.TIGET) to handle EOF in a string
correctly for DUMP.
162 Define .SCANZ, .SCANL, .TOUTZ, .TOUTL as start and length of low
segments for SCAN and TOUTs.
163 Clean up EXTERNs by running GLOB.SNO. All EXTERN statements have
been removed (and INTERNs) and each occurence has been replaced
with ## (and ::).
164 Give the caller exit only on the caller's switches.
165 Add .TTABC routine to type a tab, etc.
SCN3.DOC Page 36
166 Allow for partial word in last word of indirect file buffer. If
this word is incomplete, then bit 35 should not be examined to
look for sequencing.
167 Add .TTIME, .TDATE to type out date and time.
170 Make multi-word area handle worst case (30. WORDS).
171 Correct a bug in .TRDXW to handle an argument of 1B0 in the
general radix output routine.
172 Correct a bug in .NAME to correctly recognize a six-character
input name (SWITCH) when matching "*" entry (e.g., "NORMAL" in
direct).
173 Correct a bug in .FMSGX which would foul up the push-down pointer
under .TSCAN mode. This routine is called on errors and /HELP
switches.
2.1 Changes to SCNMAC.MAC
50 (INTERNAL) Add symbols for all the words and lengths in the SCAN
block. Add FX.TRM and FX.DFX for WILD. Introduce .FXTRA,
.FXTRO, .FXTRN, and .FXTRC. Obsolete FX.ADD.
51 (INTERNAL) Add FX.NDV for the /RUN processing.
52 Make SCNMAC useable as a universal file (the same techniques as
C.MAC). Define %.C==-3 to use as a universal.
3.0 KNOWN BUGS AND DEFICIENCIES
Sub file directories and the /PHYSICAL switch are not supported in run
and indirect processing.
Error routines type 777777 instead of * for WILD directories, etc.
The routine .TDIRB needs to be improved to handle the directory mask
words.
4.0 INSTALLATION INSTRUCTIONS
None.
5.0 SUGGESTIONS
Change "+" to "!" for the inclusive or function. Use "+" only for
file concatenation.
SCN3.DOC Page 37
Allow indirect files to nest. This would make their behavior be more
like COMPIL.
Implement the separator "-" to mean "EXCEPT", the way "+" means
"INCLUSIVE OR". Thus, A.*-A.B would mean all files named a except
A.B.
Implement iteration loops with <> or ().
Implement verbal separators to allow commands such as "COPY A TO B" or
"COPY B FROM A".
Implement the operator service style command SCAN. This is
essentially a verb SCAN except that the job will run when"WAITING" for
a command. This is indicated by the prompt character !.
Make SCAN (and perhaps WILD) be a separate segment which can be
GETSEGGed when needed.
Allow .OSCAN to handle default file switches as well as general
switches.
[End of SCN3.DOC]
[End of SCN7D]