home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / UTILS / REGTST13 / REGSTEST.DOC < prev   
Text File  |  1992-10-17  |  4KB  |  88 lines
  1.  
  2.                                 REGSTEST
  3.  
  4.                               Version  1.30
  5.                                 (10-18-92)
  6.  
  7.         REGSTEST is a utility program developed to execute interrupts
  8.    on a MS-DOS or PC-DOS system and observe the value of the various
  9.    general purpose registers.  The user has the ability to enter a
  10.    DOS interrupt, set the registers to any value desired, execute the
  11.    interrupt and see the value of the registers and the flags set upon
  12.    returning from the interrupt.  This version of REGSTEST also has
  13.    a 576 byte work area that can be used to pass or obtain information
  14.    from the interrupt.
  15.  
  16.       The available function keys in REGSTEST are:
  17.  
  18.               F1          -   Set the interrupt number
  19.               F2          -   Set the general purpose registers
  20.               F3          -   Set the work area
  21.               F4          -   Clear the area where the cursor is set
  22.                               (i.e., interrut number, registers or work area)
  23.               F5          -   Clear all of the areas
  24.               F7          -   Execute the interrupt specified
  25.               F10         -   Terminate REGSTEST
  26.               TAB         -   Tab to the Next Field
  27.               Left Arrow  -   Move to the Previous Field
  28.               Right Arrow -   Move to the Next Field
  29.               PgDn        -   Next Page of Work Area
  30.               PgUp        -   Previous Page of Work Area
  31.  
  32.  
  33.                           FLAGS AND ERROR INDICATORS
  34.  
  35.           The following flags and error indicators are captured
  36.       and displayed immediately after execution of the specified
  37.       interrupt.
  38.  
  39.            CARRY      -  Set to 1 if an operation generates a carry
  40.                          to or borrow from a destination operand
  41.            INTER      -  Set to 1 if interrupts are recognized and
  42.                          executed as they occur
  43.            PARITY     -  Set to 1 if the low-order bits of the results
  44.                          of an operation contain an even number of bits
  45.            DIRECT     -  Set to 1 which makes string operations process
  46.                          in descending order from high addresses to low
  47.                          addresses
  48.            AUX        -  Similar to the CARRY flag.  This flag is used
  49.                          for binary coded decimal (BCD) arithmeic
  50.            OVFLOW     -  Set to 1 if the operation is too large or too
  51.                          small to fit the destination operand
  52.            ZERO       -  Set to 1 if the result of an operation is
  53.                          zero
  54.            V86        -  Set to 1 if the processor is running in
  55.                          virtual 86 mode (386 processors and above).
  56.            SIGN       -  Set to 0 if high order bit of operation is
  57.                          positive.  Set to 1 if result is negative.
  58.            TRAP       -  If set to 1, the processor generates a single-
  59.                          step interrupt after each instruction.  This
  60.                          feature is used for debugging purposes.
  61.            DIVIDE     -  Set to 1 when a divide instruction is executed
  62.                          and the divisor is 0
  63.  
  64.  
  65.       CAUTION!   Care must be taken when executing interrupts.  This
  66.    program was written for experienced DOS programmers and should be
  67.    used by only those who have experience in executing interrupts.
  68.    In order to minimize the potential system lockups, the following
  69.    interrupt numbers are not executable:
  70.  
  71.      01, 02, 03, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F
  72.      25, 26, 30, 31, 70, 71, 72, 73, 74, 75, 76, 77, EF, F0, FF
  73.  
  74.    If you try to execute one of these interrupts, REGSTEST will
  75.    display "**" where the interrupt number was located.
  76.  
  77.       Some interrupts require the use of a work area to pass or
  78.    obtain information.  You can address the work area from the
  79.    segment and offset values displayed in red in the work area box.
  80.  
  81.  
  82.       This program was written entirely in Assembler and is
  83.    released as a public domain program.
  84.  
  85.       Technical Note:  REGSTEST temporarily replaces INT 00
  86.    interrupt vector (divide exception) during its execution.
  87.    It is restored to its original state at program termination.
  88.