Google
 

Trailing-Edge - PDP-10 Archives - bb-d868e-bm_tops20_v41_2020_dist_1of2 - 4-1-documentation/macro.doc
There are 25 other files named macro.doc in the archive. Click here to see a list.


MACRO.DOC -- Changes from V53(1020) to V53A(1152)
August 1979






























COPYRIGHT (C) 1976,1979 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.
MCR53A.DOC                                                      Page 2


MACRO.DOC -- Changes from V53(1020) to V53A(1152)
August 1979



1.0  SUMMARY

The purpose of this release is to provide a more reliable  version  of
the product.

MACRO version 53A is supported by Digital Equipment  Corporation,  and
runs  on  all  supported  monitors  as  released.   Version  53A fully
supersedes all previous versions, and includes edits up to #1152.

MACRO 53A requires that if PSECTS are used, the resultant  .REL  files
be  loaded  with  LINK  V4  or later versions, which support the PSECT
facility.

For TOPS-10 systems, MACRO is documented in  the  DECsystem-10  User's
Guide, and in the DECsystem-10 MACRO Assembler Reference Manual, order
number AA-C780C-TB.

For TOPS-20 systems, MACRO is documented in the TOPS-20 User's  Guide,
and in the DECSYSTEM-20 MACRO Assembler Reference Manual, order number
AA-4159C-TM.



2.0  EXTERNAL CHANGES

     1.  BYTE pseudo-op:

         Externals must be loaded into either  fullword  (36  bit)  or
         halfword  (18  bit)  bytes.  Relocatables must be loaded into
         fullword or halfword bytes, with the exception that  a  right
         half  only  relocatable  can be loaded into a right justified
         byte that is between 18 and 36 bits in length.  Examples:

                BYTE (18) REL1, REL2 (6) 3 (30) RHREL3
                BYTE (10) 5 (26) RHREL4

     2.  Unary operators:

         Unary operators now properly take precedence over all  binary
         and  shift  operators.   This  conflicts  with  the  existing
         documentation.  The hierarchy is now as follows:

         a.) All unary operators (+, -, ^-, ^D, ^O, ^B, ^F, ^L, E,  K,
            M, G)
         b.) Shift operators (B-shift, underscore-shift)
         c.) Logical binary operators (!, ^!, &)
         d.) Multiplicative operators (*, /)
         e.) Additive operators (+, -)
MCR53A.DOC                                                      Page 3


     3.  Error message standard:

         On TOPS-10 systems, MACRO will now observe the setting of the
         message  level  bits  during error message typeout (reference
         monitor GETTAB table .GTWCH(35)).

     4.  Macro call statements and XALL

         MACRO will now list the entire statement  in  which  a  macro
         call appears if XALL is in effect.  This may cause the source
         line to be broken up in the listing if multiple  macro  calls
         appear  on the same line, and the called macros have imbedded
         line terminators.  Comments on macro  calls  imbedded  within
         conditionals  will also be listed, with the comment appearing
         along with the last line of the macro expansion, even  if  no
         code is generated for that line.

     5.  .IF/.IFN pseudo-ops

         Contrary to what the documentation states, the .IF  and  .IFN
         pseudo-ops   were  never  intended  to  take  angle-bracketed
         expressions as arguments.   Instead,  they  are  intended  to
         provide  a  powerful  mechanism  for  querying  symbol  table
         attributes, given a valid mnemonic consisting of  up  to  six
         RADIX50 characters.  The newly defined attribute, "NAME", can
         be used to determine if the  argument  is  a  single  RADIX50
         symbol  name.   Such  a  symbol  may  be  enclosed  in  angle
         brackets, nested to any depth.  The  use  of  angle-bracketed
         expressions  is  allowed,  and  treated  as  decribed  below,
         however their use is not recommended.

         Limited expression handling has been  implemented  to  handle
         situations  in  which angle-bracketed expressions are used as
         arguments.  Such an argument will return the combined (IORed)
         attributes   of   its  components,  except  in  the  case  of
         relocation attributes, which are handled correctly only for a
         symbol.  In addition, an angle-bracketed expression will have
         the newly defined attribute "EXPRESSION", providing  a  means
         of  defending  against  angle-bracketed expressions passed as
         arguments to macro calls.  Note that all arguments that  work
         outside angle brackets will work inside them.

     6.  Psects and literals

         Proper  termination  of  literals  within  code  bounded   by
         .PSECT/.ENDPS  is  now  enforced.   Early  termination  of  a
         literal which was started in the same PSECT but at  a  higher
         level (due to nesting), or the failure to terminate a literal
         which was started in the current  PSECT  will  produce  an  L
         error,  and  will  generate  the  new  MCRLNI Literal nesting
         incorrect message.

     7.  Suppressed symbols

         Symbols declared  as  suppressed  internal,  but  defined  by
MCR53A.DOC                                                      Page 4


         externals  or Polish will now retain the suppressed attribute
         and will not be typed out by DDT.

     8.  PSECT attributes

         Valid PSECT attributes and their definitions are as follows:

         CONCATENATED   When  loading  multiple  modules,  all   PSECT
                        blocks   having   the   same   name   will  be
                        concatenated at load time.

         OVERLAID       When  loading  multiple  modules,  all   PSECT
                        blocks  having  the  same  name will be loaded
                        starting at the same  origin  (each  one  will
                        'overlay' the previous one).

         RWRITE         The PSECT can be  read  and  written  (TOPS-20
                        only).

         RONLY          The PSECT can only be read (TOPS-20 only).

         PALIGNED       When  loading  relocatable  PSECTs  (not   yet
                        supported),  the  PSECT origin will be started
                        at a page boundary.

     9.  PSECTs and PRGEND

         PRGENDs can now occur in a source file containing PSECTs.

     10. Assembler typeout for PRGENDed programs

         When MACRO is executed via a RUN  command,  and  the  listing
         device  is  not  the  terminal,  the  informational  messages
         (BREAK, CPU TIME, CORE USED, etc...), will be typed  out  for
         each   program   module  in  a  PRGENDed  source  file.   The
         particular program  module  will  be  identified  by  a  line
         following  the error counts, indicating "PROGRAM XXXX", where
         "XXXX" is the information appearing on  the  TITLE  statement
         for the module.  If no TITLE is specified, the default TITLE,
         ".MAIN" will be typed.  The program identification line  will
         no longer be output to the listing file, however, it will now
         appear with the errors typed out when MACRO  is  invoked  via
         the  CCL  entry  point,  as done by the COMPIL class commands
         under TOPS-10.
MCR53A.DOC                                                      Page 5


     8.  New Error Messages:

       "Q" errors:

         a.  @ appearing in or before AC field
         b.  Index value has left half for POLISH(INDEX)
         c.  BYTE (n) RELOCATBLE where n is not 36 or halfword 18
         d.  @ in unbracketed expression to DEC/EXP/OCT
         e.  Multiple  TITLEs  or  TITLE/UNIVERSAL  conflicts  (was  M
             error)

       "E" errors:

         a.  BYTE (n) EXTERNAL where n is not 36 or halfword 18
         b.  BYTE (n) POLISH symbol, where n is not 36 or halfword 18
         c.  EXTERN/INTERN conflicts

       "X" errors:

         a.  Created symbol exceeds ..7777

       "A" errors:

         a.  OPDEF produces no code
         b.  PSECT origin not absolute

       "L" errors:

         a.  PSECT literal level mismatch
         b.  Assignment involves a label defined within a literal

       New MCR error messages:

         a.  MCRLNI -- Literal  nesting  incorrect  at  end  of  PSECT
             XXXXXX

       Modified MCR error messages:

         a.  MCRPTC -- Polish too complex for location nnnnnn
         b.  MCRPTC -- Polish too complex for symbol XXXXXX

       Deleted MCR error messages:

         a.  MCRPIP -- PRGEND illegal with PSECT
