home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / DOS_HELP / STPDOS11.ZIP / STEPDOS.DOC < prev   
Encoding:
Text File  |  1987-11-13  |  6.8 KB  |  134 lines
  1.                               STEPDOS
  2.  
  3.                                 by
  4.  
  5.                             Mike Parker
  6.  
  7.                            CIS 70270,161
  8.  
  9.                              11/13/87
  10.                             Version 1.1
  11.  
  12.        ============================================================
  13.                          Program Description
  14.        ============================================================
  15.  
  16. STEPDOS is a program written in assembly language that intercepts DOS
  17. interrupt 21H then executes the target program specified on the command
  18. line as a subprocess. Each time the target program does an 'INT 21H' call,
  19. STEPDOS takes over. A 'pop-up window' is displayed with the values of
  20. all registers and a description of what the DOS call is about to do.
  21.  
  22. STEPDOS detects whether a CGA or Monochrome adapter is installed and will
  23. determine which video page is currently active each time it puts up the
  24. information window.
  25.  
  26.        ============================================================
  27.                             Program Execution
  28.        ============================================================
  29.  
  30. There is a program included in the STEPDOS.ARC file called DEMO.COM
  31. that will give a short demonstration of STEPDOS's capabilities.
  32.  
  33. DEMO.COM does three functions.
  34.   1) Outputs a string using calls to DOS function code 02h (Display Character).
  35.   2) Checks keyboard input status.
  36.   3) Terminates itself.
  37.  
  38.  
  39. For this demonstration first clear the screen by typing CLS <return>.
  40. Make sure DEMO.COM is in your current directory and type:
  41.     STEPDOS DEMO <return>
  42.  
  43.  
  44. A window will pop up showing something like:
  45.  
  46.    +-----------------------------------------------------------------------+
  47.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  48.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  49.    | 02xx xxxx xxxx xx54 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  50.    |                                                                       |
  51.    |                                                                       |
  52.    | Output Character  Hex 54  ASCII T                                     |
  53.    |                                                                       |
  54.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  55.    +-----------------------------------------------------------------------+
  56.  
  57. The xxxx's under the register names above just mean that what you actually
  58. see could be anything, only AH and DL are important right here.
  59.  
  60. Press any key except 'S', 'R', the ARROW keys or 'ESCAPE' to execute the
  61. DOS function.
  62.  
  63. The character 'T' will be displayed at the current cursor position and the
  64. STEPDOS window will come up again with:
  65.  
  66.  
  67.    +-----------------------------------------------------------------------+
  68.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  69.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  70.    | 02xx xxxx xxxx xx68 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  71.    |                                                                       |
  72.    |                                                                       |
  73.    | Output Character  Hex 68  ASCII h                                     |
  74.    |                                                                       |
  75.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  76.    +-----------------------------------------------------------------------+
  77.  
  78. Press a key and the 'h' character will appear after the 'T'.
  79. To keep you from having to press a key to display each character of a
  80. potentially long text string use the 'Skip Current Func' option.
  81. This tells STEPDOS to run nonstop as long as the current function (in this
  82. case 02h) is being repeated by the target program.
  83. When a function code other than 02h is executed, STEPDOS will resume display.
  84.  
  85. Now press 'S' to finish displaying the demo string. The following will appear:
  86.  
  87.    +-----------------------------------------------------------------------+
  88.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  89.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  90.    | 0Bxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  91.    |                                                                       |
  92.    |                                                                       |
  93.    | Check Standard Input Status                                           |
  94.    |                                                                       |
  95.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  96.    +-----------------------------------------------------------------------+
  97.  
  98.  
  99. To see how the 'Return Code' option works press the 'R' key and you
  100. will see:
  101.  
  102.    +-----------------------------------------------------------------------+
  103.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  104.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  105.    | 0B00 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  106.    |                                                                       |
  107.    |                                                                       |
  108.    | Return Code = 0B00H    Carry Flag = 0   Zero Flag = 1                 |
  109.    |                                                                       |
  110.    |                     Press Any Key To Continue                         |
  111.    +-----------------------------------------------------------------------+
  112.  
  113. This is the result immediately after the INT 21h code is executed.
  114.  
  115. Press any key to see:
  116.  
  117.    +-----------------------------------------------------------------------+
  118.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  119.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  120.    | 4C00 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  121.    |                                                                       |
  122.    |                                                                       |
  123.    | Terminate Process With Return Code 00H                                |
  124.    |                                                                       |
  125.    |  Skip Current Func  Return Code  ESC - Non Stop  xxxx - Move Window   |
  126.    +-----------------------------------------------------------------------+
  127.  
  128. If the window is covering up a part of the screen you would like to be
  129. able to see, press one of the four arrow keys on the numeric keypad (UP,
  130. DOWN, LEFT or RIGHT) and the window will move one character position each
  131. time you press the key.
  132.  
  133. Press a key and STEPDOS will end, returning you to the DOS prompt.
  134.