Google
 

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