Trailing-Edge
-
PDP-10 Archives
-
decuslib20-10
-
decus/20-184/2022.read_me_first
There are no other files named 2022.read_me_first in the archive.
2022 is a TOPS-20 command parser for 1022. It parses a command line and then
uses DBEXEC to to send it off to 1022 to be processed. Nearly all 1022
commands can be used in 2022 - only those command specific to TOPS-10 or those
used exclusively within PL1022 or report programs have NOT been implemented.
(Refer to the file "2022.HLP" for more information about the 2022 program.)
NOTE
Since 2022 is NOT a product of Software House the only problems you
should report to Software House are those you discover to be within the
DBEXEC or 1022M.EXE interface. All other problems with 2022 should be
reported to the following address. If you have a solution please send
that along as well. We will do our best to quickly get the problem
fixed and have an updated version available through DECUS.
Strathcona County
2001 Sherwood Drive
Sherwood Park Attn: Dave Wodelet
Alberta, Canada (403)464-8282
T8A 3W7
You can order 2022 by calling the DECUS order department at (617)480-3419. The
cost is $45.00 for DECUS members and $49.00 for non-members. Shipment and
handling is $2.00. The tape you receive should contain the following files:
2022.BWR
.HLP
.MAC
.READ_ME_FIRST
.REL_116B
.REL_117A
.REL_117B
.RNH
.USER_CONF
MLIB.0
.CMD
.MAC
.REL
.UNV
FILCMP.EXE
.MAC
.RNH
PHOTO.EXE
.MAC
.RNH
2022.BWR -a list of known but currently unfixed problems with 2022.
Most of these are with the 1022 DBEXEC interface which 2022
makes heavy use of.
2022.HLP -the on-line help file used by 2022.EXE. This file must be
Page 2
copied to a directory on the HLP: logical search chain.
2022.MAC -source file for 2022. To assemble this file please read
the instructions at the beginning of the file.
2022.READ_ME_FIRST -contains information about installing 2022 on your system.
2022.REL_* -the RELocatable files for different versions of 1022. They
were produced from the 2022.MAC on this tape by using
different assembly time switches. They are provided for
your convenience but, if you desire, you may recreate these
REL files by following the instructions given at the
beginning of 2022.MAC. Here is an example of how to create
2022.EXE from one of the supplied REL files:
@RENAME 2022.REL_117B (TO) 2022.REL
@LOAD 2022.REL
@SAVE <usually-in-same-area-as-1022.EXE>
For the LOAD to work you must insure that MLIB.REL
(supplied on this tape) can be found on DSK: and that the
correct version of HR1022.REL and HL1022.REL (supplied with
1022 from Software House) can be found on SYS:.
2022.RNH -RUNOFF source file for producing 2022.HLP
2022.USER_CONF -Notes from the 2022 session given at the 1986 1022/1032
Users Conference.
MLIB.0 -used by MLIB.CMD to produce MLIB.UNV
MLIB.CMD -assembles MLIB.MAC to produce MLIB.REL and MLIB.UNV
MLIB.MAC -source file for MLIB.REL and MLIB.UNV
MLIB.REL -contains subroutines used by 2022
MLIB.UNV -contains definitions required to assemble 2022.MAC
The following programs are NOT required to run 2022. They are some other
programs developed at Strathcona County that we think other sites may find
useful as well.
FILCMP.MAC -A file compare program similar to Digital's FILCOM however
it differs in that FILCMP is a native TOPS-20 program using
the COMND% jsys to parse command and the extended
instruction set to do the compare. Consequently it's about
8 to 10 times faster than Digital's FILCOM. FILCMP also
has the ability to use the output from the COMPARE command
to update another file - which is useful for re-adding
local patches to new versions of software.
PHOTO.MAC -An enhanced version of the popular PHOTO program. This
rewrite has given PHOTO much more functionality. For
Page 3
example it has a REPLAY command that allow a photo session
to be "replayed" a various speeds with all escape sequences
acted on instead of being translated to printable ascii
characters.
Before assembling 2022 you must insure that the following files are located on
the proper devices:
MLIB.REL, MLIB.UNV -must be found on DSK:
MONSYM.UNV, MACSYM.UNV -must be found on SYS:
HR1022.REL, HL1022.REL -must be found on SYS:
HL1022.REL is required only for the MC.CET routine to handle ^E interrupts.
Since MC.CET may not be available in pre-116 version of HL1022 don't worry if
LINK can't find it since 2022 will still run without it.
Once your logical names are set up properly you can assemble 2022 for the
latest version of 1022 it supports with the following commands:
@LOAD/COMP 2022.MAC
@SAVE <usually-in-same-directory-as-1022.EXE>
To assemble 2022 for a different version of 1022 other than the latest use the
following commands. This example shows how to assemble 2022 for version 116B
of 1022:
@COPY TTY: 2022.16B
VMAJOR==116
VMINOR==2 ;"A"=1, "B"=2, etc...
^Z
@LOAD/COMP 2022.16B+2022.MAC
@SAVE <usually-in-the-same-directory-as-1022.EXE>
2022 has only been tested with 1022 versions 116B and up. 2022 will probably
still LINK and run with earlier versions but earlier versions may not have the
MC.CET ^E support routine in HL1022.REL. Also any 1022 commands that were new
to 116B will still show up in the "?" help feature even though they are invalid
for the earlier versions.
You are free to distribute 2022 to other sites as long as you distribute it in
its complete form - just as you should have received it. Nothing is worse than
getting an incomplete copy that won't run or you can't reassemble for one
reason or another. Any patches that you have made to 2022 should be
distributed as separate files or save-sets on the tape. You may wish to use
the FILCMP program to extract your local changes to 2022:
@FILCMP
FILCMP>COMPARE 2022.MAC 2022.MAC_NEW 2022.CHANGES/UPDATE
Now if another site wants to incorporate your changes into the original version
of 2022.MAC all they need to do is:
Page 4
@FILCMP
FILCMP>UPDATE 2022.MAC (using changes in) 2022.CHANGES