home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / sysutl / stepdos.arc / STEPDOS.DOC < prev    next >
Encoding:
Text File  |  1987-11-08  |  6.3 KB  |  125 lines
  1.                               STEPDOS
  2.  
  3.                                 by
  4.  
  5.                             Mike Parker
  6.  
  7.                            CIS 70270,161
  8.  
  9.                              11/07/87
  10.  
  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.  
  23.        ============================================================
  24.                             Program Execution
  25.        ============================================================
  26.  
  27. There is a program included in the STEPDOS.ARC file called DEMO.EXE
  28. that will give a short demonstration of STEPDOS's capabilities.
  29.  
  30. DEMO.EXE does three functions.
  31.    1) Outputs a string using calls to DOS function code 02h (Display Character).
  32.    2) Checks keyboard input status.
  33.    3) Terminates itself.
  34.  
  35.  
  36. For this demonstration first clear the screen by typing CLS <return>.
  37. Make sure DEMO.EXE is in your current directory and type:
  38.     STEPDOS DEMO <return>
  39.  
  40.  
  41. A window will pop up showing something like:
  42.  
  43.    +-----------------------------------------------------------------------+
  44.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  45.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  46.    | 02xx xxxx xxxx xx53 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  47.    |                                                                       |
  48.    |                                                                       |
  49.    | Output Character  Hex 53  ASCII S                                     |
  50.    |                                                                       |
  51.    | Skip Current Function    Return Code    ESC - Non Stop                |
  52.    +-----------------------------------------------------------------------+
  53.  
  54. The xxxx's under the register names above just mean that what you actually
  55. see could be anything, only AH and DL are important right here.
  56.  
  57. Press any key except the 'S', the 'R' or 'ESCAPE' to execute the DOS function.
  58.  
  59. The character 'S' will be displayed at the current cursor position and the
  60. STEPDOS window will come up again with:
  61.  
  62.  
  63.    +-----------------------------------------------------------------------+
  64.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  65.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  66.    | 02xx xxxx xxxx xx54 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  67.    |                                                                       |
  68.    |                                                                       |
  69.    | Output Character  Hex 54  ASCII T                                     |
  70.    |                                                                       |
  71.    | Skip Current Function    Return Code    ESC - Non Stop                |
  72.    +-----------------------------------------------------------------------+
  73.  
  74. Press a key and the 'T' character will appear after the 'S'.
  75. To keep you from having to press a key to display each character of a
  76. potentially long text string use the 'Skip Current Function' option.
  77. This tells STEPDOS to run nonstop as long as the current function (in this
  78. case 02h) is being repeated by the target program.
  79. When a function code other than 02h is executed, STEPDOS will resume display.
  80.  
  81. Now press 'S' to finish displaying the demo string. The following will appear:
  82.  
  83.    +-----------------------------------------------------------------------+
  84.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  85.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  86.    | 0Bxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  87.    |                                                                       |
  88.    |                                                                       |
  89.    | Check Standard Input Status                                           |
  90.    |                                                                       |
  91.    | Skip Current Function    Return Code    ESC - Non Stop                |
  92.    +-----------------------------------------------------------------------+
  93.  
  94.  
  95. To see how the 'Return Code' option works press the 'R' key and you
  96. will see:
  97.  
  98.    +-----------------------------------------------------------------------+
  99.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  100.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  101.    | 0B00 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  102.    |                                                                       |
  103.    |                                                                       |
  104.    | Return Code = 0B00H    Carry Flag = 0   Zero Flag = 1                 |
  105.    |                                                                       |
  106.    |                     Press Any Key To Continue                         |
  107.    +-----------------------------------------------------------------------+
  108.  
  109. This is the result immediately after the INT 21h code is executed.
  110.  
  111. Press any key to see:
  112.  
  113.    +-----------------------------------------------------------------------+
  114.    |  AX   BX   CX   DX   DI   SI   BP   SP   DS   ES   SS   CS   IP   FL  |
  115.    | ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- |
  116.    | 4C00 xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx |
  117.    |                                                                       |
  118.    |                                                                       |
  119.    | Terminate Process With Return Code 00H                                |
  120.    |                                                                       |
  121.    | Skip Current Function    Return Code    ESC - Non Stop                |
  122.    +-----------------------------------------------------------------------+
  123.  
  124. Press a key and STEPDOS will end, returning you to the DOS prompt.
  125.