home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / ZSDOS1.HZP / ZSDOS1.HLP
Encoding:
Text File  |  1991-11-18  |  11.6 KB  |  231 lines
  1.  Function  1:  Console Input     -- Device I/O Functions --
  2.  Function  2:  Console Output
  3.  Function  3:  Auxiliary Input (Reader)  
  4.  Function  4:  Auxiliary Output (Punch)
  5.  Function  5:  List Output 
  6.  Function  6:  Direct Console I/O
  7.  Function  7:  Get IOBYTE
  8.  Function  8:  Set IOBYTE
  9.  Function  9:  Print String
  10.  Function 10:  Read Console Buffer 
  11.  Function 11:  Get Console Status
  12. :
  13.  
  14.      +---------------------------------------------------------------+
  15.      |                  FUNCTION 1 -- CONSOLE INPUT                  |
  16.      +------------------------------+--------------------------------+
  17.      | Entry:  C = 1 (01h)          | Exit:  A = Character           |
  18.      |                              |                                |
  19.      |                              |                                |
  20.      +------------------------------+--------------------------------+
  21.  
  22. Returns the next character from the system console.  If no character is 
  23. ready, this function waits for one before returning.
  24.  
  25. Printable characters, carriage return, line feed, and backspace are echoed 
  26. to the console unchanged.  Tabs are expanded with spaces.  No other control 
  27. characters are echoed.
  28.  
  29. If Control-S is entered, console output is suspended until another 
  30. character is entered.  If a Control-C is entered following a Control-S, the 
  31. error mode is reset to the default and a warm boot is executed.  Any other 
  32. character causes console output to resume.
  33. :
  34.  
  35.      +---------------------------------------------------------------+
  36.      |                 FUNCTION 2 -- CONSOLE OUTPUT                  |
  37.      +--------------------------------+------------------------------+
  38.      | Entry:  C = 2 (02h)            | Exit:  None                  |
  39.      |         E = Character          |        (A = BIOS A register) |
  40.      |                                |                              |
  41.      +--------------------------------+------------------------------+
  42.  
  43. Sends the character in the E register to the system console.  Printable 
  44. characters, carriage return, line feed, and backspace are echoed to the 
  45. console unchanged.  Tabs are expanded with spaces.  No other control 
  46. characters are echoed.
  47.  
  48. The console is also checked for a Control-S.  If Control-S is entered, 
  49. console output is suspended until another character is entered.  If a 
  50. Control-C is entered following a Control-S, the error mode is reset to the 
  51. default and a warm boot is executed.  Any other character causes console 
  52. output to resume.
  53.  
  54. This function should not be used for outputting video terminal control 
  55. codes.  Instead, use Function 6.
  56. :
  57.  
  58.      +---------------------------------------------------------------+
  59.      |            FUNCTION 3 -- AUXILIARY INPUT (READER)             |
  60.      +------------------------------+--------------------------------+
  61.      | Entry:  C = 3 (03h)          | Exit:  A = Character           |
  62.      |                              |                                |
  63.      |                              |                                |
  64.      +------------------------------+--------------------------------+
  65.  
  66. Returns the next character from the current auxiliary device.  If no 
  67. character is ready, this function waits for one before returning.
  68.  
  69. No control character filtering is done.
  70. :
  71.  
  72.      +---------------------------------------------------------------+
  73.      |            FUNCTION 4 -- AUXILIARY OUTPUT (PUNCH)             |
  74.      +--------------------------------+------------------------------+
  75.      | Entry:  C = 4 (04h)            | Exit:  None                  |
  76.      |         E = Character          |        (A = BIOS A register) |
  77.      |                                |                              |
  78.      +--------------------------------+------------------------------+
  79.  
  80. Sends the character in the E register to the current auxiliary device.  The 
  81. function will wait for the device to accept the character.
  82.  
  83. No control character filtering is done.
  84. :
  85.  
  86.      +---------------------------------------------------------------+
  87.      |                   FUNCTION 5 -- LIST OUTPUT                   |
  88.      +--------------------------------+------------------------------+
  89.      | Entry:  C = 5 (05h)            | Exit:  None                  |
  90.      |         E = Character          |        (A = BIOS A register) |
  91.      |                                |                              |
  92.      +--------------------------------+------------------------------+
  93.  
  94. Sends the character in the E register to the current LST device.  The 
  95. function will wait for the device to accept the character.  The BIOS list 
  96. output routine is not called before sending the byte.
  97. :
  98.  
  99.      +---------------------------------------------------------------+
  100.      |               FUNCTION 6 -- DIRECT CONSOLE I/O                |
  101.      +--------------------------------+------------------------------+
  102.      | Entry:  C = 6 (06h)            | Exit:                        |
  103.      |         E = FFh (Input)        |   A = Character (0 = None)   |
  104.      |         E = FEh (Input)        |   A = Status (0 = No Char)   |
  105.      |         E = FDh (Input)        |   A = Character              |
  106.      |         E = 00h-FCh (Output)   |   None (A = BIOS A register) |
  107.      +--------------------------------+------------------------------+
  108.  
  109. Performs direct console I/O with no character interpretation.  The contents 
  110. of register E determine what this call does:
  111.  
  112.      FFh = Return next console character, or 0 if no character is available.
  113.      FEh = Return console status (0 if no character ready).
  114.      FDh = Return next console character, wait if no character is ready.
  115.  00h-FCh = Output character in E to console.
  116.  
  117. Terminal video controls should use this function rather than Function 2.
  118. :
  119.  
  120.      +---------------------------------------------------------------+
  121.      |                   FUNCTION 7 -- GET IOBYTE                    |
  122.      +------------------------------+--------------------------------+
  123.      | Entry:  C = 7 (07h)          | Exit:  A = IOBYTE              |
  124.      |                              |                                |
  125.      |                              |                                |
  126.      +------------------------------+--------------------------------+
  127.  
  128. Returns the IOBYTE, which is stored at 03h in the zero page.  The byte is 
  129. used by some BIOS's to redirect output, but the contents of the byte are 
  130. implementation dependant.
  131.  
  132. For a common implementation scheme, see the next screen.
  133.  
  134. Function 7 (continued)
  135.  
  136. A common IOBYTE implementation scheme:
  137.  
  138.          +----------+----------+----------+----------+----------+
  139.          |  IOBYTE: |  7    6  |  5    4  |  3    2  |  1    0  |
  140.          +----------+----------+----------+----------+----------+
  141.          |   bit    |   LST:   |  AUXIN:  |  AUXOUT: |   CON:   |
  142.          |  value   |          |  (PUN:)  |  (RDR:)  |          |
  143.          +----------+----------+----------+----------+----------+
  144.          |    00    |   TTY:   |   TTY:   |   TTY:   |   TTY:   |
  145.          |    01    |   CRT:   |   PTP:   |   PTR:   |   CRT:   |
  146.          |    10    |   LPT:   |   UP1:   |   UR1:   |   BAT:   |
  147.          |    11    |   UL1:   |   UP2:   |   UR2:   |   UC1:   |
  148.          +----------+----------+----------+----------+----------+
  149. :
  150.  
  151.      +---------------------------------------------------------------+
  152.      |                   FUNCTION 8 -- SET IOBYTE                    |
  153.      +--------------------------------+------------------------------+
  154.      | Entry:  C = 8 (08h)            | Exit:  None                  |
  155.      |         E = IOBYTE             |        (A = IOBYTE)          |
  156.      |                                |                              |
  157.      +--------------------------------+------------------------------+
  158.  
  159. Sets the IOBYTE, which is stored at 03h in the zero page.  The byte is used 
  160. by some BIOS's to redirect output, but the contents of the byte are 
  161. implementation dependant.
  162.  
  163. For a common implementation scheme, see Function 7 (Get IOBYTE).
  164. :
  165.  
  166.      +---------------------------------------------------------------+
  167.      |                  FUNCTION 9 -- PRINT STRING                   |
  168.      +--------------------------------+------------------------------+
  169.      | Entry:  C = 9 (09h)            | Exit:  None                  |
  170.      |        DE = Address of string  |        (A = "$")             |
  171.      |                                |                              |
  172.      +--------------------------------+------------------------------+
  173.  
  174. Prints a string on the console.  Tabs are expanded to spaces.  The string 
  175. must be terminated with a dollar sign ("$")
  176.  
  177. The console is also checked for a Control-S.  If Control-S is entered, 
  178. console output is suspended until another character is entered.  If a 
  179. Control-C is entered following a Control-S, the error mode is reset to the 
  180. default and a warm boot is executed.  Any other character causes console 
  181. output to resume.
  182. :
  183.  
  184.      +---------------------------------------------------------------+
  185.      |              FUNCTION 10 -- READ CONSOLE BUFFER               |
  186.      +--------------------------------+------------------------------+
  187.      | Entry:  C = 10 (0Ah)           | Exit:  None                  |
  188.      |        DE = Buffer address     |        (A = 0Dh)             |
  189.      |                                |                              |
  190.      +--------------------------------+------------------------------+
  191.  
  192. Reads a string of characters from the console into a buffer.  The buffer, 
  193. whose address is passed in DE, must be set up as follows:
  194.                       Buff+0   Buff+1  Buff+2 -->
  195.                     +--------+-------+---------------->
  196.                     | length | count | input buffer -->
  197.                     +--------+-------+---------------->
  198. The byte at Buff+0 gives the actual length of the input buffer that begins 
  199. at Buff+2 (maximum is 255).  It must be filled in before the call.  The 
  200. byte at Buff+1 is filled in by this function and will give the actual 
  201. number of characters in the input buffer.  Bytes beginning at Buff+2 are 
  202. the characters received from the console (minus any terminating carriage 
  203. return or line feed).
  204.  
  205. Function 10 (continued)
  206.  
  207. Input ends when a carriage return or line feed is received or the buffer is 
  208. filled.  If a Control-C is received as the first character in the buffer, 
  209. the program is aborted with a warm boot.  A Control-P will toggle printer 
  210. echo on and off.  Tabs are echoed as spaces and control characters not used 
  211. for editing are echoed as a carat followed by an upper-case letter (that 
  212. is, Control-Z is echoed as "^Z").  The buffer will contain the actual 
  213. characters.
  214.  
  215. The following keys may be used to edit the line as it is entered from the 
  216. console:
  217.             ^H or DEL -- deletes character to left of cursor.
  218.             ^X or ^U  -- deletes entire line.
  219.                ^R     -- retype line (not for ZDDOS).
  220. :
  221.  
  222.      +---------------------------------------------------------------+
  223.      |               FUNCTION 11 -- GET CONSOLE STATUS               |
  224.      +------------------------------+--------------------------------+
  225.      | Entry:  C = 11 (0Bh)         | Exit:  A = Console status      |
  226.      |                              |        (0 = no character ready)|
  227.      |                              |        (1 = character ready)   |
  228.      +------------------------------+--------------------------------+
  229.  
  230. Polls the console to determine whether it has a character ready to send.
  231.