MCR53A.DOC                                                      Page 6


     9.  Polish bugs fixed in the following areas:

         <POINT K,POLISH>

         <POLISH>B<EXP>

         Polish imbedded within a polish expression such as:
         A##+B##+<C##+D##>

         <EXT##,,POLISH>

         <EXT##+1,,0>

         POLISH(INDEX)

         OP AC,ADDR(POLISH)

         OP AC,-<POLISH>

         OP AC,POLISH(LH,,RH)

         Generate fullword fixups only for externals such as:
         0,,EXT##

         Simplex forward references to Polish such as:
         EXP POLISH
         POLISH=EXT##+K

         Generate Polish when needed for expressions such as:
         A+B or A-B
         when A or B is relocatable.

         Generate proper polish when referencing  relocatables  across
         PSECTs
MCR53A.DOC                                                      Page 7


3.0  KNOWN BUGS AND DEFICIENCIES

     1.  MACRO can't generate any Polish block  which  will  use  more
         than 17 words.

     2.  You cannot forward reference a Polish symbol  of  other  than
         the form:  EXT##+k or EXT##-k
         instead, you should do the following:

              FOO=EXT1##+EXT2##
                   .
                   .
                   .
              MOVE  1,FOO

     3.  A  Polish  OPDEF  is  treated  internally  as  a  full   word
         assignment.  As a result, AC and address may not be used with
         it.


     4.  MACRO's floating point input routines do not agree with those
         of other compilers, FORTRAN in particular.

     5.  MACRO will not assemble a line in TOPS-10 PIP correctly.  The
         following represents edit 346 to the product:

         At DSPTAB + 12L:

               DISP   ),0

         Add angle brackets around  the  un-paired  close  parenthesis
         such as:

               DISP   <)>,0

     6.  MACRO will not assemble 2 lines in RUNOFF correctly:

         At FRCEND + 4L and FIN2 + 13L:

               MSG$   ARG1,ARG2,,....."

         Enclose the last macro argument in angle brackets, such as:

               MSG$   ARG1,ARG2,,<.....">

         or include the statement .DIRECTIVE NO MACMPD somewhere  near
         the beginning of the program.

     7.  MACRO currently will not  allow  pooling  of  literals  which
         contain labels.

     8.  If the right hand side  of  an  assignment  statement  is  an
         expression  containing  Polish,  angle-brackets must surround
         the expression.
MCR53A.DOC                                                      Page 8


     9. Incorrect CREF listings generated when:

              .zero loop of IRP is done.

              .references suppressed by XLIST inside macro expansion.

     10. Phase errors will be generated by MACRO when  assembling  the
         distributed  TOPS-10 MIC source.  MACRO allows macro calls to
         occur in the operand field of a source statement.  The sample
         program  below  shows the sequence of instructions in the MIC
         source which causes the phase errors to occur.

              SEARCH MACTEN
              JRST MACERR
              MACERR:
              END

         As  shown  above,  MIC.MAC   forward-references   MACERR,   a
         user-defined  label.   However,  MACERR  also  happens  to be
         defined in MACTEN as a macro.  Since MIC searches MACTEN, and
         since  macro  calls  are allowed in operand fields, the macro
         definition is used in assembling the statement "JRST  MACERR"
         in  pass  one.  This causes phase errors in pass two when the
         correct label definition is used.  Problem may  be  fixed  by
         changing the lable name MACERR so as not to conflict with the
         macro name.

     11. In TOPS-10 SETSRC.MAC, MACRO encounters a  forward  reference
         of  a  symbol  name  JSYS, and MACRO assembles in TOPS20 JSYS
         opcode instead of user label address.  The  following  change
         represents  edit  47  to  the  product,  which eliminates the
         problem.

         In macro CTAB, 6 lines down, the macro definition:

               DEFINE   CC (NAM,ADDR)<ADDR>

         should be changed to:

               DEFINE   CC (NAM,ADDR)<Z ADDR>


     12. Attempts to compile field image BACKRS.MAC to rebuild  BACKUP
         will  produce R errors.  These errors occur on erroneous BYTE
         statements that attempt to modify the high order bit of an 18
         bit  relocatable  quantity.   This  type  of  error  was  not
         detected by previous versions of MACRO.

         At FRSDTM + 0L:

                FRSDTM: BYTE (1)0 (17)FRSDAT (18)L$DATE ;LABEL CREATION
                        BYTE (1)1 (17)FRSDSD (18)L$DSTR ;DESTROY DATE
                        BYTE (1)0 (17)FRSSDT (18)S$DATE ;SAVE SET DATE

         Replace the 3 lines with:
MCR53A.DOC                                                      Page 9


                        FRDUM1==0B18+FRSDAT             ;[330]
                        FRDUM2==1B18+FRSDSD             ;[330]
                        FRDUM3==0B18+FRSSDT             ;[330]
                FRSDTM: BYTE (18)FRDUM1 (18)L$DATE      ;[330]LABEL CREATION
                        BYTE (18)FRDUM2 (18)L$DSTR      ;[330]DESTROY DATE
                        BYTE (18)FRDUM3 (18)S$DATE      ;[330]SAVE SET DATE

     13. The opcode field  of  an  instruction  must  evaluate  to  an
         absolute  quantity  at  compile  time.  Note that no error is
         generated if this condition is not met, to allow  for  OPDEFs
         which  contain  relocatables,  or  externals  in  the address
         portion of the instruction.

     14. Polish is not allowed an index field  (eg.   ADDR(POLISH)  ).
         Also,  externals  are  not  allowed in the index field if the
         expression evaluates to other than a zero in the  left  half.
         This  restriction  is imposed because there is no polish swap
         operator.  Note that the expression ( "OP  AC,POLISH(1B1)"  )
         falls  into  this  class  of  problems,  however,  it  is not
         currently flagged as an error.

     15. Error lines in macros under SALL do not list.  They  can  not
         be  listed  since the original source line is not around when
         the macro call line is finally listed.

     16. Long binary generating lines under XALL list only partially.

     17. Lines in an IRP will usually not be indeneted  properly  when
         LALL is in effect.

     18. Under SALL, the following example involving REPEAT  does  not
         list as expected.

                REPEAT 2,<MOVE
                        COUNT=0>

         The REPEAT is closed off before the last line is listed.

     19. A formfeed followed by another formfeed causes macro to  skip
         a page header.

     20. CREF reference line numbers can be  incorrect  for  variables
         seen  in XLISTed code.  In the following example, A is CREFed
         as being referenced on the line following LABEL.

                A=1
                DEFINE X,<XLIST
                A
                LIST>
         LABEL: X
                Z

     21. MACRO's  command  scanner  is  very  archiac,  and  does  not
         neccessarily conform to the currently accepted method of file
         specification scanning,  such  as  that  used  by  SCAN.   In
MCR53A.DOC                                                     Page 10


         particular, the command:

                FIL E.REL=FILE.MAC

         is accepted without error, and FILE.REL is created.  Also,  a
         single  filespec  will  cause the TOPS-20 version of MACRO to
         loop until it eventually runs out of core.

     22. The .DIRECTIVE .NOBIN does not work  properly  with  PRGENDed
         files, since the directive immediately closes the .REL file.

     23. .DIRECTIVEs MACPRF and .NOUUOS do not get  cleared  across  a
         PRGEND.

     24. MACRO is unable to PEEK ahead across the end of  macro  args,
         the  end  of  a  macro,  the  end  of an IRP, or the end of a
         REPEAT.  This means that constructs such as "==", "=:", "::",
         and others cannot be recognized across these limits.  This is
         related to not being able to continue  a  line  across  these
         boundaries.

     25. Either  "A=B##"  or  "A=EXP  B##"  should  generate  fullword
         Polish.   At  present,  the first case generates a right half
         external fixup, and the second  case  generates  bad  listing
         output and an incorrect .REL file.

     26. Polish used as  the  argument  to  a  B  shift  operator  may
         generate a bad .REL file, depending upon whether or not angle
         brackets surround the entire expression, such as:

                <<POLISH>B7*4>

     27. Characters that are not specified to be in MACRO's recognized
         character  set,  such as vertical bar, will be converted to a
         strange up-arrow character, if they are passed over  as  part
         of an unprocessed conditional.

     28. A macro which contains SALL and XLIST  will  cause  an  extra
         blank  line  to appear in the listing file, because both SALL
         and XLIST attempt to  finish  off  the  current  output  line
         before changing listing modes.

     29. An unary minus preceeding a relocatable expression such as:

                -<RELOC+2>

         generates garbage Polish.

     30. A Polish assignment statement  with  an  imbedded  assignment
         statement, such as:

                A=B##+<N=3>

         will not generate the proper Polish fixup block for symbol A.
