DataMuseum.dk

top - metrics - download

    Length: 10752 (0x2a00)
    Types: TextFile
    Names: »compareman«

└─⟦621cfb9a2⟧ Bits:30002817 RC8000 Dump tape fra HCØ.  Detaljer om "HC8000" projekt.
    └─⟦0364f57e3⟧ 
        └─⟦this⟧ »compareman« 
└─⟦667bb35d6⟧ Bits:30007480 RC8000 Dump tape fra HCØ.
    └─⟦4334b4c0b⟧ 
        └─⟦this⟧ »compareman« 

TextFile

\f





H. C. Ørsted Institute
Computer Department
Universitetsparken 5
DK-2100 København Ø






                     HCØ RC8000 utility programs
                               compare
                            "compareman"









                        Heinrich Bjerregaard
 



















                                               76/12 

                                               September 1976



 

\f





                                                                  1

        The program compares two files, two areas  in  core,  or  a
        file  and  an  area  in core. Depending on the way input is
        specified the comparison is  done  integer  by  integer  or
        textline  by  textline.  On  the latter the input files, of
        course has to be textfiles.
        When two unequal integers are met  they  are  both  printed
        (preceeded  by  an  relative address in a way) given by the
        format specied in the parameterlist.
        When two uneuqal lines are met they are both printed in the
        textform, the first preceeded by an  asterix  '*'  and  the
        second  preceeded  by an exclamation point '!'. If only one
        input source  is  specified  the  program  works  like  the
        fp-utility program print.

        Call:
                      1                              *
             (<file>=)0   compare   <input> (<plist>)0


        <file> is a backing store area, a file descriptor, or a
               nonempty note.
        <input>::= <source>!<source>.<source>!<text>.<text>.text
        <source>::= <addr>!<file>
        <text> is a <file> only containing texts.
        <addr> is an address in corestore.


                       ! binary
                       ! bits.<frac>
                       ! bytes
                       ! integer
                       ! text
                       ! real
                       ! long
        <plist>::=     < code
                       ! max.<i>.<i>
                       ! relative.<i>.<i>
                       ! add.<i>
                       ! sub.<i>
                       ! words.<n>
                       ! cw
                       ! co


        <frac>::= 1!2!3!4!8!<frac>.<frac>
        <i> is an unsigned integer, which is measured in lines when
            the  input source is  <text>.<text>.text,  otherwise in
            bytes.
        <n> is an unsigned integer.

        The  abbrevations  m,  r  and w may be used instead of max,
        relative and words.

        Every line printed is preceed by an address  (line  number)
        definning the word (line) treated relative to the beginning
        of  the source. Normally the address is given in bytes, but
        by means of the parameters cw and co the address  is  given
        in words and in octets, respectively.

\f





                                                                  2

        The standard initial values are:
        ---------------------------------

        <plist>::= text integer code m.10000.4 r.0.0 w.1

        This  means that every integer is, when printed, treated as
        a text string, a signed integer, and as a machine  instruc-
        tion.


        Parameter explanation.
        ---------------------

        binary
                prints  a word in binary form, i.e. one '1' for the
                bit set, otherwise a point.

        bits.<frac>
                prints  a  word  in  unsigned  fractions  given  by
                <frac>.bits.1 is equal to binary.

        bytes
                prints a word as two signed 12 bits integers.

        integer
                prints a word as a signed integer.

        text
                prints a word as a string consisting of  3  charac-
                ters.

        real
                prints two words as a signed real.

        long
                prints two words as a signed long.

        code
                prints a word as a machine instruction.

        max.<i1>.<i2>
                <i1> specifies the maximum number of bytes (lines),
                which should be investigated.
                <i2> specifies the maximum number of bytes (lines),
                which  may be unequal. If only one source parameter
                is specified this parameter need not  be  declared.
                When  either  <i1>  or <i2> is exceeded the program
                terminates.

        relative.<i1>.<i2>
                The number  of  lines  or  bytes  which  should  be
                skipped  before  the comparison starts. If only one
                source parameter is specified then <i2> need not be
                declared.

        add.<i>!sub.<i>
                The specified constant is added/subtracted from the
                relative printed byte, word, or octet  number.  The
                parameter  has only effect, when one source parame-
                ter is specified.


\f





                                                                  3

        words.<n>
                <n> specifies the number of words to be printed  on
                every line.

        cw
                the relative printed address is in words.

                co
                the relative printed address is in octets.


        Alarms from running program:
        ---------------------------

        After an alarm the run is terminated.

        ***compare hard error on <doc>
        status <bits>
                A  hard  error has occured on the document doc. The
                status word is shown in a binary format.

        ***compare lookup <doc> result <i>
                The document <doc> cannot be connected. The  result
                of the monitor procedure lookup is shown.

        ***compare no source
                The parameterlist contains no input source.

        ***compare not a normal text <doc>
                A line consist of more than 768 characters.



        Warnings from running program:
        -----------------------------

        ***compare param no <i>
                A  syntax  error  in the parameterlist is detected.
                The parameter-no is shown.

        References outside core is not checked and  gives  a  break
        0.

        When  the  program  stops  and  the involved files has been
        identical it prints:


                     EQUAL <number of bytes or lines>.


\f





\f

▶EOF◀