home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / LA / LA023.ZIP / DOSREF17.ZIP / CHAPTER.004 < prev    next >
Text File  |  1990-03-21  |  115KB  |  2,202 lines

  1.  
  2.    **  Programmer's  Technical  Reference  for  MSDOS  and  the  IBM  PC **
  3.                         ┌─────────────────────────────┐
  4.                         │ Shareware Version, 03/21/90 │
  5.                         │  Please Register Your Copy  │
  6.                         └─────────────────────────────┘
  7.                     Copyright (c) 1987, 1990 Dave Williams
  8.  
  9.  
  10.                            C H A P T E R    F O U R
  11.  
  12.                        DOS INTERRUPTS AND FUNCTION CALLS
  13.  
  14.  
  15.  
  16. DOS REGISTERS├─────────────────────────────────────────────────────────────────
  17.  
  18.  DOS uses the following registers, pointers, and flags when it executes 
  19. interrupts and function calls:
  20. ┌───────────────────┬──────────┬───────────────────────────────────────────────┐
  21. │GENERAL REGISTERS  │ register │                  definition                   │
  22. │                   ├──────────┼───────────────────────────────────────────────┤
  23. │                   │    AX    │  accumulator (16 bit)                         │
  24. │                   │    AH    │  accumulator high-order byte (8 bit)          │
  25. │                   │    AL    │  accumulator low order byte (8 bit)           │
  26. │                   │    BX    │  base (16 bit)                                │
  27. │                   │    BH    │  base high-order byte (8 bit)                 │
  28. │                   │    BL    │  base low-order byte (8 bit)                  │
  29. │                   │    CX    │  count (16 bit)                               │
  30. │                   │    CH    │  count high order byte (8 bit)                │
  31. │                   │    CL    │  count low order byte (8 bit)                 │
  32. │                   │    DX    │  data (16 bit)                                │
  33. │                   │    DH    │  date high order byte (8 bit)                 │
  34. │                   │    DL    │  data low order byte (8 bit)                  │
  35. ├───────────────────┼──────────┼───────────────────────────────────────────────┤
  36. │SEGMENT REGISTERS  │ register │                  definition                   │
  37. │                   ├──────────┼───────────────────────────────────────────────┤
  38. │                   │    CS    │  code  segment (16 bit)                       │
  39. │                   │    DS    │  data  segment (16 bit)                       │
  40. │                   │    SS    │  stack segment (16 bit)                       │
  41. │                   │    ES    │  extra segment (16 bit)                       │
  42. ├───────────────────┼──────────┼───────────────────────────────────────────────┤
  43. │INDEX REGISTERS    │ register │                  definition                   │
  44. │                   ├──────────┼───────────────────────────────────────────────┤
  45. │                   │    DI    │  destination index (16 bit)                   │
  46. │                   │    SI    │  stack       index (16 bit)                   │
  47. ├───────────────────┼──────────┼───────────────────────────────────────────────┤
  48. │SEGMENT REGISTERS  │ register │                  definition                   │
  49. │                   ├──────────┼───────────────────────────────────────────────┤
  50. │                   │    CS    │  code  segment (16 bit)                       │
  51. │                   │    DS    │  data  segment (16 bit)                       │
  52. │                   │    SS    │  stack segment (16 bit)                       │
  53. │                   │    ES    │  extra segment (16 bit)                       │
  54. ├───────────────────┼──────────┼───────────────────────────────────────────────┤
  55. │INDEX REGISTERS    │ register │                  definition                   │
  56. │                   ├──────────┼───────────────────────────────────────────────┤
  57. │                   │    DI    │  destination index (16 bit)                   │
  58. │                   │    SI    │  stack       index (16 bit)                   │
  59. ├───────────────────┼──────────┼───────────────────────────────────────────────┤
  60. │POINTERS           │ register │                  definition                   │
  61. │                   ├──────────┼───────────────────────────────────────────────┤
  62. │                   │    SP    │  stack pointer (16 bit)                       │
  63. │                   │    BP    │  base pointer (16 bit)                        │
  64. │                   │    IP    │  instruction pointer (16 bit)                 │
  65. ├───────────────────┴──────────┴───────────────────────────────────────────────┤
  66. │FLAGS                   AF, CF, DF, IF, OF, PF, SF, TF, ZF                    │
  67. └──────────────────────────────────────────────────────────────────────────────┘
  68.  
  69.  These registers, pointers, and flags are "lowest common denominator" 8088-8086 
  70. CPU oriented. DOS makes no attempt to use any of the special or enhanced 
  71. instructions availible on the later CPUs which will execute 8088 code, such as 
  72. the 80186, 80286, 80386, or NEV V20, V30, V40, or V50.
  73.  
  74.  When DOS takes control after a function call, it switches to an internal 
  75. stack. Registers which are not used to return information (other than AX) are 
  76. preserved. The calling program's stack must be large enough to accomodate the 
  77. interrupt system - at least 128 bytes in addition to other interrupts. 
  78.  DOS actually maintains three stacks -
  79. stack 1: 384 bytes (in DOS 3.1)
  80.          for functions 00h and for 0Dh and up, and for ints 25h and 26h.
  81.  
  82. stack 2: 384 bytes (in DOS 3.1)
  83.          for function calls 01h through 0Ch.
  84.  
  85. stack 3: 48 bytes (in DOS 3.1)
  86.          for functions 0Dh and above. This stack is the initial stack used by
  87.          the int 21h handler before it decides which of the other two to use.
  88.          It is also used by function 59h (get extended error), and 01h to 0Ch if
  89.          they are called during an int 24h (critical error) handler. Functions
  90.          33h (get/set break flag), 50h (set process ID), 51h (get process ID)
  91.          and 62h (get PSP address) do not use any DOS stack under DOS 3.x
  92.          (under 2.x, 50h and 51h use stack number 2). 
  93.  
  94.  IBM and Microsoft made a change back in DOS 3.0 or 3.1 to reduce the size of
  95. DOS. They reduced the space allocated for scratch areas when interrupts are
  96. being processed. The default seems to vary with the DOS version and the
  97. machine, but 8 stack frames seems to ring a bell. That means that if you get
  98. more than 8 interrupts at the same time, clock, disk, printer spooler,
  99. keyboard, com port, etc., the system will crash. It seems to happen usually on
  100. a network. STACKS=16,256 means allow 16 interrupts to interrupt each other and
  101. allow 256 bytes for each for scratch area. Eight is marginal.
  102.  
  103.  DOS 3.2 does some different stack switching than previous versions. The
  104. interrupts which are switched are 02h, 08h, 09h, 0Ah, 0Bh, 0Ch, 0Dh, 0Eh, 70h,
  105. 72h, 73h, 74h, 75h, 76h, and 77h. DOS 3.2 has a special check in the
  106. initialization code for a PCjr and don't enable stack switching on that machine.
  107.  
  108.  
  109.  
  110. INTERRUPTS├────────────────────────────────────────────────────────────────────
  111.  
  112.  Microsoft recommends that a program wishing to examine or set the contents of
  113. any interrupt vector use the DOS function calls 35h and 25h provided for those 
  114. purposes and avoid referencing the interrupt vector locations directly.
  115.  DOS reserves interrupt numbers 20h to 3Fh for its own use. This means absolute 
  116. memory locations 80h to 0FFh are reserved by DOS. The defined interrupts are as 
  117. follows with all values in hexadecimal.
  118.  
  119.  
  120. ┌─────────────────────────────────────────────────────────────────────────────┐
  121. │Interrupt 21h  Function Call Request                                         │
  122. └─────────────────────────────────────────────────────────────────────────────┘
  123. (0:0084h)
  124.  DOS provides a wide variety of function calls for character device I/O, file 
  125. management, memory management, date and time functions,execution of other 
  126. programs, and more. They are grouped as follows:
  127.  
  128.           call              description
  129.         00h             program terminate
  130.         01h-0Ch         character device I/O, CP/M compatibility format
  131.         0Dh-24h         file management,      CP/M compatibility format
  132.         25h-26h         nondevice functions,  CP/M compatibility format
  133.         27h-29h         file management,      CP/M compatibility format
  134.         2Ah-2Eh         nondevice functions,  CP/M compatibility format
  135.         2Fh-38h         extended functions
  136.         39h-3Bh         directory group
  137.         3Ch-46h         extended file management
  138.         47h             directory group
  139.         48h-4Bh         extended memory management
  140.         54h-57h         extended functions
  141.         5Eh-5Fh         networking
  142.         60h-62h         extended functions
  143.         63h-66h         enhanced foreign language support
  144.  
  145.  
  146. List of DOS services:   * = undocumented
  147.         00h     terminate program
  148.         01h     get keyboard input 
  149.         02h     display character to STDIO
  150.         03h     get character from STDAUX
  151.         04h     output character to STDAUX
  152.         05h     output character to STDPRN
  153.         06h     direct console I/O - keyboard to screen
  154.         07h     get char from std I/O without echo
  155.         08h     get char from std I/O without echo, checks for ^C
  156.         09h     display a string to STDOUT
  157.         0Ah     buffered keyboard input
  158.         0Bh     check STDIN status
  159.         0Ch     clear keyboard buffer and invoke keyboard function
  160.         0Dh     flush all disk buffers
  161.         0Eh     select disk
  162.         0Fh     open file with File Control Block
  163.         10h     close file opened with File Control Block
  164.         11h     search for first matching file entry
  165.         12h     search for next matching file entry
  166.         13h     delete file specified by File Control Block
  167.         14h     sequential read from file specified by File Control Block
  168.         15h     sequential write to file specified by File Control Block
  169.         16h     find or create firectory entry for file
  170.         17h     rename file specified by file control block
  171.         18h*    unknown
  172.         19h     return current disk drive
  173.         1Ah     set disk transfer area (DTA)
  174.         1Bh     get current disk drive FAT
  175.         1Ch     get disk FAT for any drive
  176.         1Dh*    unknown
  177.         1Eh*    unknown
  178.         1Fh*    read DOS disk block, default drive
  179.         20h*    unknown
  180.         21h     random read from file specified by FCB
  181.         22h     random write to file specified by FCB
  182.         23h     return number of records in file specified by FCB
  183.         24h     set relative file record size field for file specified by FCB
  184.         25h     set interrupt vector
  185.         26h     create new Program Segment Prefix (PSP)
  186.         27h     random file block read from file specified by FCB
  187.         28h     random file block write to file specified by FCB
  188.         29h     parse the command line for file name
  189.         2Ah     get the system date
  190.         2Bh     set the system date
  191.         2Ch     get the system time
  192.         2Dh     set the system time
  193.         2Eh     set/clear disk write VERIFY
  194.         2Fh     get the Disk Transfer Address (DTA)
  195.         30h     get DOS version number
  196.         31h     TSR, files opened remain open
  197.         32h*    read DOS Disk Block
  198.         33h     get or set Ctrl-Break
  199.         34h*    INDOS  Critical Section Flag
  200.         35h     get segment and offset address for an interrupt
  201.         36h     get free disk space
  202.         37h*    get/set option marking character (SWITCHAR)
  203.         38h     return country-dependent information
  204.         39h     create subdirectory
  205.         3Ah     remove subdirectory
  206.         3Bh     change current directory
  207.         3Ch     create and return file handle
  208.         3Dh     open file and return file handle
  209.         3Eh     close file referenced by file handle
  210.         3Fh     read from file referenced by file handle
  211.         40h     write to file referenced by file handle
  212.         41h     delete file
  213.         42h     move file pointer (move read-write pointer for file)
  214.         43h     set/return file attributes
  215.         44h     device IOCTL (I/O control) info
  216.         45h     duplicate file handle
  217.         46h     force a duplicate file handle
  218.         47h     get current directory
  219.         48h     allocate memory
  220.         49h     release allocated memory
  221.         4Ah     modify allocated memory
  222.         4Bh     load or execute a program
  223.         4Ch     terminate prog and return to DOS
  224.         4Dh     get return code of subprocess created by 4Bh
  225.         4Eh     find first matching file
  226.         4Fh     find next matching file
  227.         50h*    set new current Program Segment Prefix (PSP)
  228.         51h*    puts current PSP into BX
  229.         52h*    pointer to the DOS list of lists
  230.         53h*    translates BPB (Bios Parameter Block, see below)
  231.         54h     get disk verification status (VERIFY)
  232.         55h*    create PSP: similar to function 26h
  233.         56h     rename a file
  234.         57h     get/set file date and time
  235.         58h     get/set allocation strategy             (DOS 3.x)
  236.         59h     get extended error information
  237.         5Ah     create a unique filename
  238.         5Bh     create a DOS file
  239.         5Ch     lock/unlock file contents
  240.         5Dh*    network
  241.         5Eh*    network printer
  242.         5Fh*    network redirection   
  243.         60h*    parse pathname
  244.         61h*    unknown
  245.         62h     get program segment prefix (PSP)
  246.         63h*    get lead byte table                     (DOS 2.25)
  247.         64h*    unknown
  248.         65h     get extended country information        (DOS 3.3)
  249.         66h     get/set global code page table          (DOS 3.3)
  250.         67h     set handle count                        (DOS 3.3)
  251.         68h     commit file                             (DOS 3.3)
  252.         69h     disk serial number                      (DOS 4.0)
  253.         6Ah     unknown
  254.         6Bh     unknown
  255.         6Ch     extended open/create                    (DOS 4.0)
  256.  
  257.  
  258. CALLING THE DOS SERVICES├──────────────────────────────────────────────────────
  259.  
  260.  The DOS services are invoked by placing the number of the desired function in 
  261. register AH, subfunction in AL, setting the other registers to any specific 
  262. requirements of the function, and invoking int 21h. 
  263.  
  264.  On return, the requested service will be performed if possible. Most codes 
  265. will return an error; some return more information. Details are contained in 
  266. the listings for the individual functions. Extended error return may be 
  267. obtained by calling function 59h (see 59h).
  268.  
  269.  Register settings listed are the ones used by DOS. Some functions will return 
  270. with garbage values in unused registers. Do not test for values in unspecified 
  271. registers; your program may exhibit odd behavior.
  272.  
  273.  DS:DX pointers are the data segment register (DS) indexed to the DH and DL
  274. registers (DX). DX always contains the offset address, DS contains the segment 
  275. address.
  276.  
  277.  The File Control Block services (FCB services) were part of DOS 1.0. Since 
  278. the release of DOS 2.0, Microsoft has recommended that these services not be 
  279. used. A set of considerably more enhanced services (handle services) were 
  280. introduced with DOS 2.0. The handle services provide support for wildcards and 
  281. subdirectories, and enhanced error detection via function 59h.
  282.  
  283.  The data for the following calls was compiled from various Intel, Microsoft, 
  284. IBM, and other publications. There are many subtle differences between MSDOS 
  285. and PCDOS and between the individual versions. Differences between the 
  286. versions are noted as they occur.
  287.  
  288.  There are various ways of calling the DOS functions. For all methods, the
  289. function number is loaded into register AH, subfunctions and/or parameters are
  290. loaded into AL or other registers, and call int 21 by one of the following 
  291. methods:
  292.  A) call interrupt 21h directly  (the recommended procedure)
  293.  B) perform a long call to offset 50h in the program's PSP.
  294.      1) This method will not work under DOS 1.x
  295.      2) Though recommended by Microsoft for DOS 2.0, this method takes more
  296.         time and is no longer recommended.
  297.  C) place the function number in CL and perform an intrasegment call to 
  298.     location 05h in the current code segment. This location contains a long
  299.     call to the DOS function dispatcher. 
  300.      1) IBM recommends this method be used only when using existing programs 
  301.         written for different calling conventions. (such as converting CP/M
  302.         programs). This method should be avoided unless you have some specific
  303.         use for it.
  304.      2) AX is always destroyed by this method.
  305.      3) This method is valid only for functions 00h-24h.
  306.  
  307.  There are also various ways of exiting from a program. (assuming it is not
  308. intended to be a TSR). All methods except call 4Ch must ensure that the 
  309. segment register contains the segment address of the PSP.
  310.  A) Interrupt 21h, function 4Ch (Terminate with Result Code). This is the
  311.     "official" recommended method of returning to DOS.
  312.  B) Interrupt 21h, function 00h (Exit Program). This is the early style
  313.     int 21 function call. It simply calls int 20h.
  314.  C) Interrupt 20h (Exit).
  315.  D) A JMP instruction to offset 00h (int 20h vector) in the Program Segment
  316.     Prefix. This is just a roundabout method to call int 20h. This method
  317.     was set up in DOS 1.0 for ease of conversion for CP/M programs. It is no
  318.     longer recommended for use.
  319.  E) A JMP instruction to offset 05h (int 21 vector) in the Program Segment
  320.     Prefix, with AH set to 00h or 4Ch. This is another CP/M type function.
  321.  
  322.  
  323.  
  324.  
  325. INT 21H   DOS services
  326.           Function (hex)
  327.  
  328. * Indicates Functions not documented in the IBM DOS Technical Reference.
  329.  Note some functions have been documented in other Microsoft or licensed OEM
  330. documentation.
  331.  
  332.  
  333. Function  00h   Terminate Program
  334.       Ends program, updates, FAT, flushes buffers, restores registers
  335. entry   AH      00h
  336.         CS      segment address of PSP
  337. return  none
  338. note 1) Program must place the segment address of the PSP control block in CS 
  339.         before calling this function.                       
  340.      2) The terminate, ctrl-break,and critical error exit addresses (0Ah, 0Eh, 
  341.         12h) are restored to the values they had on entry to the terminating
  342.         program, from the values saved in the program segment prefix at 
  343.         locations PSP:000Ah, PSP:000Eh, and PSP:0012h. 
  344.      3) All file buffers are flushed and the handles opened by the process are 
  345.         closed. 
  346.      4) Any files that have changed in length and are not closed are not 
  347.         recorded properly in the directory. 
  348.      5) Control transfers to the terminate address.
  349.      6) This call performs exactly the same function as int 20h.
  350.      7) All memory used by the program is returned to DOS.
  351.  
  352.  
  353. Function  01h     Get Keyboard Input
  354.         Waits for char at STDIN (if nescessary), echoes to STDOUT
  355. entry   AH      01h
  356. return  AL      ASCII character from STDIN (8 bits)
  357. note 1) Checks char for Ctrl-C, if char is Ctrl-C, executes int 23h.
  358.      2) For function call 06h, extended ASCII codes require two function calls. 
  359.         The first call returns 00h as an indicator that the next call will be an
  360.         extended ASCII code.
  361.      3) Input and output are redirectable. If redirected, there is no way to 
  362.         detect EOF.
  363.  
  364.  
  365. Function  02h   Display Output
  366.       Outputs char in DL to STDOUT
  367. entry   AH      02h
  368.         DL      8 bit data (usually ASCII character)
  369. return  none
  370. note 1) If char is 08 (backspace) the cursor is moved 1 char to the left 
  371.         (nondestructive backspace).
  372.      2) If Ctrl-C is detected after input, int 23h is executed.
  373.      3) Input and output are redirectable. If redirected, there is no way to 
  374.         detect disk full.
  375.  
  376.  
  377. Function  03h   Auxiliary Input
  378.       Get (or wait until) character from STDAUX
  379. entry   AH      03h
  380. return  AL      char from auxiliary device
  381. note 1) AUX, COM1, COM2 is unbuffered and not interrupt driven
  382.      2) This function call does not return status or error codes. For greater 
  383.         control it is recommended that you use ROM BIOS routine (int 14h) or 
  384.         write an AUX device driver and use IOCTL.
  385.      3) At startup, PC-DOS initializes the first auxiliary port (COM1) to 2400 
  386.         baud, no parity, one stop bit, and an 8-bit word. MSDOS may differ.
  387.      4) If Ctrl-C is has been entered from STDIN, int 23h is executed.
  388.  
  389.  
  390. Function  04h   Auxiliary Output
  391.       Write character to STDAUX
  392. entry   AH      04h
  393.         DL      char to send to AUX
  394. return  none
  395. note 1) This function call does not return status or error codes. For greater 
  396.         control it is recommended that you use ROM BIOS routine (int 14h) or 
  397.         write an AUX device driver and use IOCTL.
  398.      2) If Ctrl-C is has been entered from STDIN, int 23h is executed.
  399.      3) Default is COM1 unless redirected by DOS.
  400.      4) If the device is busy, this function will wait until it is ready.
  401.  
  402.  
  403. Function  05h   Printer Output
  404.       Write character to STDPRN
  405. entry   AL      05h
  406.         DL      character to send
  407. return  none
  408. note 1) If Ctrl-C is has been entered from STDIN, int 23h is executed.
  409.      2) Default is PRN or LPT1 unless redirected with the MODE command.
  410.      3) If the printer is busy, this function will wait until it is ready.
  411.      
  412.  
  413. Function  06h   Direct Console I/O
  414.       Get character from STDIN; echo character to STDOUT
  415. entry   AH      06h
  416.         DL      0FFh for console input, or 00h-0FEh for console output
  417. return  ZF      set   (1) = no character
  418.                 clear (0) = character recieved
  419.         AL      character
  420. note 1) Extended ASCII codes require two function calls. The first call returns
  421.         00h to indicate the next call will return an extended code.
  422.      2) If DL is not 0FFh, DL is assumed to have a valid character that is 
  423.         output to STDOUT. 
  424.      3) This function does not check for Ctrl-C or Ctrl-PrtSc.
  425.      4) Does not echo input to screen
  426.      5) If I/O is redirected, EOF or disk full cannot be detected.
  427.  
  428.  
  429. Function  07h   Direct Console Input Without Echo         (does not check BREAK)
  430.       Get or wait for char at STDIN, returns char in AL
  431. entry   AH      07h
  432. return  AL      character from standard input device
  433. note 1) Extended ASCII codes require two function calls. The first call returns
  434.         00h to indicate the next call will return an extended code.
  435.      2) No checking for Ctrl-C or Ctrl-PrtSc is done.
  436.      3) Input is redirectable.
  437.  
  438.  
  439. Function  08h   Console Input Without Echo                (checks BREAK)
  440.       Get or Wait for char at STDIN, return char in AL
  441. entry   AH      08h
  442. return  AL      char from standard input device
  443. note 1) Char is checked for ctrl-C. If ctrl-C is detected, executes int 23h.
  444.      2) For function call 08h, extended ASCII characters require two function 
  445.         calls. The first call returns 00h to signify an extended ASCII code. 
  446.         The next call returns the actual code.
  447.      3) Input is redirectable. If redirected, there is no way to check EOF.
  448.  
  449.  
  450. Function  09h   Print String
  451.       Outputs Characters in the Print String to the STDOUT
  452. entry   AH      09h
  453.         DS:DX   pointer to the Character String to be displayed
  454. return  none                                                       
  455. note 1) The character string in memory must be terminated by a $ (24h)
  456.         The $ is not displayed.
  457.      2) Output to STDOUT is the same as function call 02h.
  458.  
  459.  
  460. Function  0Ah   Buffered Keyboard Input
  461.       Reads characters from STDIN and places them in the buffer beginning
  462.       at the third byte.
  463. entry   AH      0Ah
  464.         DS:DX   pointer to an input buffer
  465. return  none
  466. note 1) Min buffer size = 1, max = 255
  467.      2) Char is checked for ctrl-C. If ctrl-C is detected, executes int 23h.
  468.      3) Format of buffer DX:
  469.         byte       contents
  470.          1      Maximum number of chars the buffer will take, including CR.
  471.                 Reading STDIN and filling the buffer continues until a carriage
  472.                 return (<Enter> or 0Dh) is read. If the buffer fills to one less
  473.                 than the maximum number the buffer can hold, each additional 
  474.                 number read is ignored and ASCII 7 (BEL) is output to the 
  475.                 display until a carriage return is read. (you must set this
  476.                 value)
  477.          2      Actual number of characters received, excluding the carriage
  478.                 return, which is always the last character. (the function sets
  479.                 this value)
  480.          3-n    Characters received are placed into the buffer starting here.
  481.                 Buffer must be at least as long as the number in byte 1.
  482.      4) Input is redirectable. If redirected, there is no way to check EOF.
  483.      5) The string may be edited with the standard DOS editing commands as it
  484.         is being entered.
  485.      6) Extended ASCII characters are stored as 2 bytes, the first byte being 
  486.         zero.
  487.  
  488.  
  489. Function  0Bh   Check Standard Input (STDIN) status
  490.       Checks for character availible at STDIN 
  491. entry   AH      0Bh
  492. return  AL      0FFh    if a character is availible from STDIN
  493.                 00h     if no character is availible from STDIN
  494. note 1) Checks for Ctrl-C. If Ctrl-C is detected, int 23h is executed
  495.      2) Input can be redirected.
  496.      3) Checks for character only, it is not read into the application
  497.      4) IBM reports that this call does not work properly under the DOSSHELL
  498.         program in DOS 4.00 and 4.01. DOSSHELL will return all zeroes. This
  499.         function works correctly from the command line or application.
  500.  
  501.  
  502. Function  0Ch   Clear Keyboard Buffer & Invoke a Keyboard Function       (FCB)
  503.       Dumps buffer, executes function in AL (01h,06h,07h,08h,0Ah only)
  504. entry   AH      0Ch
  505.         AL      function number (must be 01h, 06h, 07h, 08h, or 0Ah)
  506. return  AL      00h     buffer was flushed, no other processing performed
  507.                 other   any other value has no meaning
  508. note 1) Forces system to wait until a character is typed. 
  509.      2) Flushes all typeahead input, then executes function specified by AL (by
  510.         moving it to AH and repeating the int 21 call).
  511.      3) If AL contains a value not in the list above, the keyboard buffer is
  512.         flushed and no other action is taken.
  513.  
  514.  
  515. Function  0Dh   Disk Reset
  516.       Flushes all currently open file buffers to disk
  517. entry   AH      0Dh
  518. return          none
  519. note 1) Does not close files. Does not update directory entries; files changed
  520.         in size but not closed are not properly recorded in the directory
  521.      2) Sets DTA address to DS:0080h
  522.      3) Should be used before a disk change, Ctrl-C handlers, and to flush
  523.         the buffers to disk.
  524.      
  525.  
  526. Function  0Eh   Select Disk
  527.       Sets the drive specified in DL (if valid) as the default drive
  528. entry   AL      0Eh
  529.         DL      new default drive number (0=A:,1=B:,2=C:,etc.)
  530. return  AL      total number of logical drives (not nescessarily physical)
  531. note 1) For DOS 1.x and 2.x, the minimum value for AL is 2.
  532.      2) For DOS 3.x and 4.x, the minimum value for AL is 5.
  533.      3) The drive number returned is not nescessarily a valid drive.
  534.      4) For DOS 1.x: 16 logical drives are availible, A-P.
  535.         For DOS 2.x: 63 logical drives are availible. (Letters are only used for
  536.                      the first 26 drives. If more than 26 logical drives are
  537.                      used, further drive letters will be other ASCII characters
  538.                      ie {,], etc.
  539.         For DOS 3.x: 26 logical drives are availible, A-Z.
  540.         For DOS 4.x: 26 logical drives are availible, A-Z.
  541.  
  542.  
  543. Function  0Fh   Open Disk File                                            (FCB)
  544.       Searches current directory for specified filename and opens it
  545. entry   AH      0Fh
  546.         DS:DX   pointer to an unopened FCB
  547. return  AL      00h     if file found
  548.                 0FFh    if file not not found
  549. note 1) If the drive code was 0 (default drive) it is changed to the actual 
  550.         drive used (1=A:,2=B:,3=C:, etc). This allows changing the default drive
  551.         without interfering with subsequent operations on this file. 
  552.      2) The current block field (FCB bytes C-D, offset 0Ch) is set to zero. 
  553.      3) The size of the record to be worked with (FCB bytes E-F, offset 0Eh) is
  554.         set to the system default of 80h. The size of the file (offset 10h) and
  555.         the date (offset 14h) are set from information obtained in the root
  556.         directory. You can change the default value for the record size (FCB
  557.         bytes E-F) or set the random record size and/or current record field.
  558.         Perform these actions after the open but before any disk operations.
  559.      4) The file is opened in compatibility mode. 
  560.      5) Microsoft recommends handle function call 3Dh be used instead.
  561.      6) This call is also used by the APPEND command in DOS 3.2+
  562.      7) Before performing a sequential disk operation on the file, you must 
  563.         set the Current Record field (offset 20h). Before performing a random 
  564.         disk operation on the file, you must set the Relative Record field
  565.         (offset 21h). If the default record size of 128 bytes is incorrect, set
  566.         it to the correct value.
  567.  
  568.  
  569. Function  10h  Close File                                              (FCB)
  570.      Closes a File After a File Write 
  571. entry   AH      10h
  572.         DS:DX   pointer to an opened FCB
  573. return  AL      00h     if the file is found and closed
  574.                 0FFh    if the file is not found in the current directory
  575. note 1) This function call must be done on open files that are no longer needed,
  576.         and after file writes to insure all directory information is updated. 
  577.      2) If the file is not found in its correct position in the current 
  578.         directory, it is assumed that the diskette was changed and AL returns 
  579.         0FFh. This error return is reportedly not completely reliable with DOS
  580.         version 2.x.
  581.      3) If found, the directory is updated to reflect the status in the FCB, the
  582.         buffers to that file are flushed, and AL returns 00h.
  583.  
  584.  
  585. Function  11h   Search For First Matching Entry                           (FCB)
  586.       Searches current disk & directory for first matching filename
  587. entry   AH      11h
  588.         DS:DX   pointer to address of FCB
  589. return  AL      00h     successful match
  590.                 0FFh    no matching filename found
  591. note 1) The FCB may contain the wildcard character ? under Dos 2.x, and ? or * 
  592.         under 3.x and 4.x.
  593.      2) The original FCB at DS:DX contains information to continue the search
  594.         with function 12h, and should not be modified.
  595.      3) If a matching filename is found, AL returns 00h and the locations at the
  596.         Disk Transfer Address are set as follows:
  597.         a) If the FCB provided for searching was an extended FCB, then the first
  598.            byte at the disk transfer address is set to 0FFh followed by 5 bytes
  599.            of zeroes, then the attribute byte from the search FCB, then the 
  600.            drive number used (1=A, 2=B, etc) then the 32 bytes of the directory
  601.            entry. Thus, the disk transfer address contains a valid unopened FCB
  602.            with the same search attributes as the search FCB.
  603.         b) If the FCB provided for searching was a standard FCB, then the first 
  604.            byte is set to the drive number used (1=A,2=b,etc), and the next 32 
  605.            bytes contain the matching directory entry. Thus, the disk transfer 
  606.            address contains a valid unopened normal FCB.
  607.      4) If an extended FCB is used, the following search pattern is used:
  608.         a) If the FCB attribute byte is zero, only normal file entries are 
  609.            found. Entries for volume label, subdirectories, hidden or system 
  610.            files, are not returned.
  611.         b) If the attribute byte is set for hidden or system files, or 
  612.            subdirectory entries, it is to be considered as an inclusive search.
  613.            All normal file entries plus all entries matching the specified 
  614.            attributes are returned. To look at all directory entries except the
  615.            volume label, the attribute byte may be set to hidden + system + 
  616.            directory (all 3 bits on).
  617.         c) If the attribute field is set for the volume label, it is considered
  618.            an exclusive search, and ONLY the volume label entry is returned.
  619.      5) This call is also used by the APPEND command in DOS 3.2+
  620.  
  621.  
  622. Function  12h   Search For Next Entry Using FCB                          (FCB)
  623.       Search for next matching filename
  624. entry   AH      12h 
  625.         DS:DX   pointer to the unopened FCB specified from the previous Search
  626.                 First (11h) or Search Next (12h)
  627. return  AL      00h     if matching filename found
  628.                 0FFh    if matching filename was not found
  629. note 1) After a matching filename has been found using function call 11h, 
  630.         function 12h may be called to find the next match to an ambiguous 
  631.         request. For DOS 2.x, ?'s are allowed in the filename. For DOS 3.x 
  632.         and 4.x, global (*) filename characters are allowed.
  633.      2) The DTA contains info from the previous Search First or Search Next. 
  634.      3) All of the FCB except for the name/extension field is used to keep 
  635.         information nescessary for continuing the search, so no disk operations 
  636.         may be performed with this FCB between a previous function 11h or 12h 
  637.         call and this one.
  638.      4) If the file is found, an FCB is created at the DTA address and set up to
  639.         open or delete it.
  640.  
  641.  
  642. Function  13h   Delete File Via FCB                                       (FCB)
  643.       Deletes file specified in FCB from current directory
  644. entry   AH      13h
  645.         DS:DX   pointer to address of FCB
  646. return  AL      00h     file deleted
  647.                 0FFh    if file not found or was read-only
  648. note 1) All matching current directory entries are deleted. The global filename 
  649.         character "?" is allowed in the filename.
  650.      2) Will not delete files with read-only attribute set
  651.      3) Close open files before deleting them.
  652.      4) Requires Network Access Rights
  653.  
  654.  
  655. Function  14h   Sequential Disk File Read                                 (FCB)
  656.       Reads record sequentially from disk via FCB
  657. entry   AH  14h
  658.         DS:DX   pointer to an opened FCB
  659. return  AL      00h     successful read
  660.                 01h     end of file (no data read)
  661.                 02h     Data Transfer Area too small for record size specified
  662.                         or segment overflow
  663.                 03h     partial record read, EOF found
  664. note 1) The record size is set to the value at offset 0Eh in the FCB.
  665.      2) The record pointed to by the Current Block (offset 0Ch) and the Current
  666.         Record (offset 20h) fields is loaded at the DTA, then the Current Block
  667.         and Current Record fields are incremented.
  668.      3) The record is read into memory at the current DTA address as specified 
  669.         by the most recent call to function 1Ah. If the size of the record and
  670.         location of the DTA are such that a segment overflow or wraparound would
  671.         occur, the error return is set to AL=02h
  672.      4) If a partial record is read at the end of the file, it is passed to the
  673.         requested size with zeroes and the error return is set to AL=03h.
  674.  
  675.  
  676. Function  15h   Sequential Disk Write                                     (FCB)
  677.       Writes record specified by FCB sequentially to disk
  678. entry   AH      15h
  679.         DS:DX   pointer to address of FCB 
  680. return  AL      00h     successful write
  681.                 01h     diskette full, write canceled
  682.                 02h     disk transfer area (DTA) too small or segment wrap
  683. note 1) The data to write is obtained from the disk transfer area
  684.      2) The record size is set to the value at offset 0Eh in the FCB.
  685.      3) This service cannot write to files set as read-only
  686.      4) The record pointed to by the Current Block (offset 0Ch) and the Current
  687.         Record (offset 20h) fields is loaded at the DTA, then the Current Block
  688.         and Current Record fields are incremented.
  689.      5) If the record size is less than a sector, the data in the DTA is written
  690.         to a buffer; the buffer is written to disk when it contains a full 
  691.         sector of data, the file is closed, or a Reset Disk (function 0Dh) is
  692.         issued.
  693.      6) The record is written to disk at the current DTA address as specified 
  694.         by the most recent call to function 1Ah. If the size of the record and
  695.         location of the DTA are such that a segment overflow or wraparound would
  696.         occur, the error return is set to AL=02h
  697.  
  698.  
  699. Function  16h   Create A Disk File                                        (FCB)
  700.       Search and open or create directory entry for file
  701. entry   AH      16h
  702.         DS:DX   pointer to an FCB
  703. return  AL      00h     successful creation
  704.                 0FFh    no room in directory
  705. note 1) If a matching directory entry is found, the file is truncated to zero
  706.         bytes.
  707.      2) If there is no matching filename, a filename is created.
  708.      3) This function calls function 0Fh (Open File) after creating or 
  709.         truncating a file.
  710.      4) A hidden file can be created by using an extended FCB with the attribute
  711.         byte (offset FCB-1) set to 2.
  712.  
  713.  
  714. Function  17h   Rename File Specified by File Control Block              (FCB)
  715.       Renames file in current directory
  716. entry   AH      17h
  717.         DS:DX   pointer to an FCB (see note 4)
  718. return  AL      00h     successfully renamed
  719.                 0FFh    file not found or filename already exists
  720. note 1) This service cannot rename read-only files
  721.      2) The "?" wildcard may be used.
  722.      3) If the "?" wildcard is used in the second filename, the corresponding 
  723.         letters in the filename of the directory entry are not changed.
  724.      4) The FCB must have a drive number, filename, and extension in the usual
  725.         position, and a second filename starting 6 bytes after the first, at 
  726.         offset 11h.
  727.      5) The two filenames cannot have the same name.
  728.      6) FCB contains new name starting at byte 17h.
  729.  
  730.  
  731. Function  18h  Internal to DOS
  732.  *   Unknown
  733. entry   AH      18h
  734. return  AL      0
  735.  
  736.  
  737. Function  19h   Get Current Disk Drive
  738.       Return designation of current default disk drive
  739. entry   AH      19h
  740. return  AL      current default drive (0=A, 1=B,etc.)  
  741. note    Some other DOS functions use 0 for default, 1=A, 2=B, etc.
  742.  
  743.  
  744. Function  1Ah   Set Disk Transfer Area Address (DTA) 
  745.       Sets DTA address to the address specified in DS:DX
  746. entry   AH      1Ah
  747.         DS:DX   pointer to buffer
  748. return  none
  749. note 1) The default DTA is 128 bytes at offset 80h in the PSP. DOS uses the 
  750.         DTA for all file I/O. 
  751.      2) Registers are unchanged.
  752.      3) No error codes are returned.
  753.      2) Disk transfers cannot wrap around from the end of the segment to the 
  754.         beginning or overflow into another segment.
  755.  
  756.  
  757. Function  1Bh   Get Current Drive File Allocation Table Information
  758.       Returns information from the FAT on the current drive
  759. entry   AH      1Bh
  760. exit    AL      number of sectors per allocation unit (cluster)
  761.         DS:BX   address of the current drive's media descriptor byte
  762.         CX      number of bytes per sector
  763.         DX      number of allocation units (clusters) for default drive
  764. note 1) Save DS before calling this function.
  765.      2) This call returned a pointer to the FAT in DOS 1.x. Beginning with
  766.         DOS 2.00, it returns a pointer only to the table's ID byte.
  767.      3) IBM recommends programmers avoid this call and use int 25h instead.
  768.  
  769.  
  770. Function  1Ch   Get File Allocation Table Information for Specific Device 
  771.       Returns information on specified drive
  772. entry   AH      1Ch
  773.         DL      drive number (1=A, 2=B, 3=C, etc)
  774. return  AL      number of sectors per allocation unit (cluster)
  775.         DS:BX   address of media descriptor byte for drive in DL
  776.         CX      sector size in bytes
  777.         DX      number of allocation units (clusters)
  778. note 1) DL = 0 for default.
  779.      2) Save DS before calling this function.
  780.      3) Format of media-descriptor byte:
  781.         bits:   0       0   (clear)   not double sided
  782.                         1   (set)     double sided
  783.                 1       0   (clear)   not 8 sector
  784.                         1   (set)     8 sector
  785.                 2       0   (clear)   nonremovable device
  786.                         1   (set)     removable device
  787.                 3-7     always set (1)
  788.      4) This call returned a pointer to the FAT in DOS 1.x. Beginning with
  789.         DOS 2.00, it returns a pointer only to the table's ID byte.
  790.      5) IBM recommends programmers avoid this call and use int 25h instead.
  791.  
  792.  
  793. Function  1Dh   Not Documented by Microsoft
  794.  *    Unknown
  795. entry   AH      1Dh
  796. return  AL      0
  797.  
  798.  
  799. Function  1Eh   Not Documented by Microsoft
  800.  *    Unknown
  801. entry   AH      1Eh
  802. return  AL      0
  803. note    Apparently does nothing
  804.  
  805.  
  806. Function  1Fh Get Default Drive Parameter Block 
  807.  *  Same as function call 32h (below), except that the table is accessed from 
  808.     the default drive
  809. entry   AH      1Fh
  810.         other registers unknown
  811. return  AL      00h     no error
  812.                 0FFh    error
  813.         DS:BX   points to DOS Disk Parameter Block for default drive.
  814. note 1) Unknown vector returned in ES:BX.
  815.      2) For DOS 2.x and 3.x, this just invokes function 32h (undocumented, 
  816.         Read DOS Disk Block) with DL=0
  817.  
  818.  
  819. Function  20h  Unknown
  820.  *   Internal - does nothing? 
  821. entry   AH      20h
  822. return  AL      0
  823.  
  824.  
  825. Function  21h  Random Read from File Specified by File Control Block     (FCB)
  826.      Reads one record as specified in the FCB into the current DTA.
  827. entry   AH      21h
  828.         DS:DX   address of the opened FCB
  829. return  AL      00h     successful read operation
  830.                 01h     end of file (EOF), no data read
  831.                 02h     DTA too small for the record size specified
  832.                 03h     end of file (EOF), partial data read
  833. note 1) The current block and current record fields are set to agree with the
  834.         random record field. Then the record addressed by these fields is read
  835.         into memory at the current Disk Transfer Address.
  836.      2) The current file pointers are NOT incremented this function.
  837.      3) If the DTA is larger than the file, the file is padded to the requested
  838.         length with zeroes.
  839.  
  840.  
  841. Function  22h  Random Write to File Specified by FCB                      (FCB)
  842.      Writes one record as specified in the FCB to the current DTA
  843. entry   AH      22h
  844.         DS:DX   address of the opened FCB
  845. return  AL      00h     successful write operation
  846.                 01h     disk full; no data written (write was canceled)
  847.                 02h     DTA too small for the record size specified (write was
  848.                         canceled)
  849. note 1) This service cannot write to read-only files.
  850.      2) The record pointed to by the Current Block (offset 0Ch) and the Current
  851.         Record (offset 20h) fields is loaded at the DTA, then the Current Block
  852.         and Current Record fields are incremented.
  853.      3) If the record size is less than a sector, the data in the DTA is written
  854.         to a buffer; the buffer is written to disk when it contains a full 
  855.         sector of data, the file is closed, or a Reset Disk (function 0Dh) is
  856.         issued.
  857.      4) The current file pointers are NOT incremented this function.
  858.      5) The record is written to disk at the current DTA address as specified 
  859.         by the most recent call to function 1Ah. If the size of the record and
  860.         location of the DTA are such that a segment overflow or wraparound would
  861.         occur, the error return is set to AL=02h
  862.  
  863.  
  864. Function  23h  Get File Size                                             (FCB)
  865.      Searches current subdirectory for matching file, returns size in FCB
  866. entry   AH      23h
  867.         DS:DX   address of an unopened FCB
  868. return  AL      00h file found
  869.                 0FFh file not found
  870. note 1) Record size field (offset 0Eh) must be set before invoking this function
  871.      2) The disk directory is searched for the matching entry. If a matching
  872.         entry is found, the random record field is set to the number of records
  873.         in the file. If the value of the Record Size field is not an even
  874.         divisor of the file size, the value set in the relative record field is 
  875.         rounded up. This gives a returned value larger than the actual file size
  876.      3) This call is used by the APPEND command in DOS 3.2+
  877.  
  878.  
  879. Function  24h  Set Relative Record Field                                  (FCB)
  880.      Set random record field specified by an FCB
  881. entry   AH      24h
  882.         DS:DX   address of an opened FCB
  883. return  Random Record Field of FCB is set to be same as Current Block
  884.         and Current Record.
  885. note 1) You must invoke this function before performing random file access.
  886.      2) The relative record field of FCB (offset 21h) is set to be same as the
  887.         Current Block (offset 0Ch) and Current Record (offset 20h).
  888.      3) No error codes are returned.
  889.      4) The FCB must already be opened.
  890.  
  891.  
  892. Function  25h  Set Interrupt Vector
  893.      Sets the address of the code DOS is to perform each time the specified
  894.      interrupt is invoked.
  895. entry   AH      25h
  896.         AL      int number to reassign the handler to
  897.         DS:DX   address of new interrupt vector
  898. return  none
  899. note 1) Registers are unchanged.
  900.      2) No error codes are returned.
  901.      3) The interrupt vector table for the interrupt number specified in AL
  902.         is set to the address contained in DS:DX. Use function 35h (Get Vector)
  903.         to get the contents of the interrupt vector and save it for later use.
  904.      4) When you use function 25 to set an interrupt vector, DOS 3.2 doesn't
  905.         point the actual interrupt vector to what you requested. Instead, it
  906.         sets the interrupt vector to point to a routine inside DOS, which does
  907.         this:
  908.                 1. Save old stack pointer
  909.                 2. Switch to new stack pointer allocated from DOS's stack pool
  910.                 3. Call your routine
  911.                 4. Restore old stack pointer
  912.         The purpose for this was to avoid possible stack overflows when there
  913.         are a large number of active interrupts. IBM was concerned (this was an
  914.         IBM change, not Microsoft) that on a Token Ring network there would be
  915.         a lot of interrupts going on, and applications that hadn't allocated
  916.         very much stack space would get clobbered. 
  917.  
  918.  
  919. Function  26h  Create New Program Segment Prefix (PSP)
  920.      This service copies the current program-segment prefix to a new memory 
  921.      location for the creation of a new program or overlay. Once the new PSP is
  922.      in place, a DOS program can read a DOS COM or overlay file into the memory 
  923.      location immediately following the new PSP and pass control to it.
  924. entry   AH      26h
  925.         DX      segment number for the new PSP
  926. return  none
  927. note 1) Microsoft recommends you use the newer DOS service 4Bh (EXEC) instead.
  928.      2) The entire 100h area at location 0 in the current PSP is copied into
  929.         location 0 of the new PSP. The memory size information at location 6
  930.         in the new segment is updated and the current termination, ctrl-break,
  931.         and critical error addresses from interrupt vector table entries for
  932.         ints 22h, 23h, and 24 are saved in the new program segment starting at
  933.         0Ah. They are restored from this area when the program terminates.
  934.      3) Current PSP is copied to specified segment
  935.                    
  936.  
  937. Function  27h  Random Block Read From File Specified by FCB
  938.      Similar to 21h (Random Read) except allows multiple files to be read.
  939. entry   AH      27h
  940.         CX      number of records to be read
  941.         DS:DX   address of an opened FCB
  942. return  AL      00h     successful read
  943.                 01h     end of file, no data read
  944.                 02h     DTA too small for record size specified (read canceled)
  945.                 03h     end of file
  946.         CX      actual number of records read (includes partial if AL=03h)
  947. note 1) The record size is specified in the FCB. The service updates the Current
  948.         Block (offset 0Ch) and Current Record (offset 20h) fields to the next
  949.         record not read.
  950.      2) If CX contained 0 on entry, this is a NOP.
  951.      3) If the DTA is larger than the file, the file is padded to the requested
  952.         length with zeroes.
  953.      4) This function assumes that the FCB record size field (0Eh) is correctly
  954.         set. If not set by the user, the default is 128 bytes.
  955.      5) The record is written to disk at the current DTA address as specified 
  956.         by the most recent call to function 1Ah. If the size of the record and
  957.         location of the DTA are such that a segment overflow or wraparound would
  958.         occur, the error return is set to AL=02h
  959.  
  960.  
  961. Function  28h  Random Block Write to File Specified in FCB
  962.      Similar to 27h (Random Write) except allows multiple files to be read.
  963. entry   AH      28h
  964.         CX      number of records to write
  965.         DS:DX   address of an opened FCB
  966. return  AL      00h     successful write
  967.                 01h     disk full, no data written
  968.                 02h     DTA too small for record size specified (write canceled)
  969.         CX      number of records written
  970. note 1) The record size is specified in the FCB.
  971.      2) This service allocates disk clusters as required.
  972.      3) This function assumes that the FCB Record Size field (offset 0Eh) is
  973.         correctly set. If not set by the user, the default is 128 bytes.
  974.      4) The record size is specified in the FCB. The service updates the Current
  975.         Block (offset 0Ch) and Current Record (offset 20h) fields to the next
  976.         record not read.
  977.      5) The record is written to disk at the current DTA address as specified 
  978.         by the most recent call to function 1Ah. If the size of the record and
  979.         location of the DTA are such that a segment overflow or wraparound would
  980.         occur, the error return is set to AL=02h
  981.      6) If called with CX=0, no records are written, but the FCB's File Size
  982.         entry (offset 1Ch) is set to the size specified by the FCB's Relative 
  983.         Record field (offset 21h).
  984.  
  985.  
  986. Function  29h  Parse the Command Line for Filename
  987.      Parses a text string into the fields of a File Control Block
  988. entry   AH      29h
  989.         DS:SI   pointer to string to parse
  990.         ES:DI   pointer to memory buffer to fill with unopened FCB
  991.         AL      bit mask to control parsing
  992.                 bit 0 = 0: parsing stops if file seperator found
  993.                         1: causes service to scan past leading chars such as
  994.                            blanks. Otherwise assumes the filename begins in
  995.                            the first byte
  996.                     1 = 0: drive number in FCB set to default (0) if string
  997.                            contains no drive number
  998.                         1: drive number in FCB not changed
  999.                     2 = 0: filename in FCB set to 8 blanks if no filename in 
  1000.                            string
  1001.                         1: filename in FCB not changed if string does not 
  1002.                            contain a filename
  1003.                     3 = 0: extension in FCB set to 3 blanks if no extension in 
  1004.                            string
  1005.                         1: extension left unchanged
  1006.                     4-7    must be zero
  1007. return  AL      00h     no wildcards in name or extension
  1008.                 01h     wildcards appeared in name or extension
  1009.                 0FFh    invalid drive specifier
  1010.         DS:SI   pointer to the first byte after the parsed string
  1011.         ES:DI   pointer to a buffer filled with the unopened FCB
  1012. note 1) If the * wildcard characters are found in the command line, this service
  1013.         will replace all subsequent chars in the FCB with question marks.
  1014.      2) This service uses the characters as filename separators
  1015.         DOS 1       : ; . , + / [ ] = " TAB SPACE
  1016.         DOS 2,3     : ; . , + = TAB SPACE
  1017.      3) This service uses the characters
  1018.         : ; . , + < > | / \ [ ] = " TAB SPACE
  1019.         or any control characters as valid filename separators
  1020.      4) A filename cannot contain a filename terminator. If one is encountered,
  1021.         all processing stops. The handle functions will allow use of some of
  1022.         these characters.
  1023.      5) If no valid filename was found on the command line, ES:DI +1 points
  1024.         to a blank (ASCII 32).
  1025.      6) This function cannot be used with filespecs which include a path
  1026.      7) Parsing is in the form D:FILENAME.EXT. If one is found, a corresponding
  1027.         unopened FCB is built at ES:DI
  1028.  
  1029.  
  1030. Function  2Ah  Get Date
  1031.      Returns day of the week, year, month, and date
  1032. entry   AH      2Ah
  1033. return  CX      year    (1980-2099)
  1034.         DH      month   (1-12)
  1035.         DL      day     (1-31)
  1036.         AL      weekday 00h     Sunday
  1037.                         01h     Monday
  1038.                         02h     Tuesday
  1039.                         03h     Wednesday
  1040.                         04h     Thursday
  1041.                         05h     Friday
  1042.                         06h     Saturday
  1043. note 1) Date is adjusted automatically if clock rolls over to the next day,
  1044.         and takes leap years and number of days in each month into account.
  1045.      2) Although DOS cannot set an invalid date, it can read one, such as
  1046.         1/32/80, etc.
  1047.      3) DesQview also accepts CX = 4445h and DX = 5351h, i.e. 'DESQ' as valid
  1048.      4) DOS will accept CH=0 (midnight) as a valid time, but if a file's time
  1049.         is set to exactly midnight the time will not be displayed by the DIR
  1050.         command.
  1051.  
  1052.  
  1053. Function  2Bh  Set Date
  1054.      set current system date
  1055. entry   AH      2Bh
  1056.         CX      year    (1980-2099)
  1057.         DH      month   (1-12)
  1058.         DL      day     (1-31)
  1059. return  AL      00h     no error (valid date)
  1060.                 0FFh    invalid date specified
  1061. note 1) On entry, CX:DX must have a valid date in the same format as returned 
  1062.         by function call 2Ah
  1063.      2) DOS 3.3 also sets CMOS clock
  1064.  
  1065.  
  1066. Function  2Ch  Get Time
  1067.      Get current system time from CLOCK$ driver
  1068. entry   AH      2Ch
  1069. return  CH      hours   (0-23)
  1070.         CL      minutes (0-59)
  1071.         DH      seconds (0-59)
  1072.         DL      hundredths of a second (0-99)
  1073. note 1) Time is updated every 5/100 second.
  1074.      2) The date and time are in binary format
  1075.  
  1076.  
  1077. Function  2Dh  Set Time
  1078.      Sets current system time
  1079. entry   AH      2Dh
  1080.         CH      hours   (0-23)
  1081.         CL      minutes (0-59)
  1082.         DH      seconds (0-59)
  1083.         DL      hundredths of seconds (0-99)
  1084. return  AL      00h     if no error
  1085.                 0FFh    if bad value sent to routine
  1086. note 1) DOS 3.3 also sets CMOS clock
  1087.      2) CX and DX must contain a valid time in binary
  1088.  
  1089.  
  1090. Function  2Eh  Set/Reset Verify Switch
  1091.      Set verify flag                                                     
  1092. entry   AH      2Eh
  1093.         AL      00      to turn verify off (default)
  1094.                 01      to turn verify on
  1095. return  none
  1096. note 1) This is the call invoked by the DOS VERIFY command
  1097.      2) Setting of the verify switch can be obtained by calling call 54h
  1098.      3) This call is not supported on network drives
  1099.      4) DOS checks this flag each time it accesses a disk
  1100.  
  1101.  
  1102. Function  2Fh  Get Disk Transfer Address (DTA)
  1103.      Returns current disk transfer address used by all DOS read/write operations
  1104. entry   AH      2Fh
  1105. return  ES:BX   address of DTA
  1106. note 1) The DTA is set by function call 1Ah
  1107.      2) Default DTA address is a 128 byte buffer at offset 80h in that program's
  1108.         Program Segment Prefix
  1109.  
  1110.  
  1111. Function  30h  Get DOS Version Number
  1112.      Return DOS version and/or user number
  1113. entry   AH      30h
  1114. return  AH      minor version number  (i.e., DOS 2.10 returns AX = 0A02h)
  1115.         AL      major version number
  1116.         BH      OEM ID number
  1117.                 00h     IBM
  1118.                 16h     DEC    (others not known)
  1119.         BL:CX   24-bit user serial number
  1120. note 1) If AL returns a major version number of zero, the DOS version is 
  1121.         below 1.28 for MSDOS and below 2.00 for PCDOS.
  1122.      2) IBM PC-DOS always returns 0000h in BX and CX. 
  1123.      3) OS/2 v1.0 Compatibility Box returns a value of 10 for major version.
  1124.      4) Due to the OS/2 return and the fact that some European versions of DOS
  1125.         carry higher version numbers than IBM's DOS, utilities which check
  1126.         for a DOS version should not abort if a higher version than required
  1127.         is found unless some specific problems are known.
  1128.  
  1129.  
  1130. Function  31h  Terminate Process and Stay Resident
  1131.      KEEP, or TSR
  1132. entry   AH      31h
  1133.  
  1134.         AL      exit code
  1135.         DX      program memory requirement in 16 byte paragraphs
  1136. return  AX      return code (retrieveable by function 4Dh)
  1137. note 1) Files opened by the application are not closed when this call is made
  1138.      2) Memory can be used more efficiently if the block containing the copy of
  1139.         the DOS environment is deallocated before terminating. This can be done
  1140.         by loading ES with the segment contained in 2Ch of the PSP and issuing
  1141.         function call 49h (Free Allocated Memory).
  1142.      3) Unlike int 27h, more than 64k may be made resident with this call
  1143.      
  1144.  
  1145. Function  32h  Read DOS Disk Block
  1146.  *   Retrieve the pointer to the drive parameter block for a drive 
  1147. entry   AH      32h
  1148.         DL      drive (0=default, 1=A:, etc.). 
  1149. return  AL      00h     if drive is valid
  1150.                 0FFh    if drive is not valid
  1151.         DS:BX   pointer to DOS Drive Parameter Table. Format of block:
  1152.                 Bytes   Type        Value
  1153.                 00h     byte    Drive: 0=A:, 1=B:, etc.
  1154.                 01h     byte    Unit within drive (0, 1, 2, etc.)
  1155.                 02h-03h word    Bytes per sector
  1156.                 04h     byte    Sectors per cluster - 1
  1157.                 05h     byte    Cluster to sector shift (i.e., how far to shift-
  1158.                                 left the bytes/sector to get bytes/cluster)
  1159.                 06h-07h word    Number of reserved (boot) sectors
  1160.                 08h     byte    Number of FATs
  1161.                 09h-0Ah word    Number of root directory entries
  1162.                 0Bh-0Ch word    Sector # of 1st data. Should be same as # of 
  1163.                                 sectors/track.
  1164.                 0Dh-0Eh word    # of clusters + 1 (=last cluster #)
  1165.                 0Fh     byte    Sectors for FAT
  1166.                 10h-11h word    First sector of root directory
  1167.                 12h-15h dword   Address of device driver header for this drive
  1168.                 16h     byte    Media Descriptor Byte for this drive
  1169.                 17h     byte    0FFh indicates block must be rebuilt
  1170.                                 (DOS 3.x) 00h indicates block device has 
  1171.                                 been accessed
  1172.                 18h-1Bh dword   address of next DOS Disk Block (0FFFFh means 
  1173.                                 last in chain)
  1174.                 22h     byte    Current Working Directory (2.0 only) (64 bytes)
  1175. note 1) Use [BX+0D] to find no. of clusters (>1000H, 16-bit FAT; if not, 12-bit
  1176.         (exact dividing line is probably a little below 1000h to allow for
  1177.         bad sectors, EOF markers, etc.)
  1178.      2) Short article by C.Petzold, PC Magazine  Vol.5,no.8, and the article
  1179.         "Finding Disk Parameters" in the May 1986 issue of PC Tech Journal.
  1180.      3) This call is mostly supported in OS/2 1.0's DOS Compatibility Box. The
  1181.         dword at 12h will not return the address of the next device driver when
  1182.         in the Compatibility Box.
  1183.      4) used by CHKDSK
  1184.  
  1185.  
  1186. Function  33h  Control-Break Check
  1187.      Get or set control-break checking at CON
  1188. entry   AH      33h
  1189.         AL      00h     to test for break checking
  1190.                 01h     to set break checking
  1191.                         DL      00h     to disable break checking
  1192.                                 01h     to enable break checking
  1193.                 02h     internal, called by PRINT.COM (DOS 3.1)
  1194.                 03h     unknown
  1195.                 04h     unknown
  1196.                 05h     boot drive (DOS 4.0+)
  1197. return  DL      00h     if break=off 
  1198.                 01h     if break=on
  1199.                 (if AL=05h) boot drive, A=1, B=2, etc)
  1200.         AL      0FFh    error
  1201.  
  1202.  
  1203. Function  34h  Return INDOS Flag
  1204.  *   Returns ES:BX pointing to Critical Section Flag, byte indicating whether 
  1205.      it is safe to interrupt DOS.
  1206. entry   AH      34h
  1207. return  ES:BX   points to DOS "critical section flag"
  1208. note 1) If byte is 0, it is safe to interrupt DOS. This was mentioned in some
  1209.         documentation by Microsoft on a TSR standard, and PC Magazine reports
  1210.         it functions reliably under DOS versions 2.0 through 3.3. Chris 
  1211.         Dunford (of CED fame) and a number of anonymous messages on the BBSs
  1212.         indicate it may not be totally reliable.
  1213.      2) The byte at ES:BX+1 is used by the Print program for this same purpose,
  1214.         so it's probably safer to check the WORD at ES:BX.
  1215.      3) Reportedly, examination of DOS 2.10 code in this area indicates that the
  1216.         byte immediately following this "critical section flag" must be 00h to
  1217.         permit the PRINT.COM interrupt to be called. For DOS 3.0 and 3.1 (except
  1218.         Compaq DOS 3.0), the byte before the "critical section flag" must be
  1219.         zero; for Compaq DOS 3.0, the byte 01AAh before it must be zero.
  1220.      4) In DOS 3.10 this reportedly changed to word value, with preceding byte.
  1221.      5) This call is supported in OS/2 1.0's DOS Compatibility Box
  1222.      6) Gordon Letwin of Microsoft discussed this call on ARPAnet in 1984. He
  1223.         stated:
  1224.         a) this is not supported under any version of the DOS
  1225.         b) it usually works under DOS 2, but there may be circumstances
  1226.            when it doesn't (general disclaimer, don't know of a specific
  1227.            circumstance)
  1228.         c) it will usually not work under DOS 3 and DOS 3.1; the DOS is
  1229.            considerably restructured and this flag takes on additional
  1230.            meanings and uses
  1231.         d) it will fail catastrophically under DOS 4.0 and forward.
  1232.            Obviously this information is incorrect since the call works fine
  1233.            through DOS 3.3. Microsoft glasnost?
  1234.  
  1235.  
  1236. Function  35h  Get Vector
  1237.      Get interrupt vector 
  1238. entry   AH      35h
  1239.         AL      interrupt number (hexadecimal)
  1240. return  ES:BX   address of interrupt vector
  1241. note    Use function call 25h to set the interrupt vectors
  1242.  
  1243.  
  1244. Function  36h  Get Disk Free Space
  1245.      get information on specified drive
  1246. entry   AH      36h
  1247.         DL      drive number (0=default, 1=A:, 2=B:, etc)
  1248. return  AX      number of sectors per cluster 
  1249.                 0FFFFh means drive specified in DL is invalid
  1250.         BX      number of availible clusters
  1251.         CX      bytes per sector
  1252.         DX      clusters per drive
  1253. note 1) Mult AX * CX * BX for free space on disk
  1254.      2) Mult AX * CX * DX for total disk space
  1255.      3) Function 36h returns an incorrect value after an ASSIGN command. Prior 
  1256.         to ASSIGN, the DX register contains 0943h on return, which is the free
  1257.         space in clusters on the HC diskette. After ASSIGN, even with no 
  1258.         parameters, 0901h is returned in the DX register; this is an incorrect 
  1259.         value. Similar results occur with DD diskettes on a PC-XT or a PC-AT.
  1260.         This occurs only when the disk is not the default drive. Results are as
  1261.         expected when the drive is the default drive. Therefore, the 
  1262.         circumvention is to make the desired drive the default drive prior to 
  1263.         issuing this function call.
  1264.      4) Int 21h, function call 36h returns an incorrect value after an ASSIGN 
  1265.         command. Prior to ASSIGN, the DX register contains 0943h on return, 
  1266.         which is the free space in clusters on the HC diskette. After ASSIGN, 
  1267.         even with no parameters, 0901h is returned in the DX register; this is 
  1268.         an incorrect value. Similar results occur with DD diskettes on a PC-XT 
  1269.         or a PC-AT. This occurs only when the disk is not the default drive.
  1270.         Results are as expected when the drive is the default drive. Therefore,
  1271.         the circumvention is to make the desired drive the default drive prior 
  1272.         to issuing this function call.
  1273.      5) This function supercedes functions 1Bh and 1Ch.
  1274.  
  1275.  
  1276. Function  37h  SWITCHAR / AVAILDEV
  1277.  *   Get/set option marking character (is usually "/"), and device type
  1278. entry   AH      37h
  1279.         AL      00h     read switch character (returns current character in DL)
  1280.                 01h     set character in DL as new switch character
  1281.       (DOS 2.x) 02h     read device availability (as set by function AL=3) into
  1282.                         DL. A 0 means devices that devices must be accessed in 
  1283.                         file I/O calls by /dev/device. A non-zero value means 
  1284.                         that devices are accessible at every level of the 
  1285.                         directory tree (e.g., PRN is the printer and not a file 
  1286.                         PRN).
  1287.                         AL=2 to return flag in DL, AL=3 to set from DL (0 = set,
  1288.                         1 = not set).
  1289.       (DOS 2.x) 03h     get device availability, where:
  1290.         DL      00h     means /dev/ must precede device names
  1291.                 01h     means /dev/ need not precede device names
  1292. return  DL      switch character (if AL=0 or 1)
  1293.                 device availability flag (if AL=2 or 3)
  1294.         AL      0FFh    the value in AL was not in the range 0-3.
  1295. note 1) Functions 2 & 3 appear not to be implemented for DOS 3.x.
  1296.      2) It is documented on page 4.324 of the MS-DOS (version 2) Programmer's
  1297.         Utility Pack (Microsoft - published by Zenith).  
  1298.      3) Works on all versions of IBM PC-DOS from 2.0 through 3.3.1.
  1299.      4) The SWITCHAR is the character used for "switches" in DOS command 
  1300.         arguments (defaults to '/', as in "DIR/P"). '-' is popular to make a 
  1301.         system look more like UNIX; if the SWITCHAR is anything other than '/',
  1302.         then '/' may be used instead of '\' for pathnames 
  1303.      5) Ignored by XCOPY, PKARC, LIST
  1304.      6) SWITCHAR may not be set to any character used in a filename
  1305.      7) In DOS 3.x you can still read the "AVAILDEV" byte with subfunction 02h 
  1306.         but it always returns 0FFh even if you try to change it to 0 with
  1307.         subfunction 03h.
  1308.      8) AVAILDEV=0 means that devices must be referenced in an imaginary
  1309.         subdirectory "\dev" (similar to UNIX's /dev/*); a filename "PRN.DAT"
  1310.         can be created on disk and manipulated like any other. If AVAILDEV != 0
  1311.         then device names are recognized anywhere (this is the default):
  1312.         "PRN.DAT" is synonymous with "PRN:". 
  1313.      9) These functions reportedly are not supported in the same fashion in 
  1314.         various implementations of DOS. 
  1315.     10) used by DOS 3.3 CHKDSK, BASIC, DEBUG
  1316.  
  1317.  
  1318. Function  38h   Return Country Dependent Information
  1319.                 (PCDOS 2.0, 2.1, MSDOS 2.00 only)
  1320. entry   AH      38h
  1321.         AL      function code  (must be 0 in DOS 2.x)
  1322.         DS:DX   pointer to 32 byte memory buffer for returned information
  1323. return  CF      set on error
  1324.                 AX      error code (02h)
  1325.         BX      country code
  1326.         DS:DX   pointer to buffer filled with country information:
  1327.                 bytes 0,1       date/time format
  1328.                                 0       USA standard       H:M:S   M/D/Y
  1329.                                 1       European standard  H:M:S   D/M/Y
  1330.                                 2       Japanese standard  H:M:S   D:M:Y
  1331.                 byte2   ASCIIZ string currency symbol
  1332.                 byte3   zeroes
  1333.                 byte4   ASCIIZ string thousands separator
  1334.                 byte5   zeroes
  1335.                 byte6   ASCIIZ string decimal separator
  1336.                 byte7   zeroes
  1337.                 bytes 8,1Fh  24 bytes   reserved
  1338.  
  1339.  
  1340. Function  38h   Get Country Dependent Information
  1341.                 (PCDOS 3.x+, MSDOS 2.01+)
  1342. entry   AH      38h
  1343.         AL      function code
  1344.                 00h     to get current country information
  1345.                 01h-0FEh country code to get information for, for countries
  1346.                         with codes less than 255
  1347.                 0FFh    to get country information for countries with a code
  1348.                         greater than 255
  1349.                         BX      16 bit country code if AL=0FFh
  1350.         DS:DX   pointer to the memory buffer where the data will be returned
  1351.                 DX      0FFFFh if setting country code rather than getting info
  1352. return  CF      0 (clear) function completed
  1353.                 1 (set) error
  1354.                    AX   error code
  1355.                         02h     invalid country code (no table for it)
  1356.         (if DX <> 0FFFFh)
  1357.         BX      country code (usually international telephone code)
  1358.         DS:DX   pointer to country data buffer
  1359.           bytes 0,1     date/time format
  1360.                         0       USA standard       H:M:S   M/D/Y
  1361.                         1       European standard  H:M:S   D/M/Y
  1362.                         2       Japanese standard  H:M:S   D:M:Y
  1363.           bytes 2-6     currency symbol null terminated
  1364.           byte  07h     thousands separator null terminated
  1365.           byte  08h     zeroes
  1366.           byte  09h     decimal separator null terminated
  1367.           byte  0Ah     zeroes
  1368.           byte  0Bh     date separator null terminated
  1369.           byte  0Ch     zeroes
  1370.           byte  0Dh     time separator null terminated
  1371.           byte  0Eh     zeroes
  1372.           byte  0Fh     bit field currency format
  1373.                         bit 0 = 0  if currency symbol precedes the value
  1374.                                 1  if currency symbol is after the value
  1375.                         bit 1 = 0  no spaces between value and currency symbol
  1376.                                 1  one space between value and currency symbol
  1377.                         bit 2 = 1  set if currency symbol replaces decimal pt
  1378.                         bits 3-7   not defined by Microsoft
  1379.           byte  10h     number of significant decimal digits in currency
  1380.                         (number of places to right of decimal point)
  1381.           byte  11h     time format
  1382.                         bit 0 = 0       12 hour clock
  1383.                                 1       24 hour clock
  1384.                         bits 1-7 unknown, probably not used
  1385.           bytes 12h-15h address of case map routine (FAR CALL, AL = char)
  1386.                         entry   AL  ASCII code of character to be converted to 
  1387.                                     uppercase
  1388.                         return  AL  ASCII code of the uppercase input character
  1389.           byte  16h     data-list separator character
  1390.           byte  17h     zeroes
  1391.           bytes 18h-21h 5 words reserved
  1392. note 1) When an alternate keyboard handler is invoked, the keyboard routine is 
  1393.         loaded into user memory starting at the lowest portion of availible 
  1394.         user memory. The BIOS interrupt vector that services the keyboard is
  1395.         redirected to the memory area where the new routine resides. Each new
  1396.         routine takes up about 1.6K of memory and has lookup tables that return
  1397.         values unique to each language. (KEYBxx in the DOS book)
  1398.          Once the keyboard interrupt vector is changed by the DOS keyboard
  1399.         routine, the new routine services all calls unless the system is 
  1400.         returned to the US format by the ctrl-alt-F1 keystroke combination. This
  1401.         does not change the interrupt vector back to the BIOS location; it
  1402.         merely passes the table lookup to the ROM locations. 
  1403.      2) Ctrl-Alt-F1 will only change systems with US ROMS to the US layout.
  1404.         Some systems are delivered with non-US keyboard handler routines in ROM
  1405.      3) Case mapping call: the segment/offset of a FAR procedure that performs 
  1406.         country-specific lower-to-upper case mapping on ASCII characters 80h to
  1407.         0FFh. It is called with the character to be mapped in AL. If there is
  1408.         an uppercase code for the letter, it is returned in AL, if there is no
  1409.         code or the function was called with a value of less than 80h AL is
  1410.         returned unchanged.
  1411.      4) This call is fully implemented in MS-DOS version 2.01 and higher. It
  1412.         is in version 2.00 but not fully implemented (according to Microsoft)
  1413.  
  1414.  
  1415. Function  38h   Set Country Dependent Information
  1416. entry   AH      38h
  1417.         AL      code    country code to set information for, for countries
  1418.                         with codes less than 255
  1419.                 0FFh    to set country information for countries with a code
  1420.                         greater than 255
  1421.         BX      16 bit country code if AL=0FFh
  1422.         DX      0FFFFh
  1423. return  CF      clear   successful
  1424.                 set     if error
  1425.                         AX      error code (02h)
  1426.  
  1427.  
  1428. Function  39h   Create Subdirectory (MKDIR)
  1429.                 Makes a subdirectory along the indicated path
  1430. entry   AH      39h
  1431.         DS:DX   address of ASCIIZ pathname string
  1432. return  flag CF 0       successful
  1433.                 1       error
  1434.                         AX      error code if any  (3, 5) 
  1435. note 1) The ASCIIZ string may contain drive and subdirectory.
  1436.      2) Drive may be any valid drive (not nescessarily current drive)
  1437.      3) The pathname cannot exceed 64 characters
  1438.  
  1439.  
  1440. Function  3Ah   Remove Subdirectory  (RMDIR)
  1441. entry   AH      3Ah
  1442.         DS:DX   address of ASCIIZ pathname string
  1443. return  CF      clear     successful
  1444.                 set       AX      error code if any  (3, 5, 16)
  1445. note 1) The ASCIIZ string may contain drive and subdirectory.
  1446.      2) Drive may be any valid drive (not nescessarily current drive)
  1447.      3) The pathname cannot exceed 64 characters
  1448.  
  1449.  
  1450. Function  3Bh   Change Current Directory  (CHDIR)
  1451. entry   AH      3Bh
  1452.         DS:DX   address of ASCIIZ string
  1453. return  flag CF 0       successful
  1454.                 1       error
  1455.         AX      error code if any (3)
  1456. note 1) The pathname cannot exceed 64 characters
  1457.      2) The ASCIIZ string may contain drive and subdirectory.
  1458.      3) Drive may be any valid drive (not nescessarily current drive)
  1459.  
  1460.  
  1461. Function  3Ch   Create A File (CREAT)
  1462.                 Create a file with handle 
  1463. entry   AH      3Ch
  1464.         CX      attributes for file
  1465.                 00h     normal
  1466.                 01h     read only
  1467.                 02h     hidden
  1468.                 03h     system
  1469.         DS:DX   address of ASCIIZ filename string
  1470. return  flag CF 0       successful creation
  1471.                 1       error
  1472.         AX      16 bit file handle
  1473.                 or error code  (3, 4, 5)
  1474. note 1) The ASCIIZ string may contain drive and subdirectory.
  1475.      2) Drive may be any valid drive (not nescessarily current drive)
  1476.      3) If the volume label or subdirectory bits are set in CX, they are ignored
  1477.      4) The file is opened in read/write mode
  1478.      5) If the file does not exist, it is created. If one of the same name 
  1479.         exists, it is truncated to a length of 0.
  1480.      6) Good practice is to attempt to open a file with fn 3Dh and jump to an
  1481.         error routine if successful, create file if 3Dh fails. That way an
  1482.         existing file will not be truncated and overwritten.
  1483.  
  1484.  
  1485. Function  3Dh   Open A File
  1486.                 Open disk file with handle 
  1487. entry   AH      3Dh
  1488.         AL      access code byte
  1489. (DOS 2.x)       bits 0-2  file attribute
  1490.                 000     read only
  1491.                 001     write only
  1492.                 010     read/write
  1493.                 bits 3-7 should be set to zero
  1494. (DOS 3.x)       bits 0-2  file attribute
  1495.                 000     read only
  1496.                 001     write only
  1497.                 010     read/write
  1498.                 bit 3   reserved
  1499.                 0       should be set to zero
  1500.                 bits 4-6 sharing mode (network)
  1501.                 000     compatibility mode (the way FCBs open files)
  1502.                 001     read/write access denied (exclusive)
  1503.                 010     write access denied
  1504.                 011     read access denied
  1505.                 100     full access permitted
  1506.                 bit 7   inheritance flag
  1507.                 0       file inherited by child process
  1508.                 1       file private to child process
  1509.         DS:DX   address of ASCIIZ pathname string
  1510. return  flag CF set on error
  1511.                 AX      error code
  1512.                 1       error
  1513.         AX      16 bit file handle
  1514.                 or error code (1, 2, 4, 5, 0Ch)
  1515. note 1) Opens any normal, system, or hidden file
  1516.      2) Files that end in a colon are not opened
  1517.      3) The rear/write pointer is set at the first byte of the file and the
  1518.         record size of the file is 1 byte (the read/write pointer can be changed
  1519.         through function call 42h). The returned file handle must be used for 
  1520.         all subsequent input and output to the file. 
  1521.      4) If the file handle was inherited from a parent process or was 
  1522.         duplicated by DUP or FORCEDUP, all sharing and access restrictions are
  1523.         also inherited.
  1524.      5) A file sharing error (error 1) causes an int 24h to execute with an 
  1525.         error code of 2
  1526.  
  1527.  
  1528. Function  3Eh   Close A File Handle 
  1529.                 Close a file and release handle for reuse
  1530. entry   AH      3Eh
  1531.         BX      file handle
  1532. return  flag CF 0       successful close
  1533.                 1       error
  1534.         AX      error code if error (6)
  1535. note 1) When executed, the file is closed, the directory is updated, and all
  1536.         buffers for that file are flushed. If the file was changed, the time 
  1537.         and date stamps are changed to current
  1538.      2) If called with the handle 00000, it will close STDIN (normally the 
  1539.         keyboard).
  1540.  
  1541.  
  1542. Function  3Fh   Read From A File Or Device
  1543.                 Read from file with handle 
  1544. entry   AH      3Fh
  1545.         BX      file handle
  1546.         CX      number of bytes to read
  1547.         DS:DX   address of buffer
  1548. return  flag CF 0       successful read
  1549.                 1       error
  1550.         AX      0       pointer was already at end of file
  1551.                         or number of bytes read
  1552.                         or error code (5, 6)
  1553. note 1) This function attempts to transfer the number of bytes specified in CX
  1554.         to a buffer location. It is not guaranteed that all bytes will be read.
  1555.         If AX < CX a partial record was read.
  1556.      2) If performed from STDIN (file handle 0000), the input can be redirected
  1557.      3) If used to read the keyboard, it will only read to the first CR
  1558.      4) The file pointer is incremented to the last byte read.
  1559.  
  1560.  
  1561. Function  40h   Write To A File Or Device
  1562.                 Write to file with handle 
  1563. entry   AH      40h
  1564.         BX      file handle
  1565.         CX      number of bytes to write
  1566.         DS:DX   address of buffer
  1567. return  flag CF 0       successful write
  1568.                 1       error
  1569.         AX      number of bytes written
  1570.                 or error code  (5, 6)
  1571. note 1) This call attempts to transfer the number of bytes indicated in CX
  1572.         from a buffer to a file. If CX and AX do not match after the write,
  1573.         an error has taken place; however no error code will be returned for
  1574.         this problem. This is usually caused by a full disk.
  1575.      2) If the write is performed to STDOUT (handle 0001), it may be redirected
  1576.      3) To truncate the file at the current position of the file pointer, set
  1577.         the number of bytes in CX to zero before calling int 21h. The pointer
  1578.         can be moved to any desired position with function 42h.
  1579.      4) This function will not write to a file or device marked read-only.
  1580.      5) May also be used to display strings to CON instead of fn 09h. This
  1581.         function will write CX bytes and stop; fn 09h will continue to write
  1582.         until a $ character is found.
  1583.      6) This is the call that DOS actually uses to write to the screen in DOS
  1584.         2.x and above.
  1585.  
  1586.  
  1587. Function  41h   Delete A File From A Specified Subdirectory  (UNLINK)
  1588. entry   AH      41h
  1589.         DS:DX   pointer to ASCIIZ filespec to delete
  1590. return  CF      0       successful
  1591.                 1       error
  1592.                 AX      error code if any  (2, 5)
  1593. note 1) This function will not work on a file marked read-only
  1594.      2) Wildcards are not accepted
  1595.  
  1596.  
  1597. Function  42h   Move a File Read/Write Pointer  (LSEEK)
  1598. entry   AH      42h
  1599.         AL      method code 
  1600.                 00h     offset from beginning of file
  1601.                 01h     offset from present location
  1602.                 02h     offset from end of file
  1603.         BX      file handle
  1604.         CX      most significant half of offset
  1605.         DX      least significant half of offset
  1606. return  AX      low offset of new file pointer
  1607.         DX      high offset of new file pointer
  1608.         CF      0       successful move
  1609.                 1       error
  1610.                 AX      error code (1, 6)
  1611. note 1) If pointer is at end of file, reflects file size in bytes.
  1612.      2) The value in DX:AX is the absolute 32 bit byte offset from the beginning
  1613.         of the file
  1614.  
  1615.  
  1616. Function   43h  Get/Set file attributes  (CHMOD)
  1617. entry   AH      43h
  1618.         AL      00h     get file attributes
  1619.                 01h     set file attributes
  1620.                 CX      file attributes to set
  1621.                     bit 0       read only
  1622.                         1       hidden file
  1623.                         2       system file
  1624.                         3       volume label
  1625.                         4       subdirectory
  1626.                         5       written since backup
  1627.         DS:DX   pointer to full ASCIIZ file name
  1628. return  CF      set if error
  1629.         AX      error code  (1, 2, 3, 5)
  1630.         CX      file attributes on get
  1631.                 attributes:
  1632.                 01h     read only
  1633.                 02h     hidden
  1634.                 04h     system
  1635.                 0FFh    archive
  1636. note 1) This call will not change the volume label or directory bits
  1637.  
  1638.  
  1639. Function  44h   I/O Control for Devices (IOCTL)
  1640.                 Get or Set Device Information
  1641. entry   AH      44h
  1642.         AL      00h     Get Device Information (from DX)
  1643.                         BX      file or device handle
  1644.                         return  DX      device info
  1645.                                         If bit 7 set: (character device)
  1646.                                            bit 0: console input device
  1647.                                                1: console output device
  1648.                                                2: NUL device
  1649.                                                3: CLOCK$ device
  1650.                                                4: device is special
  1651.                                                5: binary (raw) mode
  1652.                                                6: not EOF
  1653.                                               12: network device (DOS 3.x)
  1654.                                               14: can process IOCTL control
  1655.                                                   strings (func 2-5)
  1656.                                         If bit 7 clear: (file)
  1657.                                            bits 0-5: block device number
  1658.                                                 6: file has not been written
  1659.                                                12: Network device (DOS 3.x)
  1660.                                                15: file is remote (DOS 3.x)
  1661.                 01h     Set Device Information (DH must be zero for this call)
  1662.                         DX bits: 
  1663.                         0    1  console input device
  1664.                         1    1  console output device
  1665.                         2    1  null device
  1666.                         3    1  clock device
  1667.                         4    1  reserved
  1668.                         5    0  binary mode - don't check for control chars
  1669.                              1  cooked mode - check for control chars
  1670.                         6    0  EOF - End Of File on input
  1671.                         7       device is character device if set, if not, EOF
  1672.                                 is 0 if channel has been written, bits 0-5 are 
  1673.                                 block device number
  1674.                         12      network device
  1675.                         14   1  can process control strings (AL 2-5, can only be
  1676.                                 read, cannot be set)
  1677.                         15   n  reserved
  1678.                 02h     Read CX bytes to device in DS:DX from BX control chan
  1679.                 03h     Write Device Control String
  1680.                         BX      device handle
  1681.                         CX      number of bytes to write
  1682.                         DS:DX   pointer to buffer
  1683.                         return  AX      number of bytes written
  1684.                 04h     Read From Block Device (drive number in BL)
  1685.                         BL      drive number (0=default)
  1686.                         CX      number of bytes to read
  1687.                         DS:DX   pointer to buffer
  1688.                         return  AX      number of bytes read
  1689.                 05h     Write to Block Device  (drive number in BL)
  1690.                         AX      number of bytes transfered
  1691.                 06h     Get Input Handle Status
  1692.                         BX      file or device handle
  1693.                         return  AL      0FFh    device ready
  1694.                                         00h     device not ready
  1695.                 07h     Get Output Handle Status
  1696.                         return  AL      00h     not ready
  1697.                                         0FFh    ready
  1698.                          note: for DOS 2.x, files are always ready for output
  1699.                 08h     Removable Media Bit (DOS 3.x+)
  1700.                         return  AX      00h     device is removable
  1701.                                         01h     device is nonremovable
  1702.                                         0Fh     invalid drive specification
  1703.                 09h     Test whether Local or Network Device in BL (DOS 3.x+)
  1704.                         BL      drive number (0=default)
  1705.                         return  DX      attribute word, bit 12 set if device is
  1706.                                         remote
  1707.                 0Ah     Is Handle in BX Local or Remote? (DOS 3.x+)
  1708.                         BX     file handle
  1709.                         return DX (attribute word) bit 15 set if file is remote
  1710.                 0Bh     Change Sharing Retry Count to DX (default=3), (DOS 3.x+)
  1711.                         CX     delay (default=1)
  1712.                         DX     retry count (default=3)
  1713.                 0Ch     General IOCTL (DOS 3.3 [3.2?]) allows a device driver to
  1714.                         prepare, select, refresh, and query Code Pages
  1715.                 0Dh     Block Device Request (DOS 3.3+)
  1716.                         BL      drive number (0=default)
  1717.                         CH      major subfunction
  1718.                         CL      minor subfunction
  1719.                                 40h set device parameters
  1720.                                 41h write logical device track
  1721.                                 42h format and verify logical device track
  1722.                                 60h get device parameters
  1723.                                 61h read logical device track
  1724.                                 62h verify logical device track
  1725.                         DS:DX   pointer to parameter block
  1726.                 0Eh     Get Logical Device (DOS 3.3+)
  1727.                         BL      drive number (0=default)
  1728.                         return  AL=0 block device has only one logical drive
  1729.                                 assigned 1..n the last letter used to reference
  1730.                                 the device (1=A:,etc)
  1731.                 0Fh     Set Logical Device (DOS 3.3+)
  1732.         BL      drive number:  0=default, 1=A:, 2=B:, etc.
  1733.         BX      file handle
  1734.         CX      number of bytes to read or write
  1735.         DS:DX   data or buffer
  1736.         DX      data
  1737. return  AX      number of bytes transferred
  1738.                 or error code (call function 59h for extended error codes)
  1739.                 or status  00h     not ready
  1740.                            0FFh    ready
  1741.         CF      set if error
  1742.  
  1743.  
  1744. Function  45h   Duplicate a File Handle (DUP)
  1745. entry   AH      45h
  1746.         BX      file handle to duplicate
  1747. return  CF      clear   AX      duplicate handle
  1748.                 set     AX      error code  (4, 6)
  1749. note 1) If you move the pointed of one handle, the pointer of the other will 
  1750.         also be moved.
  1751.      2) The handle in BX must be open
  1752.           
  1753.  
  1754. Function  46h   Force Duplicate of a Handle (FORCEDUP or CDUP)
  1755.                 Forces handle in CX to refer to the same file at the same
  1756.                 position as BX
  1757. entry   AH      46h
  1758.         BX      existing file handle
  1759.         CX      new file handle
  1760. return  CF      clear   both handles now refer to existing file
  1761.                 set     error
  1762.                 AX      error code (4, 6)
  1763. note 1) If CX was an open file, it is closed first
  1764.      2) If you move the read/write pointer of either file, both will move
  1765.      3) The handle in BX must be open
  1766.  
  1767.               
  1768. Function  47h   Get Current Directory
  1769.                 Places full pathname of current directory/drive into a buffer
  1770. entry   AH      47h
  1771.         DL      drive (0=default, 1=A:, etc.)
  1772.         DS:SI   points to 64-byte buffer area
  1773. return  CF      clear   DS:DI   pointer to ASCIIZ pathname of current directory
  1774.                 set     AX      error code (0Fh)
  1775. note   String does not begin with a drive identifier or a backslash   
  1776.  
  1777.  
  1778. Function  48h   Allocate Memory
  1779.                 Allocates requested number of 16-byte paragraphs of memory
  1780. entry   AH      48h
  1781.         BX      number of 16-byte paragraphs desired
  1782. return  CF      clear   AX      segment address of allocated space
  1783.                         BX      maximum number paragraphs available
  1784.                 set     AX      error code (7, 8)
  1785. note    BX indicates maximum memory availible only if allocation fails
  1786.  
  1787.  
  1788. Function  49h   Free Allocated Memory
  1789.                 Frees specified memory blocks
  1790. entry   AH      49h
  1791.         ES      segment address of area to be freed
  1792. return  CF      clear   successful
  1793.                 set     AX      error code (7, 9)
  1794. note 1) This call is only valid when freeing memory obtained by function 48h.
  1795.      2) A program should not try to release memory not belonging to it.
  1796.  
  1797.  
  1798. Function  4Ah   Modify Allocated Memory Blocks (SETBLOCK)
  1799.                 Expand or shrink memory for a program
  1800. entry   AH      4AH
  1801.         BX      new size in 16 byte paragraphs
  1802.         ES      segment address of block to change
  1803. return  CF      clear   nothing
  1804.                 set     AX      error code (7, 8, 9)
  1805.                     or  BX      max number paragraphs available
  1806. note 1) Max number paragraphs availible is returned only if the call fails
  1807.      2) Memory can be expanded only if there is memory availible
  1808.  
  1809.  
  1810. Function  4Bh   Load or Execute a Program  (EXEC)
  1811. entry   AH      4Bh
  1812.         AL      00h     load and execute program. A PSP is built for the program
  1813.                         the ctrl-break and terminate addresses are set to the
  1814.                         new PSP.
  1815.                *01h     load but don't execute  (note 1)
  1816.                *01h     load but don't execute (internal, DOS 3.x & DESQview) 
  1817.                *02h     load but do not execute (internal, DOS 2.x only) 
  1818.                 03h     load overlay (do not create PSP, do not begin execution)
  1819.         DS:DX   points to the ASCIIZ string with the drive, path, and filename
  1820.                 to be loaded
  1821.         ES:BX   points to a parameter block for the load
  1822.                (AL=00h) word    segment address of environment string to be
  1823.                                 passed
  1824.                        dword    pointer to the command line to be placed at
  1825.                                 PSP+80h
  1826.                        dword    pointer to default FCB to be passed at PSP+5Ch
  1827.                        dword    pointer to default FCB to be passed at PSP+6Ch
  1828.               (*AL=01h) word    segment of environment (0 = use current) 
  1829.                        dword    pointer to command line 
  1830.                        dword    pointer to FCB 1 
  1831.                        dword    pointer to FCB 2 
  1832.                        dword    will hold SS:SP on return 
  1833.                        dword    will hold program entry point (CS:IP) on return 
  1834.               (*AL=02h) word    segment of environment (0 = use current) 
  1835.                        dword    pointer to command line 
  1836.                        dword    pointer to FCB 1 
  1837.                        dword    pointer to FCB 2 
  1838.                (AL=03h) word    segment address where file will be loaded
  1839.                         word    relocation factor to be applied to the image
  1840. return  CF      set     error
  1841.                         AX      error code (1, 2, 8, 0Ah, 0Bh)
  1842. note 1) If you make this call with AL=1 the program will be loaded as if you 
  1843.         made the call with AL=0 except that the program will not be executed.
  1844.         Additionally, with AL=1 the stack segment and pointer along with the 
  1845.         program's CS:IP entry point are returned to the program which made the 
  1846.         4B01h call. These values are put in the four words at ES:BX+0Eh. On 
  1847.         entry to the call ES:BX points to the environment address, the command 
  1848.         line and the two default FCBs. This form of EXEC is used by DEBUG.COM.
  1849.      2) Application programs may invoke a secondary copy of the command 
  1850.         processor (normally COMMAND.COM) by using the EXEC function.  Your 
  1851.         program may pass a DOS command as a parameter that the secondary 
  1852.         command processor will execute as though it had been entered from the 
  1853.         standard input device.
  1854.         The procedure is:
  1855.          A. Assure that adequate free memory (17k for 2.x and 3.0, 23k for 3.1 
  1856.             up) exists to contain the second copy of the command processor and 
  1857.             the command it is to execute. This is accomplished by executing 
  1858.             function call 4Ah to shrink memory allocated to that of your current
  1859.             requirements. Next, execute function call 48h with BX=0FFFFh. This 
  1860.             returns the amount of memory availible.
  1861.         B. Build a parameter string for the secondary command processor in the 
  1862.            form:
  1863.                          1 byte   length of parameter string
  1864.                         xx bytes  parameter string
  1865.                          1 byte   0Dh (carriage return)
  1866.            For example, the assembly language statement below would build the 
  1867.            string to cause execution of the command FOO.EXE:
  1868.                               DB 19,"/C C:FOO",13
  1869.         C. Use the EXEC function call (4Bh), function value 0 to cause execution
  1870.            of the secondary copy of the command processor. (The drive, 
  1871.            directory, and name of the command processor can be gotten from the 
  1872.            COMSPEC variable in the DOS environment passed to you at PSP+2Ch.)
  1873.         D. Remember to set offset 2 of the EXEC control block to point to the 
  1874.            string built above.
  1875.      3) All open files of a process are duplicated in the newly created 
  1876.         process after an EXEC, except for files originally opened with the 
  1877.         inheritance bit set to 1.
  1878.      4) The environment is a copy of the original command processor's 
  1879.         environment. Changes to the EXECed environment are not passed back to
  1880.         the original. The environment is followed by a copy of the DS:DX 
  1881.         filename passed to the child process. A zero value will cause the 
  1882.         child process to inherit the environment of the calling process. The
  1883.         segment address of the environment is placed at offset 2Ch of the
  1884.         PSP of the program being invoked.
  1885.      5) This function uses the same resident part of COMMAND.COM, but makes a
  1886.         duplicate of the transient part. 
  1887.      6) How EXEC knows where to return to: Basically the vector for int 22h
  1888.         holds the terminate address for the current process. When a process 
  1889.         gets started, the previous contents of int 22h get tucked away in the 
  1890.         PSP for that process, then int 22h gets modified. So if Process A 
  1891.         EXECs process B, while Process B is running, the vector for int 22h 
  1892.         holds the address to return to in Process A, while the save location in
  1893.         Process B's PSP holds the address that process A will return to when
  1894.         *it* terminates. When Process B terminates by one of the usual legal 
  1895.         means, the contents of int 22h are (surmising) shoved onto the stack, 
  1896.         the old terminate vector contents are copied back to int 22h vector from
  1897.         Process B's PSP, then a RETF or equivalent is executed to return control
  1898.         to process A.
  1899.      7) To load an overlay file with 4B: first, don't de-allocate the memory
  1900.         that the overlay will load into. With the other 4Bh functions, the
  1901.         opposite is true--you have to free the memory first, with function 4Ah.
  1902.         Second, the "segment address where the file will be loaded" (first item
  1903.         in the parameter block for sub-function 03) should be a paragraph 
  1904.         boundary within your currently-allocated memory. Third, if the
  1905.         procedures within the overlay are FAR procs (while they execute, CS will
  1906.         be equal to the segment address of the overlay area), the relocation
  1907.         factor should be set to zero. On the other hand, if the CS register
  1908.         will be different from the overlay area's segment address, the
  1909.         relocation factor should be set to represent the difference. You
  1910.         determine where in memory the overlay file will load by using the
  1911.         segment address mentioned above. Overlay files are .EXEs (containing
  1912.         header, relocation table, and memory image).
  1913.      8) When function 00h returns, all registers are changed, including the
  1914.         stack. You must resore SS, SP, and any other required registers.
  1915.  
  1916.  
  1917. Function  4Ch   Terminate a Process (EXIT)
  1918.                 Quit with ERRORLEVEL exit code 
  1919. entry   AH      4Ch
  1920.         AL      exit code in AL when called, if any, is passed to next process
  1921. return  none
  1922. note 1) Control passes to DOS or calling program
  1923.      2) return code from AL can be retrieved by ERRORLEVEL or function 4Dh
  1924.      3) all files opened by this process are closed, buffers are flushed, and 
  1925.         the disk directory is updated
  1926.      4) Restores Terminate vector from PSP:000Ah
  1927.                  Ctrl-C vector from PSP:000Eh
  1928.                  Critical Error vector from PSP:0012h
  1929.  
  1930.  
  1931. Function  4Dh   Get Return Code of a Subprocess (WAIT)
  1932.                 Gets return code from functions 31h and 4Dh  (ERRORLEVEL)
  1933. entry   AH      4Dh
  1934. return  AL      exit code of subprogram (functions 31h or 4Ch)
  1935.         AH      circumstance which caused termination
  1936.                 00h     normal termination
  1937.                 01h     control-break
  1938.                 02h     critical device error
  1939.                 03h     terminate and stay resident (function 31h)
  1940. note    The exit code is only returned once
  1941.                                          
  1942.  
  1943. Function  4Eh   Find First Matching File (FIND FIRST)
  1944. entry   AH      4Eh
  1945.         CX      search attributes
  1946.         DS:DX   pointer to ASCIIZ filename (with attributes)
  1947. return  CF      set     AX      error code (2, 12h)
  1948.                 clear   data block written at current DTA
  1949.                         format of block is:  (info from BIX)
  1950.   documented by Micro-  |00h   1 byte   attribute byte of search
  1951.   soft as "reserved for |01h   1 byte   drive letter for search
  1952.   DOS' use on subsquent |02h   11 bytes the search name used
  1953.   Find Next calls"      |0Ch   2 bytes  word value of last entry
  1954.   function 4Fh          |0Fh   4 bytes  dword pointer to this DTA
  1955.                         |13h   2 bytes  word directory start
  1956.                         | PC-DOS 3.10 (from INTERRUP.ARC)
  1957.                         |00h   1 byte   drive letter
  1958.                         |01h-0Bh    bytes  search template
  1959.                         |0Ch   1 byte   search attributes
  1960.                         | DOS 2.x (and DOS 3.x except 3.1?) (from INTERRUP.ARC)
  1961.                         |00h   1 byte   search attributes
  1962.                         |01h   1 byte   drive letter
  1963.                         |02h-0Ch bytes  search template
  1964.                         |0Dh-0Eh 2 bytes entry count within directory
  1965.                         |0Fh-12h   bytes reserved
  1966.                         |13h-14h 2 bytes cluster number of parent directory
  1967.                         
  1968.                          15h   1 byte   file attribute
  1969.                          16h   2 bytes  file time
  1970.                          18h   2 bytes  file date
  1971.                          1Ah   2 bytes  low word of file size
  1972.                          1Ch   2 bytes  high word of file size
  1973.                          1Eh  13 bytes  name and extension of file found, plus
  1974.                                         1 byte of 0s. All blanks are removed 
  1975.                                         from the name and extension, and if an 
  1976.                                         extension is present it is preceded by a
  1977.                                         period.
  1978. note 1) Will not find volume label
  1979.      2) This function does not support network operations
  1980.      3) Wildcards are allowed in the filespec
  1981.      4) If the attribute is zero, only ordinary files are found. If the volume 
  1982.         label bit is set, only volume labels will be found. Any other attribute
  1983.         will return that attribute and all normal files together.
  1984.      5) To look for everything except the volume label, set the hidden, system,
  1985.         and subdirectory bits all to 1
  1986.  
  1987.  
  1988. Function  4Fh   Find Next Matching File (FIND NEXT)
  1989.                 Find next ASCIIZ file
  1990. entry   AH      4Fh
  1991. return  CF      clear   data block written at current DTA
  1992.                 set     AX      error code (2, 12h)
  1993. note 1) If file found, DTA is formatted as in call 4Eh
  1994.      2) Volume label searches using 4Eh/4Fh reportedly aren't 100% reliable 
  1995.         under DOS 2.x. The calls sometime report there's a volume label and 
  1996.         point to a garbage DTA, and if the volume label is the only item they
  1997.         often won't find it
  1998.      3) This function does not support network operations
  1999.      4) Use of this call assumes that the original filespec contained wildcards
  2000.  
  2001.                                          
  2002. Function  50h   "Used Internally by DOS" - Set PSP
  2003.  *              Set new Program Segment Prefix (current Process ID)
  2004. entry   AH      50h
  2005.         BX      segment address of new PSP
  2006. return  none - swaps PSP's regarded as current by DOS
  2007. note 1) By putting the PSP segment value into BX and issuing call 50h DOS stores
  2008.         that value into a variable and uses that value whenever a file call is 
  2009.         made. 
  2010.      2) Note that in the PSP (or PDB) is a table of 20 (decimal) open file 
  2011.         handles. The table starts at offset 18h into the PSP. If there is an 
  2012.         0FFh in a byte then that handle is not in use. A number in one of the 
  2013.         bytes is an index into an internal FB table for that handle. For 
  2014.         instance the byte at offset 18h is for handle 0, at offset 19h handle 
  2015.         1, etc. up to 13h. If the high bit is set then the file associated by 
  2016.         the handle is not shared by child processes EXEC'd with call 4Bh.
  2017.      3) Function 50h is dangerous in background operations prior to DOS 3.x as 
  2018.         it uses the wrong stack for saving registers.  (same as functions 
  2019.         0..0Ch in DOS 2.x)
  2020.      4) Under DOS 2.x, this function cannot be invoked inside an int 28h handler
  2021.         without setting the Critical Error flag
  2022.      5) Open File information, etc. is stored in the PSP DOS views as current. 
  2023.         If a program (eg. a resident program) creates a need for a second PSP,
  2024.         then the second PSP should be set as current to make sure DOS closes 
  2025.         that as opposed to the first when the second application finishes.
  2026.      6) See PC Mag Vol.5, No 9, p.314 for discussion. 
  2027.      7) Used by DOS 3.3 PRINT & DEBUG, DesQview 2.01, Windows 1.03, SYMDEB
  2028.         from MASM 4.0
  2029.  
  2030.                                          
  2031. Function  51h    "Used Internally by DOS" - Get Program Segment Prefix
  2032.  *               Returns the PSP address of currently executing program
  2033. entry   AH      51h
  2034. return  BX      address of currently executing program
  2035.                 offset
  2036.                 00h     program exit point
  2037.                 02h     memory size in paragraphs
  2038.                 04h     unused (0)
  2039.                 05h     CP/M style entry point (far call to DOS)
  2040.                 0Ah     terminate address (old int 22h)
  2041.                 0Ch     terminate segment
  2042.                 0Eh     break address (old int 23h)
  2043.                 10h     break segment
  2044.                 12h     error address (old int 24h)
  2045.                 14h     error segment
  2046.                 16h     parent PSP segment
  2047.                 18h     DOS 2.0+ open files, 0FFh = unused
  2048.                 2Ch     DOS 2.0+ environment segment
  2049.                 2Eh     far ptr to process's SS:SP
  2050.                 32h     DOS 3.x max open files
  2051.                 34h     DOS 3.x openfile table address
  2052.                 36h     DOS 3.x openfile table segment
  2053.                 38h     unused by DOS versions <= 3.3
  2054.                 50h     DOS function dispatcher (FAR routine)
  2055.                 53h     unused
  2056.                 55h     FCB #1 extension
  2057.                 5Ch     FCB #1
  2058.                 6Ch     FCB #2
  2059.                 80h     command tail / default DTA buffer
  2060. note 1) Used in DOS 2.x, 3.x uses 62h
  2061.      2) Function 51h is dangerous in background operations prior to DOS 3.x as 
  2062.         it uses the wrong stack for saving registers.  (same as functions 
  2063.         0..0Ch in DOS 2.x)                                           
  2064.      3) 50h and 51h might be used if you have more than one process in a PC.
  2065.         For instance if you have a resident program that needs to open a file
  2066.         you could first call 51h to save the current id and then call 50h to set
  2067.         the ID to your PSP.
  2068.      4) Under DOS 2.x, this function cannot be invoked inside an int 28h handler
  2069.         without setting the Critical Error flag
  2070.      5) Used by DOS 3.3 PRINT, DEBUG
  2071.  
  2072.  
  2073. Function  52h   "Used Internally by DOS" - IN-VARS   
  2074.  *              Returns a pointer to a set of DOS data variables MCB chain,
  2075.                 pointer to first device driver and a pointer to disk parameter
  2076.                 blocks (first one)
  2077. entry   AH      52h
  2078. return  ES:BX   pointer to the DOS list of lists, for disk information. Does not
  2079.                 access the disk, so information in tables might be incorrect if
  2080.                 disk has been changed. Returns a pointer to the following array
  2081.                 of longword pointers:
  2082.                 Bytes   Value
  2083.                 -2h,-1h segment of first memory control block
  2084.                 00h-03h pointer to first DOS disk block (see function 36h)
  2085.                 04h-07h Pointer to list of DOS file tables
  2086.                         dword   pointer to next file table
  2087.                         word    number of files in this table
  2088.                                 35h bytes per file
  2089.                                 00h-01h number of file handles referring to
  2090.                                         this file
  2091.                                 02h-06h unknown
  2092.                                 07h-0Ah pointer to device driver header if
  2093.                                         character device; pointer to DOS Device
  2094.                                         Control Block if block device (see
  2095.                                         fn 32h for format)
  2096.                                 0Bh-1Fh unknown
  2097.                                 20h-2Ah filename in FCB format (no path, no
  2098.                                         period, blank-padded)
  2099.                                 2Bh-2Ch PSP segment of file's owner
  2100.                                 2Dh-30h unknown -  0 always
  2101.                                 31h-32h unknown
  2102.                                 33h-34h unknown
  2103.                 8h-0Bh  pointer to CLOCK$ device driver, whether installable or
  2104.                         resident
  2105.                 0Ch-0Fh pointer to actual CON: device driver, whether 
  2106.                         installable or resident
  2107.         (DOS 2.x)
  2108.                 10      number of logical drives in system
  2109.                 11-12   maximum bytes/block of any block device
  2110.                 13-16   unknown
  2111.                 17      beginning (not a pointer. The real beginning!) of NUL
  2112.                         device driver. This is the first device on DOS's linked
  2113.                         list of device drivers.
  2114.         (DOS 3.x)
  2115.                 10h-11h maximum bytes/block of any block device (0200h)
  2116.                 12h-15h pointer to first disk buffer
  2117.                 16h-19h partially undefined: Pointer to array of drive info:
  2118.                         51h bytes per drive, starting with A: ...
  2119.                         00h-3Fh current path as ASCIIZ, starting with 'x:\'
  2120.                         40h-43h unknown    zeros always
  2121.                         44h     unknown    flags? Usually 40h, except for
  2122.                                 entry after last valid entry = 00h
  2123.                         45h-48h pointer to DOS disk block for this drive
  2124.                         49h-4Ah unknown. Current track or block? 
  2125.                                 -1 if never accessed
  2126.                         4Bh-4Eh unknown  -1 always
  2127.                         4Fh-52h unknown   2 always
  2128.                 1Ah-1Dh pointer to FCB table (if CONFIG.SYS contains FCBS=)
  2129.                 1Eh-1Fh size of FCB table
  2130.                 20h     number of block devices
  2131.                 21h     value of LASTDRIVE command in CONFIG.SYS (default 5)
  2132.                 22h     beginning (not a pointer. The real beginning!) of NUL 
  2133.                         device driver. This is the first device on DOS's linked 
  2134.                         list of device drivers.
  2135. note 1) This call is not supported in OS/2 1.0's DOS Compatibility Box
  2136.      2) Used by DOS 4.0 MEM.EXE, DOS 3.3 ASSIGN.COM, PRINT.COM, SUBST.EXE
  2137.  
  2138.                                                                               
  2139. Function  53h   "Used Internally by DOS" - Translate BPB
  2140.  *              Translates BPB (BIOS Parameter Block, see below) into a DOS Disk
  2141.                 Block (see function call 32h).  
  2142. entry   AH      53h
  2143.         DS:SI   pointer to BPB 
  2144.         ES:BP   pointer to area for DOS Disk Block.
  2145.                 Layout of Disk Block:
  2146.                 bytes   value
  2147.                 00h-01h bytes per sector, get from DDB bytes 02h-03h.
  2148.                 02h     sectors per cluster, get from (DDB byte 4) + 1
  2149.                 03h-04h reserved sectors, get from DDB bytes 06h-07h
  2150.                 05h     number of FATs, get from DDB byte 08h
  2151.                 06h-07h number of root dir entries, get from DDB bytes 09h-0Ah
  2152.                 08h-09h total number of sectors, get from: 
  2153.                         ((DDB bytes 0Dh-0Eh) - 1) * (sectors per cluster (BPB 
  2154.                         byte 2)) + (DDB bytes 0Bh-0Ch)
  2155.                 0Ah     media descriptor byte, get from DDB byte 16h
  2156.                 0Bh-0Ch number of sectors per FAT, get from DDB byte 0Fh
  2157. return  unknown                          
  2158.  
  2159.  
  2160. Function  54h   Get Verify Setting
  2161.                 Get verify flag status
  2162. entry   AH      54h
  2163. return  AL      00h if flag off
  2164.                 01h if flag on
  2165. note    Flag can be set with function 2Eh
  2166.         
  2167.                                          
  2168. Function  55h   "Used Internally by DOS" - Create "Child" PSP
  2169.  *              Create PSP: similar to function 26h (which creates a new Program
  2170.                 Segment Prefix at segment in DX) except creates a "child" PSP
  2171.                 rather than copying the existing one.
  2172. entry   AH      55h
  2173.         DX      segment number at which to create new PSP.
  2174. return  unknown
  2175. note 1) This call is similar to call 26h which creates a PSP except that unlike
  2176.         call 26h the segment address of the parent process is obtained from the
  2177.         current process ID rather than from the CS value on the stack (from the
  2178.         INT 21h call). DX has the new PSP value and SI contains the value to be
  2179.         placed into PSP:2 (top of memory).
  2180.      2) Function 55 is merely a substitute for function 26h. It will copy the
  2181.         current PSP to the segment address DX with the addition that SI is
  2182.         assumed to hold the new memory top segment. This means that function 
  2183.         26h sets SI to the segment found in the current PSP and then calls
  2184.         function 55h. 
  2185.  
  2186.                                          
  2187. Function  56h   Rename a File
  2188. entry   AH      56h
  2189.         DS:DX   pointer to ASCIIZ old pathname
  2190.         ES:DI   pointer to ASCIIZ new pathname
  2191. return  CF      clear   successful rename
  2192.                 set     AX      error code (2, 3, 5, 11h)
  2193. note 1) Works with files in same drive only
  2194.      2) Global characters not allowed in filename
  2195.      3) The name of a file is its full pathname. The file's full pathname can
  2196.         be changed, while leaving the actual FILENAME.EXT unchanged. Changing
  2197.         the pathname allows the file to be "moved" from subdirectory to
  2198.         subdirectory on a logical drive without actually copying the file.
  2199.      4) DOS 3.x allows renaming of directories
  2200.  
  2201.  
  2202.