MCR53A.DOC                                                     Page 11


     31. Phase errors can occur in a PSECTed program that has a symbol
         defined  as a Relocatable, and also as a MACRO/OPDEF/SYNONYM.
         This occurs because of the following:

         A. MACRO maintains a seperate symbol table  for  each  PSECT.
            This  is  done to keep EXTERNAL fixup chains seperate, and
            also for Relocatables since they may  be  referenced  from
            another PSECT.

         B. MACRO expects the two  definitions  for  the  same  symbol
            (Relocatable  and  MACRO/OPDEF/SYNONYM) to appear together
            in  the  same  symbol  table.   MACRO   frequently   makes
            decisions  concerning  the treatment of a symbol using the
            knowledge that both symbol definitions exist.

         C. In a PSECTed  program,  the  two  symbol  definitions  may
            actually  appear  in  different PSECT symbol tables.  This
            can  also  occur  differently  during  the   two   passes,
            depending  on  IF1  and  IF2  conditionals.   Also, if the
            MACRO/OPDEF/SYNONYM  is  defined  in  a   UNIVERSAL,   the
            situation   is  complicated  since  such  definitions  are
            usually entered into the symbol table for the Global PSECT
            when the symbol is referenced.

         Given the above,  it  is  possible  to  reference  the  wrong
         definition  of  a  symbol  during  pass  2  of  the assembly,
         generating a different amount  of  code  than  was  generated
         during pass 1, causing the phase errors.



4.0  INSTALLATION INSTRUCTIONS


The  MACRO  source  file  as  distributed  assembles  and  loads  into
MACRO.EXE.

To install MACRO Version 53A on your system, copy the  file  MACRO.EXE
to SYS:.

The distributed version of MACRO.CTL was used  to  first  build  MACRO
using  field  image  software  (MACRO version 53(1020)), and then this
created version was used to create itself.  The two versions of  MACRO
V53A were then checked for inconsistencies.  None were found.

Customers who wish to rebuild MACRO after installing any  changes  can
use  MACRO.CTL  as  a  guide to the building process.  It is unlikely,
however, that the .CTL file can be executed  without  modification  on
most user systems.  In particular, attention should be given to ERSATZ
devices, structure names, PPNs and other such system parameters.

MACRO requires field image HELPER, which is loaded implicitly  via  an
imbedded .REQUIRE pseudo-op in the MACRO source file.
MCR53A.DOC                                                     Page 12


5.0  INTERNAL CHANGES

Edit      SPR/QAR                     description
Start of version 53A
Following 3 patches are documented in the MACRO 53 BWR file
1021                When multiple .PSECT stmnts  exist  for  the  same
                    PSECT, origin need only be in one.
1022                In ARRAY pseudo op, allow UNV-searching of symbols
                    used in dimension argument.
1023                Correct     assembly     of      stmnts      like:
                    "FOO=IFNB <>,<BAR=5>".
1024                Some cleanup
1025                Don't go Polish calculating "REPEAT" count
1026                Fix bug caused by edit 1010 ( <POINT K,POL> )
1027                Make sure UOUT routine searches all  PSECT  symbol
                    tables.
1030                AC0 to AC2 in part of edit1021;  cause P-error  in
                    PSECT progam
1031                Turn off flag in RC to indicate undef  in  literal
                    in STOLIT 
1032      (25358)   Fix .XTABM with parenthesized macro call arg lists
1033      (25358)   Clear MACMPD  and  .XTABM/.ITABM  settings  across
                    passes
1034      (25555)   Fix fatal  errors  caused  by  bad  recovery  from
                    N-errors.
1035      (26078)   Fix OPDEF with TEXT  pseudo-ops  and  inside  lits
                    (rework edit 1000)
1036                Up CTLSIZ to 1000 characters
1037                Add code to use FORCEP for <POLISH>B<EXP> when not
                    in larger exp.
1040                Move embedded Polish into free  space  when  doing
                    POLPSH.
1041                Add .DIRECTIVE .NOUUO
1042                Calculate total symbol  count  before  turning  on
                    attribute  bits  (move  edit  1021 one instruction
                    lower and remove edit 1027)
1043                Change .DIRECTIVE .NOUUO to .DIRECTIVE .NOCALLIS
1044      (25015)   Fix bad load-time relocation  for  expressions  of
                    the   form   "A+B"  or  "A-B"  where  A  or  B  is
                    relocatable.
1045      (25581)   Preserve  symbol  characteristics  across   nested
                    assignments (e.g., A==:<B==2>)
1046      (11716)   Fix "ILL MEM REF" to addr 777777 due to bad  macro
                    call syntax
1047                Make expressions of the form  <A##,,POLISH>  where
                    POLISH is a Polish expression assemble correctly
1050                Fix   "?MCREPP"   error   during   processing   of
                    expressions  with  complex  external  left  halves
                    (e.g., <EXT##+1,,0>)
1051                Fix "?ILL MEM REF" after  "?MCREPP"  (expand  edit
                    1007)
1052      (26137)   Fix "?ILL MEM REF" with large PRGENDed files
1053                Generate X-error if exceeded max of created symbol
                    (..7777);   start  over  from  ..0000  rather than
                    creating ./0000
MCR53A.DOC                                                     Page 13


Edit      SPR/QAR                     description
1054      (25910)   Give  unary  operators   precedence   over   shift
                    operators and logical operators.
1055      (26428)   Don't   generate    Polish    for    REL-ABS    in
                    single-segment, non-Hiseg, non-PSECT program.
1056      (25357)   Make   MACRO    more    flexible    in    handling
                    angle-bracketed   args   to  .IF/.IFN;   implement
                    "EXPRESSION" attribute.
1057      (12055)   Restore correct .PSECT/.ORG interaction in wake of
                    edit 573
1060      (25477)   Improve "?MCRPTC Polish too complex" error message
                    by  appending "for symbol xxxxxx" or "for location
                    xxxxxx"
1061      (25715)   Re-do  "Error  while   expanding"   error-trapping
                    (supersedes edits 1046,746)
1062      (25907)   Fix listing of LIT inside SALL macro expansion
1063      (25777)   Make .XCREF, .CREF work inside literals
1064      (25777)   Fix listing of LALL inside SALL macro
1065      (25777)   Make LALL, XALL, SALL, LIST,  XLIST,  .DIREC  work
                    inside literals (requires edit 1064)
1066      (25838)   Make macro observe the settings of  message  level
                    bits  during  error message typeout (see GETTAB 35
                    monitor table)
1067      (26529)   BYTE psuedo-op specifying externals on other  than
                    full  or  half word boundaries produces EPP errors
                    and ILL MEM REF.
1070      (26571)   Correctly indicate EXTERN/INTERN  conflicts  as  E
                    errors instead of P or A errors
1071      (26690)   Set Polish flag in correct half of FR  when  doing
                    forced right half Polish in angle brackets
1072      (26749)   List complete macro call  line  when  XALL  is  in
                    effect
1073      (26884)   Fix ?ILL  MEM  REF  and  E  errors  during  Polish
                    indexing
1074      (12239)   Force   pairing    of    LIT    brackets    within
                    .PSECT/.ENDPS.  Make END illegal within literal of
                    any PSECT, not just current.  Correct  error  msg.
                    tag offset if within nested lits with labels.
1075      (27082)   List comment on macro call line when  XALL  is  in
                    effect
1076      (27099)   Do not allow '@' in AC field, flag as questionable
1077                Allow right  justified  relocatables  to  be  gtr.
                    than  18  bits  for  BYTE.  Make BYTE allow Polish
                    symbols only for full and half words.
1100                Eliminate phase errors produced by edit 1074
1101                Fix   bad   Polish   for   expressions   involving
                    inter-PSECT  references of relocatables.  Addition
                    to edit 1040.
1102                Keep DDT suppress  bits  when  symbol  defined  as
                    internal has an external or Polish value
1103                Rework REL+ABS,  REL+REL,  REL-ABS,  REL-REL  code
                    added   by  edits  1044  and  1055  to  handle  RH
                    relocatables only
1104      (12505)   Do not  generate  Polish  FWF  when  doing  Polish
                    indexing
MCR53A.DOC                                                     Page 14


Edit      SPR/QAR                     description
1105      (12506)   Make OP AC,-<POL> generate correct RH fixup
1106      (12637)   Do not generate fullword fixup unless external  is
                    of the form 0,,EXT
1107      (27389)   Do not allow Polish in index field, do  not  allow
                    externals  in  OP  code  index,  make psuedo-op in
                    index field work in all cases
1110                Generate correct Polish for V=EXT##+K  when  V  is
                    still  defined  by a special external pointer (not
                    yet defined in pass 2).  More of edit 703.
1111                Augment edit 1103 to generate less Polish.   Cases
                    improved   involve   negative   relocatables   and
                    relocatables  slightly  less  than   HMIN   (range
                    HMIN-400).
1112      (27167)   Expand .IF/.IFN feature by adding "NAME" attribute
                    indicating a single RADIX50 name (symbol) has been
                    passed as an argument.
1113      (27418)   Eliminate OPDEF processing inconsistencies
1114      (27388)   Add the swapped left half value of  the  index  to
                    the  Polish  generated  for statements of the form
                    'OPCODE AC,POLISH(LH,,RH)'
1115      (27544)   For DEC/EXP/OCT,  give  Q  error  for  unbracketed
                    expressions involving '@'.  Forces use of brackets
                    for full address calc.
1116                Fix inter-PSECT references to special pointers  of
                    externals  so  the  external  chain does not cross
                    PSECTs.
1117      (27728)   Make  .PSECT   handle   attribute   specifications
                    correctly
1120      (12962)   Reset RP and MP in the END code since macros  must
                    be completed
1121                Increase the number of extra (XTRA)  locations  to
                    save  for  PRGEND to 8 to prevent possible ILL MEM
                    REFs
1122      (27813)   Do not copy nulls into statement output buffer
1123      (27976)   Generate   Q   error   for   multiple    TITLEs/or
                    TITLE/UNIVERSAL  conflicts,  instead  of  M  error
                    during only pass 1
1124      (Q3051)   Increase .UNIV to 50.
1125      (Q3038)   Re-install macros for DIRECTIVE args and routines
1126      (Q3045)   Flag most assigments  involving  a  label  defined
                    within  a  literal  as L errors.  Label may not be
                    defined till end of pass 2.
1127      (Q3053)   Generate the desired ASCII string for  macro  call
                    arg  '\N  '  when  N  is  a symbol or expression -
                    broken by edit 137
1130                Reset assembly mode to  relocatable  (1)  at  pass
                    initialization.
1131                Remove edit 646, make PRGEND work with PSECTs
1132                Fix numerous PSECT bugs - PSECT FOO,1000  /  PSECT
                    FOO  loses  orig.   PSECT and LOC inconsistencies,
                    PSECT and PHASE inconsistencies.
1133      (Q3047)   Fix RSW3  to  properly  detect  when  the  listing
                    output buffer is full - handle tabs properly after
                    the 128 character limit
MCR53A.DOC                                                     Page 15


Edit      SPR/QAR                     description
1134                Make LOCO stay in sync.  with LOCA during pass  1.
                    PSECTs nested within literals cause out-of-sync.
1135      (28104)   Do 'OP' processing instead of a  full  word  fixup
                    for cases such as 'OP## AC,ADDR'.  This and Polish
                    opcodes will not produce the proper code for  left
                    half externals.
1136                Clear PSECT nesting counter and other PSECT  items
                    at PRGEND, plus check for PRGEND inside literals
1137                Flag non-absolute PSECT origins as an 'A' error
1140                Edit 1123 broke 5  character  TITLEs  in  PRGENDed
                    files,  clear  out  2nd word of TITLE when loading
                    default TITLE of .MAIN.
1141      (Q3085)   For PRGENDed programs, print BREAK, CPU TIME, CORE
                    USED data for each program module.
1142      (Q3181)   Repeat the  eol  char.   if  a  terminating  angle
                    bracket is missing.
1143                SYN A,B will not cref B as defining occurance
1144                Save/clear/and restore cpu type over PRGENDs.
1145                Edit 1135 stopped generation of  full  word  fixup
                    for [FOO  ].
1146                Allow NUL:  as cref device.
1147                Edit 1113 caused the OPDEF in "EXP OPDEF  AC,ADDR"
                    to  be  processed  as  an  address, discarding the
                    remaining fields.
1150      (Q3261)   XLIST under SALL  puts  extra  characters  in  the
                    listing file.
1151                Do not output block 22's after the end  block  for
                    PRGEND.
1152      (Q3410)   Edit 1143 caused bad CREF data to be generated for
                    a SYN such as "SYN IFE,IF".

;*****End of Revision History*****
MCR53A.DOC                                                     Page 16


6.0  SUGGESTIONS

The following is  a  list  of  suggestions  accumulated  from  various
sources.   The  appearance of a suggested change in this list does not
imply any commitment or intent on the part of  DEC  to  implement  any
such change.

     1.  Use a hash table instead of binary search.  Add a  switch  to
         specify the hash size.

     2.  Better core management scheme.

     3.  Search UUOSYM.

     4.  Use MACTEN and JOBDAT.

     5.  Allow curvy brackets to work the same as angle  brackets  < >
         for conditionals, REPEATs, IRPs, etc.

     6.  Add an error file to contain all assembly errors to  be  used
         with /N switch.

     7.  Allow the line  continuation  character  (^_)  to  work  over
         end-of-macro, -IRP, etc.

     8.  Add all of the KL10 hardware opcode mnemonics.



[End of MCR53A.DOC]

[MCR53.DOC is appended as an integral part of MCR53A.DOC]
MCR53.DOC                                                      Page 17


MACRO.DOC -- Changes from V52(551) to V53(1020)
March 1978



1.0  SUMMARY

The   purpose   of   this   release   is   to   provide   a   software
multiple-segmentation (PSECT) facility.

MACRO version 53 is supported by Digital  Equipment  Corporation,  and
runs  on  all  supported  monitors  as  released.   Version  53  fully
supersedes all previous versions, and includes edits up to #1020.

MACRO V53 requires field image HELPER.REL to be on SYS:  in  order  to
type  out  the help file MACRO.HLP, which should be placed on HLP:  or
REL:.

MACRO V53 requires that if PSECTS are used, the resultant  .REL  files
be loaded with LINK V4, which fully supports the PSECT facility.

MACRO is documented in the  DECsystem-10  User's  Guide,  and  in  the
DECsystem-10 MACRO User's Guide.



2.0  EXTERNAL CHANGES

     1.  .PSECT pseudo-op:

         The .PSECT pseudo-op  directs  MACRO  to  start  or  continue
         placing  code  and/or  data  into  the named program section.
         Syntax:

              .PSECT name, origin

         Where "name" is the name of the program section;  name may be
         any  construction  which  would be valid as a symbol but will
         not conflict with a symbol or macro of the same name.

         MACRO will generate a global symbol having the PSECT name and
         at  load time the symbol will take on the PSECT origin as its
         value.

         The origin, if supplied in the program, tells LINK where  the
         PSECT  origin should be.  If not supplied then it must be set
         by  the  /SET:NAME:ORIGIN  switch  to  LINK.   If  both   are
         supplied,  whichever  occurs  first  is  used  and  cannot be
         over-ridden by a later declaration.
MCR53.DOC                                                      Page 18


     2.  .ENDPS pseudo op:

         The .ENDPS pseudo-op  directs  MACRO  to  stop  placing  code
         and/or  data  into  the  current program section and to start
         placing it  in  the  previous  (more  outer  nested)  program
         section.  Syntax:

              .ENDPS [name]

         The name field is optional and if  present  will  be  checked
         against the current .PSECT name.  If there is a disagreement,
         a warning diagnostic will be issued.  This  check  cannot  be
         done for the blank .PSECT.

     3.  "PSECT" Nesting

         .PSECT and .ENDPS are essentially brackets which surround the
         code and/or data which is to be loaded into the named program
         section.  These brackets may be nested  to  a  maximum  depth
         which  is  an  assembly  parameter normally set to 16 decimal
         when the MACRO assembler is assembled.  Another such assembly
         parameter  within  MACRO  is  the  maximum number of distinct
         .PSECT names which may occur within a single assembly;  it is
         normally set to 64 decimal.

     4.  Restrictions

         a.  .PSECT and .ENDPS are not allowed  within  a  "UNIVERSAL"
             file.

         b.  While MACRO allows a macro and a symbol to have the  same
             name,  this  can produce unpredictable results if the two
             are not in the same  symbol  table  during  an  assembly.
             This can happen if one is in a universal symbol table and
             the other is not, or if the two appear to be in  separate
             segments.   It  is recommended that symbols and macros of
             the same name not be employed.  If they are, DEC reserves
             the  right  to  change  the  implementation  of the MACRO
             assembler with respect to how this situation is treated.

         c.  If  universal  files  are  searched  while  assembling  a
             program  with  multiple  program sections, symbols within
             the universal files  will  appear  to  be  in  the  blank
             program   section.   This  is  particularly  relevant  to
             relocatable symbols.

         d.  .PSECT, HISEG, and TWOSEG are all mutually exclusive.

         e.  Literals containing inter-PSECT references  will  not  be
             collapsed,  therefore  if  there  are  two such identical
             literals, two separate entries in the literal table  will
             be made.

         f.  PRGEND is illegal with .PSECT and  MACRO  will  treat  it
             like END and the rest of the file will be truncated.
MCR53.DOC                                                      Page 19


     5.  New Error Messages:

       "S" Errors:

         a.  Attempt to nest .PSECTs too deep.

         b.  Attempt to unnest .PSECTs too far.

         c.  .PSECT occurs while assembling a universal.

         d.  Too many distinct .PSECT names.

         e.  Attempt to mix .PSECT with HISEG/TWOSEG.

       "Q" Warning (additional):

         a.  .ENDPS specifies the wrong name.

         b.  .PSECT specifies conflicting attributes.

         c.  .PSECT specifies unknown attributes.

       New MCR error messages:

         a.  MCRSTO -- Search table overflow

         b.  MCRATS -- Argument too small.

         c.  MCRLTL -- Literal too long.

         d.  MCRISD -- Illegal syntax in DEFINE.

         e.  MCRISR -- Illegal syntax in REPEAT.

         f.  MCRISC -- Illegal syntax in conditional.

         g.  MCRISI -- Illegal syntax in IRP or IRPC or REPEAT.

     6.  .IF ARG,REFERENCED,< ....  >
         .IF ARG,NEEDED,< ....  >

         REFERENCED --   The code will be assembled if arg is  in  the
                         symbol table.

         NEEDED     --   The code will be assembled if arg is  in  the
                         symbol table and its value is undefined.

     7.  Alternate Interpretations of MACRO Arguments

         The normal argument passed by a  macro  call  is  simply  the
         string of characters given with the call.  MACRO offers three
         alternate interpretations of the passed argument.
MCR53.DOC                                                      Page 20


         If you prefix a backslash (\) to an argument, MACRO expects a
         numerical  value  and  the ASCII string representation of the
         value is passed.

         If you prefix a backslash-apostrophe (\') to an argument, the
         argument is expected to have a value of a SIXBIT string.  The
         ASCII representation of that SIXBIT value is passed.

         If you prefix a backslash-quotemark (\") to an argument,  the
         argument  is expected to have a value of a ASCII string.  The
         ASCII string value is passed.

        LALL
        DEFINE LOOKIE(STR,ARG) <
                REMARK  The passed argument is:  ARG
                REMARK  build a new string:     str'arg >

;Example of prefixing actual argument with \
CASE1:  VALUE=0
        LOOKIE LPT,<VALUE+1>^
                REMARK  The passed argument is:  VALUE+1
                REMARK  build a new string:     LPTVALUE+1
CASEA1: REPEAT 3,<
        LOOKIE  LPT,\<VALUE+1>
                VALUE=VALUE+1>
        LOOKIE  LPT,\<VALUE+1>^
                REMARK  The passed argument is: 1
                REMARK  build a new string:     LPT1    ^
                VALUE=VALUE+1
        LOOKIE  LPT,\<VALUE+1>^
                REMARK  The passed argument is: 2
                REMARK  build a new string:     LPT2    ^
                VALUE=VALUE+1
        LOOKIE  LPT,\<VALUE+1>^
                REMARK  The passed argument is: 3
                REMARK  build a new string:     LPT3    ^
                VALUE=VALUE+1
;Example of prefixing argument with \'
CASE2:  VALUE='A'
        LOOKIE  DSK,VALUE^
                REMARK  The passed argument is: VALUE
                REMARK  build a new string:     DSKVALUE      ^
CASE2A: REPEAT  3,<
        LOOKIE  DSK,\'VALUE
                VALUE=VALUE+1>
        LOOKIE  DSK,\'VALUE^
                REMARK  The passed argument is: A
                REMARK  build a new string:     DSKA    ^
                VALUE=VALUE+1
MCR53.DOC                                                                Page 21


        LOOKIE  DSK,\'VALUE^
                REMARK  The passed argument is: B
                REMARK  build a new string:     DSKB    ^
                VALUE=VALUE+1

        LOOKIE  DSK,\'VALUE^
                REMARK  The passed argument is: C
                REMARK  build a new string:     DSKC    ^
                VALUE=VALUE+1

;Example of prefixing argument with \"
CASE3:  VALUE="XIT"
        LOOKIE  <?ERROR IN LINK MODULE LNK>,VALUE^
                REMARK  The passed argument is: VALUE
                REMARK  build a new string:     ?ERROR IN LINK MODULE LNKVALUE ^
CASE3A:  LOOKIE <?ERROR IN LINK MODULE LNK>,\"VALUE^
                REMARK  The passed argument is: XIT
                REMARK  build a new string:     ?ERROR IN LINK MODULE LNKXIT

     8.  Polish bugs fixed in the following areas:

         <XWD POL,POL> or <POL,,POL>

         <IOWD POL>

            -<POL>

            -EXP where EXP is a relocatable expression

            @POL(AC)

            OPDEF FOO [ POL ]

         Generate full word fixup for FOO##

     9.  Polish listing format

         A number sign (#) in the  listing  indicates  that  a  Polish
         expression is required to resolve the expression:

         For example:

         561  02  000  000000#      ;requires right half Polish fixup
         000000000000#              ;requires full word Polish fixup
         000000# 000002             ;requires left half Polish fixup
MCR53.DOC                                                      Page 22


    10.  PSECT index in listing

         PSECT index is output at the end of relocation counter  value
         in the listing, see example below:

5172                                ;GETNAM - RETURN LOCAL NODE NAME
5173
5174  005654'02 256 04 0 00 007001' GETNAM: UMOVE   T2,2          ;GET ADDRESS OF USER'S ARGUMENT BLOCK
5175  005655'02 256 04 0 00 007002'         UMOVE   T1,.NDNOD(T2) ;GET POINTER TO WHERE NODE NAME IS TO GO
5176  005656'02 201 03 0 02 000000          MOVEI   T3,.NDNOD(T2) ;GET ADDRESS TO RETURN UPDATED POINTER
5177  005657'02 561 02 0 00 000000#         HRROI   T2,OURNAM-1   ;GET POINTER TO SOURCE STRING
5178  005660'02 260 17 0 00 000000*         CALL    CPYTU1        ;COPY STRING TO USER SPACE, RETURN POINTER
5179  005661'02 254 00 0 00 005653*         RETSKP                ;DONE, RETURN SUCCESS
5180
5181
5182                                        TNXEND
5183                                        END
PROGRAM BREAK IS 000000
PSECT 1 BREAK IS 000534 FOR RSCOD
PSECT 2 BREAK IS 007036 FOR NRCOD
PSECT 3 BREAK IS 000066 FOR BGSTR
PSECT 4 BREAK IS 000011 FOR BGPTR
CPU TIME USED 02:28.153

98P CORE USED

    11.  Polish not allowed with RELOC & BLOCK & Conditionals
    12.  KL instructions have been updated

                       JRST and JFCL Mnemonics
                       -----------------------


     254 04 0 00 000000      HALT     254 04 0 00 000000    JRST 4,
     255 06 0 00 000000      JCRY     255 06 0 00 000000    JFCL 6,
     255 04 0 00 000000      JCRY0    255 04 0 00 000000    JFCL 4,
     255 02 0 00 000000      JCRY1    255 02 0 00 000000    JFCL 2,
     254 12 0 00 000000      JEN      254 12 0 00 000000    JRST 12,
     255 01 0 00 000000      JFOV     255 01 0 00 000000    JFCL 1,
     255 10 0 00 000000      JOV      255 10 0 00 000000    JFCL 10,
     254 02 0 00 000000      JRSTF    254 02 0 00 000000    JRST 2,
     254 01 0 00 000000      PORTAL   254 01 0 00 000000    JRST 1,
     254 06 0 00 000000      XJEN     254 06 0 00 000000    JRST 6,
     254 05 0 00 000000      XJRSTF   254 05 0 00 000000    JRST 5,
     254 07 0 00 000000      XPCW     254 07 0 00 000000    JRST 7,
     254 14 0 00 000000      XSFM     254 14 0 00 000000    JRST 14,
MCR53.DOC                                                      Page 23


                  KL10 EXTEND Instruction Mnemonics
                  ---------------------------------


     002 00 0 00 000000      CMPSE    010 00 0 00 000000     CVTDBO
     007 00 0 00 000000      CMPSG    011 00 0 00 000000     CVTDBT
     005 00 0 00 000000      CMPSGE   004 00 0 00 000000     EDIT
     001 00 0 00 000000      CMPSL    016 00 0 00 000000     MOVSLJ
     003 00 0 00 000000      CMPSLE   014 00 0 00 000000     MOVSO
     006 00 0 00 000000      CMPSN    017 00 0 00 000000     MOVSRJ
     012 00 0 00 000000      CVTBDO   015 00 0 00 000000     MOVST
     013 00 0 00 000000      CVTDBT   020 00 0 00 000000     XBLT

    13.  Tags defined in a literal:

         Tags in literals may be referenced anywhere from the  program
         with the following restrictions.

         a.  May NOT be used in an arbitrary expression.

         b.  May NOT be referenced from another PSECT.

    14.  Code Generation Changes:

         The descriptions of the block types 24,23, and  22  supercede
         the descriptions in the LINK manual.

         BLOCK 24  -- MACRO generates a  set  of  block  24's  at  the
         beginning of the Rel file for each PSECT in this assembly.  A
         type 24 contains three data words -- a PSECT name in  SIXBIT,
         its  attributes  (right  half) and its index (left half), and
         its origin.  A block 24 establishes a PSECT and associates it
         with  an  index number so that block 22's and block 11's that
         follow may reference PSECTs by the PSECT index number.

         BLOCK 22 -- Interspersed with the type 1  and  type  2  codes
         there  are  type  22  codes.   A  type 22 directs the linking
         loader to place subsequent type 1 and type 2 information into
         the  named  .PSECT.   A  type 22 will also precede the type 7
         block if one occurs and other type 22s have been emitted.   A
         type 22 contains only one data word which is the PSECT index.
MCR53.DOC                                                      Page 24


         BLOCK 23 -- MACRO generates a set of block 23's for  all  the
         PSECTs  at  the end.  A type 23 contains two data words.  The
         first is a .PSECT name in SIXBIT.  The  second  contains  the
         .PSECT break.

         BLOCK 11 -- There is an additional type of Polish fixup which
         occurs  for  assemblies with multiple .PSECTs.  With multiple
         .PSECTs, it is necessary to  distinguish  among  the  .PSECTs
         within  the  fixups  in  order  that  relocation  will  occur
         properly.  Halfword PSECT  index  of  the  form  400000+(n-1)
         indicates  next  relocatable  address is to be relocated with
         respect to the PSECT which is  named  by  the  n'th  type  23
         block.   The  very  first PSECT index in block 11 defines the
         current PSECT  and  the  relocation  counter  for  the  store
         address.  Any relocatable operand with a different relocation
         counter must be preceded by the proper PSECT index.

         BLOCK 10 -- Forward references of a tag defined in a  LITERAL
         are  chained similarly to that of an external chain.  A block
         10 is generated containing the value of the tag and the start
         of  the  chain.  A separate chain is generated for each PSECT
         just as a separate external chain is generated for PSECT.

    15.  Better RELOC,LOC, .ORG interactions

    16.  Add .NODDT pseudo-op --

         Suppress DDT and part of symbol names

    17.  REL files generated by  MACRO  V52  and  MACRO  V53  may  not
         compare with FILCOM.

    18.  Universals are not searched when processing  label,  ##,  END
         statement  and  the  following  pseudo-ops:   EXTERN,  OPDEF,
         .ASSIGN, SYN, INTEGER, ARRAY,  .COMMON,  DEFINE.   Pseudo-ops
         INTERN  and ENTRY will still search universals since they are
         not truely defining occurrences.

    19.  OPDEF's may be declared INTERNAL only if no label of the same
         name exists.

    20.  LABEL+OFFSET error reporting is now entirely source-oriented.
         Specifically,  blank  lines  are reflected in the offset, and
         MACRO/REPEAT expansion lines are not.
MCR53.DOC                                                      Page 25


3.0  KNOWN BUGS AND DEFICIENCIES

     1.  MACRO can't generate any Polish block  which  will  use  more
         than 17 words.

     2.  You can't forward reference a Polish symbol,
         should do:

              FOO=EXT##+1
                   .
                   .
                   .
              MOVE  1,FOO

     3.  A  Polish  OPDEF  is  treated  internally  as  a  full   word
         assignment.  As a result, AC and address may not be used with
         it.



     4.  MACRO's floating point input routines do not agree with those
         of other compilers, FORTRAN in particular.

     5.  MACRO will not assemble a line in PIP correctly:

               DISP   ),0

         Add angle  brackets  around  the  un-paired  close  paren  in
         PIP.MAC:

               DISP   <)>,0

     6.  MACRO will not assemble a line in RUNOFF correctly:

               MSG$   ..."

         Delete the unpaired  quote  mark  at  the  end  of  the  line
         RUNOFF.MAC:

               MSG$   ...

     7.  MACRO prevents  the  TWOSEG  pseudo-op  from  working  across
         PRGEND.   LOGIN  57 took advantage of the bug.  Correct LOGIN
         sources as follows:  remove the TWOSEG pseudo-op from page  1
         of  LGNUNV.   On page 2 of LGNUNV, add a TWOSEG to the LGNDCL
         macro definition just before the RELOC  400000.   In  LGNLOW,
         add  a  TWOSEG before the RELOC 400000.  This fix is included
         in LOGIN version 60, which is fully compatible with  versions
         50A, 52, and 53 of MACRO.

     8.  MACRO currently will not  allow  pooling  of  literals  which
         contain labels.
MCR53.DOC                                                      Page 26


     9.  If the right hand side  of  an  assignment  statement  is  an
         expression  containing  Polish,  angle-brackets must surround
         the expression.

     10. Expressions of the form

              <EXT  +1>B7

         generate a ?MCREPP error message.

     11. Incorrect CREF listings generated when:

              .zero loop of IRP is done.

              .references suppressed by XLIST inside macro expansion.

     12. Phase errors will be generated by MACRO when  assembling  the
         distributed MIC source.  MACRO allows macro calls to occur in
         the operand field of a source statement.  The sample  program
         below  shows  the  sequence of instructions in the MIC source
         which causes the phase errors to occur.

              SEARCH MACTEN
              JRST MACERR
              MACERR:
              END

         As  shown  above,  MIC.MAC   forward-references   MACERR,   a
         user-defined  label.   However,  MACERR  also  happens  to be
         defined in MACTEN as a macro.  Since MIC searches MACTEN, and
         since  macro  calls  are allowed in operand fields, the macro
         definition is used in assembling the statement "JRST  MACERR"
         in  pass  one.  This causes phase errors in pass two when the
         correct label definition is used.  Problem may  be  fixed  by
         changing the lable name MACERR so as not to conflict with the
         macro name.

     13. In SETSRC.MAC, MACRO encounters  a  forward  reference  of  a
         symbol  name  JSYS, and MACRO assembles in TOPS20 JSYS opcode
         instead of user label address.  By changing  the  label  name
         and  all  its  references in SETSRC, you will get the correct
         assembly.



4.0  INSTALLATION INSTRUCTIONS


The MACRO source file  as  distributed  assembles  and  loads  into  a
sharable  segment.   For this release, MACRO.EXE is being distributed.
Installations without .EXE file support must reload to get MACRO.SHR.

To install MACRO Version 53 on your system, copy the file MACRO.EXE to
SYS:.
MCR53.DOC                                                      Page 27


The distributed version of MACRO.CTL was used  to  first  build  MACRO
using  field image (MACRO 52) MACRO, and then use this created version
to create itself.  The two versions of MACRO V53 were then checked for
inconsistancies.  None were found.

Customers who wish to rebuild MACRO after installing any  changes  can
use  MACRO.CTL  as  a  guide to the building process.  It is unlikely,
however, that the .CTL file can be executed  without  modification  on
most user systems.  In particular, attention should be given to ERSATZ
devices, structure names, PPNs and other such system parameters.

MACRO requires field image HELPER, which is loaded implicitly  via  an
imbedded .REQUIRE pseudo-op in the MACRO source file.



5.0  INTERNAL CHANGES

;Continued Version 52
;553      (22193)   Flag  non-sixbit  in  single-quote  strings   with
                    Q-error
;554      (10382)   Don't replace ^Z with LF unless input DEV is TTY
;555      (10202)   Warn user if code stored before .COMMON
;556      (22425)   Allow  leading  numeric  char  in   arguments   to
                    "SEARCH"
;557      (22491)   Generate -X (where X is relocatable) properly
;560      (22488)   Place all occurences of flags  'INASGN',  'INANGL'
                    under Polish Feature Test
;561      (22490)   Generate -1^!X (where X is relocatable) properly
;562      (22544)   Fix page offset after PRGEND
;563      (22495)   Fix ;;  comments listing when defined under LALL
;564      (22493)   Prevent "IO TO  UNASSIGNED  CHANNEL"  error  after
                    "?POLISH TOO COMPLEX" error message
;565      (22489)   Prevent terminal wait  after  PRGEND  after  being
                    detached or CCONTED
;566      (22498)   Remove Edit 531;  broke listing of embedded  macro
                    calls under XALL
;567      (22500)   Enhancement  EDIT/REQUEST   REL:HELPER,LC   SYMBOL
                    TYPES,U-LC MONTHS
;570      (10570)   Prevent E-errors  after  purge  of  UNDEF  or  EXT
                    symbol
;571      (22676)   Force  HISEG  to  start  on  page  boundary,   not
                    K-boundary
;572      (22748)   Replace Edit 556 by alternate  edit  accomplishing
                    same purpose
;573      (22321)   Fix LOC/RELOC in TWOSEG RELOC programs
;574      (22501)   Add "ILLEGAL SYNTAX  IN  MACRO  DEFINITION"  error
                    message
;575      (22492)   Put all PSECT-RELATED code under FTPSECT switch
;576      (22485)   Fix LABEL+OFFSET accross segments, and when OFFSET
                    > 1000
;577      (22187)   Fix listing of MACRO expansion with  errors  under
                    SALL

;Start of Version 53
MCR53.DOC                                                      Page 28


;600                Turn on FTPSEC
;601                Fix tags in LIT used with PSECTs
;602                Allow .PSECT/.ENDPS in LIT
;603                Force expression evaluation in conditional.
;604                Comment out 1LINE @BOUT20+5 (needs re-work)
;605                Fix bug with wrong RELOC value for PSECT @%SWSG2+6
;606                E-error if FOO##=EXP @ASSIG3+6
;607                Generate a word of 0 for [SIXBIT\\] @SIXB20+
;610                Do expression of Polish symbols from UNV in  PASS2
                    @EVNUM+
;611                Alphabetize .IF/.IFN attribute table.
;612                Fix bug with "IOWD A##,FOO" when used with PSECT
;613                Store current RADIX in CURADX and free  up  RX  as
                    FRR.
;614                Output "#" bin binary listing to  indicate  Polish
                    fixup.
;615                Output number of pages used instead.
;616                Don't  allow  Polish   for   "BLOCK"   &   "RELOC"
                    pseudo-ops.
;617                Don't make  LTAGF  symbols  externals  at  end  of
                    PASS1.
;620                Q-error if externals purged.
;621                Add .IF FOO,REFERENCED,<...>
;622                Fix bug with outputting "#"
;623                Allow expressions of externals and PSECT-SYMBOLS.
;624                Allow Polish with OPDEF
;625                Generate Polish FWF for [A##]
;626                Add .IF FOO,NEEDED,<...>
;627                Update KL instructions
;630                More on Edit 625 to check for  LH=0,INDIRECT,INEX,
                    & POLISH
;631                Generate a set of BLOCK23's before all the symbols
;632                (Same as 577)
;633                Output "#" and  "*"  for  assignments  and  symbol
                    tables.
;634                Allow "A FOO##+1(1)".
;635                Add special chars \' and \" in a macro call.
;636                Allow POLISH and INDEXing
;637                Don't do FWF for OPDEF A[B##]
;640                Save AC FR  on  stack  before  doing  exponent  in
                    number processing.
;641                Check for PSECT when doing FWF @OCTFW+
;642                Set PSECT index to 0 before generating BLOCK 5
;643                Fix bug with FOO##(1)
;644                Fix bug with EXP FOO##,FOO##,FOO##
;645                FWF for undefined symbol in operator field.
;646                Illegal to use PRGEND with PSECT, treat it as end
;647                Output PSECT INDEX in listing
;650      (22327)   Fix disappearing macro calls with FF under SALL
;651      (22226)   Fix variety of listing bugs tied to error-flagging
;652      (22999)   Fix "ENTRY FOO" where FOO is also an OPDEF
;653      (22497)   Flag "VERSION SKEW" if old-style UNV with SYN
;654                Fix typographical error in published Edit 564
;655      (22482)   Fix too many LINES/PAGE  with  XLIST  inside  SALL
                    MACRO
MCR53.DOC                                                      Page 29


;656      (22499)   Fix "?ILL MEM REF"  while  expanding  macro  calls
                    embedded commas
;657      (Q1382)   Extend new MACRO ARG handling to  parenthesized  a
                    ARG string
;660      (23098)   Restore IFE/IFN A## handling to old (pre-52) way
;661      (22515)   Prevent ILL MEM REF on unclosed text in multi-line
                    assignment
;662                Simplify Edit 561
;663      (23170)   Fix lost  errors  in  PASS1  during  line  "IMAGE"
                    typeout
;664                Speed  and  efficiency  enhancements;    ROUTINES:
                    GETCHR,PRINT,CHARAC,READ1A
;665      (23246)   Don't treat leading commas as semicolons
;666                Fix various bugs tied to "LABEL+OFFSET" typeout
;667                Fix bad ASCIZ in  LITERALS  (side-effect  of  Edit
                    661)
;670                Allow >NODDT of OPDEF  (i.e.,  .NODDT  PJRST,CALL,
                    etc.)
;671                Remove Edit 657 (i.e., take familiar path of least
                    resistance with regard to existing programs)
;672                Ignore redundant search ARGs,  add  "Search  Table
                    Overflow" error message
;673      (Q1286)   List CRLFs in parenthesized MACRO ARGs correctly
;674                Give E-error for external array name
;675                Handle INTERN of mixed ARG types correctly
;676                Prevent the use of argumens < 4 to /NNL
;677                Allow  .IF  EXPRESSION,QUALIFIER<CODE>   (omitting
                    comma)
;700                Alter "Core  Allocation  Problem"  error  message,
                    force   reallocation  unless  /U  (memory-resident
                    universals)
;701                Flag non-sixbit  in  SIXBIT  Pseudo-op  correctly,
                    terminating string
;702                Replace  MBR,MBC,MBI  messages  with   ISR,ISC,ISI
                    (syntax checks)
;703      (22939)   Handle comples forward REF of SYM where SYM=POLISH
                    correctly
;704                Fix  bad  CREF  output  when  listing  MACRO  ARGS
                    W/CRLFs and "\"
;705      (23527)   Fix ILL MEM REF with  IFX  <POLISH  SYMBOL>  (side
                    effect of 660)
;706      (22484)   Make    <LH,,POLISH>,<POLISH,,RH>,<POLISH,,POLISH>
                    work
;707                Fix bug with LITERAL PC when doing  PSECT  changes
                    at end.
;710                Get correct relocation when evaluating "!".
;711                Enter Psect-names as external symbols.
;712                Collapse 2 instructions into EXTRN2 routine
;713                Move no UNV search flag into AC FRR.
;714                Reset symbol table pointer when a  tag  has  other
                    use in DIFF PSECTs
;715                Search only current symbol table  in  looking  for
                    VARs.
;716                Reset REL1P pointer at pass initialization
;717                Bug fix with PSECT output format
MCR53.DOC                                                      Page 30


;720                Flag .DIRECT no no ARG with Q-error
;721                Fix bug in Edit 573 with RELOC/RELOC/LOC/RELOC ARG
;722      (10945)   Flag IOWD A,B where A is RELOC with R-error
;723      (10929)   Fix truncating or garbling of long PRINTX text
;724      (23826)   Give  "UNASSIGNED"  error  message  for  undefined
                    symbols   with   unresolved   36BIT  values  (e.g.
                    B=B+1000000).
;725      (23588)   Don't  collapse  literals  which  contain  labels.
                    This  edit  should  be  removed when a facility is
                    added  to  update  label  values   after   literal
                    pooling.
;726                Implement "LTL LITERAL TOO LONG" error message.
;727                Generate correct Polish for <POL>.
;730                Generate correct Polish for <IOWD POL,POL>
;731      BBN       Bug fix with GETCHR
;732                Include S-error in definition of errors.
;733      (24065)   Fix bad entry block  caused  by  bad  SEARCH/ENTRY
                    interaction
;734      (23987)   Handle negative relocation correctly with Polish
;735                Allow  forward-ref   of   tags   in   LIT(generate
                    10-blocks).
;736                Fixup SYMTAB  after  FORWARD-REF  to  USER-DEFINED
                    operator.  (MACRO,OPDEF,SYN)
;737                Fix bug with the new IOWD code.
;740                Check for non-referenced literal tags.
;741                A-error when LH-truncated with RELOC.
;742                VARF (TREF) used with LTAGF mean tag referenced.
;743                Suppress PASS1 IFX V-error.
;744      (Q2191)   Make sure LTGSW gets cleared each time.
;745                Check for SPTR before update in ASSIGN.
;746                Give ERRMSG when MRP points  to  0  due  to  MACRO
                    expansion ERR.
;747                Generate  correct  Polish  for  <E,,K>,<K,,E>,   &
                    <E,,E>.
;750                Fix bug with @POL(K).
;751                <Point K,POL,POL> to use ANGFP routines.
;752                Resolve edit 736 & 675 conflict in OPDEF handling.
;753      (18606)   Prevent extra line listing with FF inside repeat 0
                    or failing conditional.
;754      (22804)   Clear XLIST after END/PRGEND (doesn't affect lits,
                    etc.).
;755      (22442)   Output title ".MAIN" for untitled  PRGEND  modules
                    during RPG assembly.
;756      (24473)   Fix too few lines/listing-page with PRINTX.
;757(Removed)       Make sure ^- has  higher  precedence  over  binary
                    operators.
;760                Output binary on block statement in  a  long  line
                    inside MACRO.
;761      (Q2201)   Fix bug in EOUT that  generated  wrong  count  for
                    block 4.
;762      (Q2204)   E-error for BYTE (N)...POL...  where N .NE.  ^D36.
;763      (Q2211)   Generate block 22 with  symbol  table  instead  of
                    block 23.
;764                Check for internal OPDEF at INDEF.
;765      (Q2195)   Don't generate empty entry block.
MCR53.DOC                                                      Page 31


;766                Same as 733.
;767      (Q2185)   Re-do calculation of RC in EVADR.
;770      (Q2210)   Fix bug with flagging  multiply  defined  tags  in
                    different PSECTS.
;771                Test for NOPSW at closing angle bracket.
;772                Fix bug with referencing Polish OPDEF.
;773                Replace edit 747
;774                Make LABEL+OFFSET hangling consistant.
;775      (Q2200)   Check CPU value before typeout of size info.
;776                Don't do PSECT check for phased label.
;777                Allow BYTE(18) of Polish if half word aligned.
;1000               Add 2 cells  for  building  OPDEF  code  to  avoid
                    problem with nested literals.
;1001               Don't let  MACRO  expansions  change  LABEL+OFFSET
                    settings.
;1002     (Q2235)   Don't store UNV name until it's verified.
;1003     (24751)   Make FF list correctly (supersedes edit 753).
;1004               Minor source changes:  tabs in  long  line,  page,
                    etc.
;1005               Don't generate global request for a  symbol  where
                    symbol=UND.
;1006               Save INOPDF @SQBRK+  to  allow  literal  in  OPDEF
                    definition.
;1007               Give EPP message  due  to  typos  causing  illegal
                    Polish.
;1010               Add a word to differentiate <0,,POL> with <POL>
;1011     (Q2276)   Save INOPDEF @ANGLB+  to  allow  nested  <...>  in
                    OPDEF definition.
;1012               Recover EXTPNT if needed at OP3.
;1013               Move left Polish to  free  Polish  to  free  space
                    before storing the ptr in XWDANG.
;1014               Allow ENTRY, INTERN statements to appear in  diff.
                    PSECT then the tag.
;1015               Fix bug with setting  up  correct  MP  for  macros
                    nested in conditionals.
;1016               Define a relocatble PSECT bit for PSECTS  with  no
                    fixed origin.
;1017               Carry  undefined  bit  accross  assigment   during
                    pass1.
;1020               Modify block 22's and block  23's  and  add  block
                    24's.

;*****End of Revision History*****
MCR53.DOC                                                      Page 32


6.0  SUGGESTIONS

The following is  a  list  of  suggestions  accumulated  from  various
sources.   The  appearance of a suggested change in this list does not
imply any commitment or intent on the part of  DEC  to  implement  any
such change.

     1.  Use a hash table instead of binary search.  Add a  switch  to
         specify the hash size.

     2.  Better core management scheme.

     3.  Search UUOSYM.

     4.  Use MACTEN and JOBDAT.

     5.  Allow curvy brackets to work the same as angle  brackets  < >
         for conditionals, REPEATs, IRPs, etc.

     6.  Add an error file to contain all assembly errors to  be  used
         with /N switch.

     7.  Allow the line  continuation  character  (^_)  to  work  over
         end-of-macro, -IRP, etc.

     8.  Allow more than ten universal files to  be  created  or  read
         during a given assembly.



[End of MCR53.DOC]