home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / docs / acdiref.inf (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1993-08-15  |  196.0 KB  |  6,861 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Version Notice ΓòÉΓòÉΓòÉ
  3.  
  4. First Edition (October 1992) 
  5.  
  6. The following paragraph does not apply to the United Kingdom or any country 
  7. where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS 
  8. MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY 
  9. KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
  10. WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states 
  11. do not allow disclaimer of express or implied warranties in certain 
  12. transactions; therefore, this statement may not apply to you. 
  13.  
  14. This publication could include technical inaccuracies or typographical errors. 
  15. Changes are periodically made to the information herein; these changes will be 
  16. incorporated in new editions of the publication. IBM may make improvements 
  17. and/or changes in the product(s) and/or the program(s) described in this 
  18. publication at any time. 
  19.  
  20. It is possible that this publication may contain reference to, or information 
  21. about, IBM products (machines and programs), programming, or services that are 
  22. not announced in your country.  Such references or information must not be 
  23. construed to mean that IBM intends to announce such IBM products, programming, 
  24. or services in your country. 
  25.  
  26. Requests for copies of this publication and for technical information about IBM 
  27. products should be made to your IBM Authorized Dealer or your IBM Marketing 
  28. Representative. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. Notices ΓòÉΓòÉΓòÉ
  32.  
  33. References in this publication to IBM products, programs, or services do not 
  34. imply that IBM intends to make them available in all countries in which IBM 
  35. operates. Any reference to an IBM product, program, or service is not intended 
  36. to state or imply that only that IBM product, program, or service may be used. 
  37. Any functionally equivalent product, program, or service that does not infringe 
  38. any of the intellectual property rights of IBM may be used instead of the IBM 
  39. product, program, or service. The evaluation and verification of operation in 
  40. conjunction with other products, except those expressly designated by IBM, are 
  41. the responsibility of the user. 
  42.  
  43. IBM may have patents or pending patent applications covering subject matter 
  44. described in this document. The furnishing of this document does not give you 
  45. any license to these patents. You can send license inquiries, in writing, to 
  46. the IBM Director of Commercial Relations, IBM Corporation, Purchase, New York, 
  47. 10577, U.S.A. 
  48.  
  49. The licensed program described in this document and all licensed material 
  50. available for it are provided by IBM under terms of the IBM Customer Agreement. 
  51.  
  52. This document is not intended for production use and is furnished as is without 
  53. any warranty of any kind, and all warranties are hereby disclaimed including 
  54. the warranties of merchantability and fitness for a particular purpose. 
  55.  
  56. The following terms, denoted by an asterisk (*) in this publication, are 
  57. trademarks of the IBM Corporation in the United States or other countries. 
  58.  
  59. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  60. Γöé Advanced Peer-to-Peer Networking    Γöé Micro Channel             Γöé
  61. Γöé Application System/400         Γöé NetView                Γöé
  62. Γöé APPN                  Γöé Operating System/2          Γöé
  63. Γöé AS/400                 Γöé OS/2                 Γöé
  64. Γöé AT                   Γöé Personal Computer AT         Γöé
  65. Γöé FFST/2                 Γöé Personal System/2           Γöé
  66. Γöé First Failure Support Technology/2   Γöé Presentation Manager         Γöé
  67. Γöé IBM                  Γöé PS/2                 Γöé
  68. Γöé Macro Assembler/2           Γöé System/370              Γöé
  69. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  70.  
  71. The following terms, denoted by a double asterisk (**) in this publication, are 
  72. trademarks of other companies: 
  73.  
  74. Hayes                                   Hayes Microcomputer Products, Inc. 
  75. MCI                                     MCI Communications Corporation. 
  76. MicroCom                                MicroCom Systems, Inc. 
  77. Micro Focus                             Micro Focus Limited 
  78. Micro Focus COBOL/2                     Micro Focus Limited 
  79. National Semiconductor                  National Semiconductor Corporation 
  80. Racal-Vadic                             Racal Electronics Public Limited Co. 
  81. ROLMphone                               ROLM Systems 
  82. Smartmodem                              Hayes Microcomputer Products, Inc. 
  83. Sprint                                  US Sprint Communications Company 
  84. Microsoft                               Microsoft Corporation 
  85.  
  86.  
  87. ΓòÉΓòÉΓòÉ 3. About This Book ΓòÉΓòÉΓòÉ
  88.  
  89. IBM* Communications Manager/2 Version 1.0 (referred to in this book as 
  90. Communications Manager) is a communications services platform. This platform 
  91. provides a wide range of services for IBM Operating System/2* (OS/2*) 
  92. workstations that communicate with host computers and with other workstations. 
  93. Communications Manager users can choose from among a variety of remote 
  94. connectivity options. 
  95.  
  96. IBM Communications Manager/2 Version 1.0 ACDI Programming Reference (referred 
  97. to in the remainder of this book as ACDI Programming Reference) defines the 
  98. Communications Manager Asynchronous Communications Device Interface (ACDI) 
  99. application programming interface (API). It serves as a reference for 
  100. programmers who want to use the C and Macro Assembler languages to create their 
  101. own application programs using Communications Manager for the IBM Personal 
  102. Computer AT* and for the the IBM Personal System/2* computer. The following 
  103. compilers are supported: 
  104.  
  105. o Microsoft** C 6.0 (referred to as C in the remainder of this book) or its 
  106.   functional equivalent 
  107.  
  108. o Micro Focus** COBOL/2** (referred to as COBOL in the remainder of this book) 
  109.   or its functional equivalent 
  110.  
  111. o IBM Macro Assembler/2* (referred to as MASM in the remainder of this book) or 
  112.   its functional equivalent 
  113.  
  114. It is assumed that you are using OS/2 Version 1.30.1 with corrective service 
  115. diskette (CSD) 5050 or higher or OS/2 Version 2.0 as your base operating 
  116. system. The term OS/2, as it is used in the Communications Manager 
  117. documentation and on the display during the running of the programs, refers to 
  118. some or all components of the base operating system. If you use a base 
  119. operating system that is functionally equivalent to OS/2 Version 1.30.1 with 
  120. CSD 5050 or higher or OS/2 Version 2.0, the Communications Manager 
  121. documentation still applies. 
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ 3.1. Who Should Use This Book ΓòÉΓòÉΓòÉ
  125.  
  126. This reference book is for application programmers who are familiar with both 
  127. the asynchronous communications environment and the information provided in IBM 
  128. Communications Manager/2 Version 1.0 User's Guide. 
  129.  
  130. Users should also know how to: 
  131.  
  132. o Write application programs in the C or Macro Assembler language 
  133.  
  134. o Configure the Communications Manager program to support the application 
  135.   programs that support ACDI 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 3.2. How to Use This Book ΓòÉΓòÉΓòÉ
  139.  
  140. The following sections describe the organization of this book and the 
  141. conventions used throughout the Communications Manager library. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 3.2.1. How This Book Is Organized ΓòÉΓòÉΓòÉ
  145.  
  146. This book contains the following chapters and appendixes: 
  147.  
  148. Communications Manager, Asynchronous Communications, and ACDI, provides the 
  149. application programmer with an overview of ACDI and its relationship to the 
  150. Communications Manager environment. 
  151.  
  152. ACDI Functions, Structure, and Verb Overview, provides an overview of 
  153. asynchronous communications concepts as used in ACDI with an overview of ACDI 
  154. features. 
  155.  
  156. Writing, Building, and Debugging Your Application Using ACDI, outlines the main 
  157. topics in writing applications for ACDI. 
  158.  
  159. ACDI Verb Descriptions, provides a complete description of each ACDI verb. 
  160.  
  161. Using the ACDI Redirection API, describes how to use the ACDI Redirection 
  162. application programming interface (API) and provides a detailed description of 
  163. the six ACDI Redirection API functions. 
  164.  
  165. ACDI Return Codes, provides a complete list of ACDI return codes. 
  166.  
  167. ACDI Redirection API Return Codes, provides a complete list of ACDI Redirection 
  168. return codes. 
  169.  
  170. An index follows the appendixes. Consult Glossary for definitions of terms used 
  171. in this library.  Glossary is available online and is separately orderable. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 3.2.2. Conventions Used in This Library ΓòÉΓòÉΓòÉ
  175.  
  176. The following conventions are used throughout the Communications Manager 
  177. library.  Some of the conventions listed may not be used in this particular 
  178. book. 
  179.  
  180.  
  181. ΓòÉΓòÉΓòÉ 3.2.2.1. Text Conventions ΓòÉΓòÉΓòÉ
  182.  
  183. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  184. Γöé BOLD      Γöé Bold type indicates the following:              Γöé
  185. Γöé         Γöé                               Γöé
  186. Γöé         Γöé o  The names of window controls, such as lists, check    Γöé
  187. Γöé         Γöé   boxes, entry fields, and menu choices.  They appear in  Γöé
  188. Γöé         Γöé   the text as they appear in the window.          Γöé
  189. Γöé         Γöé                               Γöé
  190. Γöé         Γöé o  Verbs, functions, and parameters that you can use in a  Γöé
  191. Γöé         Γöé   program or at a command prompt.  These values are case  Γöé
  192. Γöé         Γöé   sensitive and should be entered exactly as they appear  Γöé
  193. Γöé         Γöé   in the text.                       Γöé
  194. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  195. Γöé Italics     Γöé Italics indicate a variable that you supply a value for.   Γöé
  196. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  197. Γöé UPPERCASE    Γöé Uppercase indicates constants, file names, keywords, and   Γöé
  198. Γöé         Γöé options that you can use in a program or at a command    Γöé
  199. Γöé         Γöé prompt.  You can enter these values in uppercase or lower-  Γöé
  200. Γöé         Γöé case.                            Γöé
  201. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  202. Γöé "Example type" Γöé Example type indicates information that the user is     Γöé
  203. Γöé         Γöé instructed to type at a command prompt or in a window.    Γöé
  204. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ 3.2.2.2. Numbers Conventions ΓòÉΓòÉΓòÉ
  208.  
  209. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  210. Γöé Hexadecimal   Γöé Represented as X'xxxx' except in certain instances where   Γöé
  211. Γöé         Γöé they are represented with text ("The location hex xxxx is  Γöé
  212. Γöé         Γöé the address of...").  In an example of assembly language   Γöé
  213. Γöé         Γöé code, a hexadecimal number is represented by a lowercase h  Γöé
  214. Γöé         Γöé following the hexadecimal characters.            Γöé
  215. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  216. Γöé Binary     Γöé Represented as B'xxxx xxxx' or B'x' except in certain    Γöé
  217. Γöé         Γöé instances where they are represented with text ("A value of Γöé
  218. Γöé         Γöé binary xxxx xxxx is...").                  Γöé
  219. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  220. Γöé Bit positions  Γöé Start with 0 at the rightmost position (least significant  Γöé
  221. Γöé         Γöé bit).                            Γöé
  222. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 3.2.2.3. Syntax Diagrams ΓòÉΓòÉΓòÉ
  226.  
  227. Throughout this library, conceptual diagrams are used to illustrate the 
  228. programming syntax. The following list tells you how to interpret the syntax 
  229. diagrams: 
  230.  
  231. o Read the syntax diagrams from left to right, from top to bottom, following 
  232.   the path of the line. 
  233.  
  234. o Items shown on the main path of the syntax statement are required syntax. 
  235.  
  236.     >>ΓöÇΓöÇKEYWORDΓöÇΓöÇkeyword_nameΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  237.  
  238. o Items shown on branches below the main path are optional syntax. 
  239.  
  240.     >>ΓöÇΓöÇKEYWORDΓöÇΓöÇkeyword_nameΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  241.                   ΓööΓöÇITEM1ΓöÇΓöÿ  ΓööΓöÇITEM2ΓöÇΓöÿ
  242.  
  243. o Items shown on branches above the main path are default syntax. 
  244.  
  245.                   -ITEM1ΓöÇ.
  246.     >>ΓöÇΓöÇKEYWORDΓöÇΓöÇkeyword_nameΓöÇΓöÇ'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  247.  
  248. o Items appearing in a stack indicate that only one of the items may be 
  249.   specified.  When one of the items in a stack appears on the main path, you 
  250.   must choose one of the items. 
  251.  
  252.   For example, in the following syntax diagram, you must choose either ITEM1 or 
  253.   ITEM2.  ITEM3 and ITEM4 both appear below the main path, so neither of them 
  254.   is required. 
  255.  
  256.     >>ΓöÇΓöÇKEYWORDΓöÇΓöÇkeyword_nameΓöÇΓöÇΓö¼ΓöÇITEM1ΓöÇΓö¼ΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  257.                   ΓööΓöÇITEM2ΓöÇΓöÿ  Γö£ΓöÇITEM3ΓöÇΓöñ
  258.                        ΓööΓöÇITEM4ΓöÇΓöÿ
  259.  
  260. o A repeat arrow shown above an item or a stack of items indicates that you can 
  261.   specify the item multiple times or specify more than one of the items.  A 
  262.   character (such as a comma) on the repeat arrow line indicates that the items 
  263.   must be separated by that character. 
  264.  
  265.   For example, in the following syntax diagram, you can specify both ITEM1 and 
  266.   ITEM2, but you must use a comma to separate the choices in your programming 
  267.   syntax. 
  268.  
  269.                   -,ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  270.                       Γöé
  271.     >>ΓöÇΓöÇKEYWORDΓöÇΓöÇkeyword_nameΓöÇΓöÇΓöÇΓö¼ΓöÇITEM1ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  272.                   ΓööΓöÇITEM2ΓöÇΓöÿ
  273.  
  274. o In some cases, when an item has additional items associated with it, an 
  275.   additional syntax diagram is shown that represents the full syntax of that 
  276.   item.  For example, in the following syntax diagram, additional information 
  277.   that can be specified for ITEM1 appears in the "ITEM1" Variables syntax 
  278.   diagram. 
  279.  
  280.     >>ΓöÇΓöÇKEYWORDΓöÇΓöÇkeyword_nameΓöÇΓöÇΓöñ ITEM1 Γö£ΓöÇΓöÇITEM2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ><
  281.     ITEM1 VARIABLES:
  282.     Γö£ΓöÇΓöÇΓö¼ΓöÇvariable1ΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  283.       Γö£ΓöÇvariable2ΓöÇΓöñ
  284.       ΓööΓöÇvariable3ΓöÇΓöÿ
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 3.3. What Is New in This Book ΓòÉΓòÉΓòÉ
  288.  
  289. This book reflects the following changes made from Extended Services for OS/2. 
  290.  
  291. o ACDI Redirection application interface added 
  292. o ACDI configuration information moved to Configuration Guide 
  293. o Common services programming interface verbs moved to Application Programming 
  294.   Guide 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 3.4. Where to Find More Information ΓòÉΓòÉΓòÉ
  298.  
  299. The following sections list publications about Communications Manager, its 
  300. installation, and its operation. 
  301.  
  302.  
  303. ΓòÉΓòÉΓòÉ 3.4.1. Communications Manager/2 Version 1.0 Library ΓòÉΓòÉΓòÉ
  304.  
  305. The following lists encompass all the books in the Communications Manager 
  306. library.  The words "IBM Communications Manager/2 Version 1.0" are actually 
  307. part of the title of each book; however, in these lists, those words are 
  308. omitted. 
  309.  
  310.  
  311. ΓòÉΓòÉΓòÉ 3.4.1.1. Basic User Books ΓòÉΓòÉΓòÉ
  312.  
  313. The following books provide the basic information you need to get your system 
  314. installed and operational: 
  315.  
  316. o Overview 
  317.  
  318.   This online publication provides a comprehensive view of Communications 
  319.   Manager. It includes a description of configuration, services, emulator 
  320.   functions, application programming interfaces, and a complete bibliography of 
  321.   Communications Manager documentation and related publications. 
  322.  
  323. o Quick Installation, SX75-0085 
  324.  
  325.   This card provides you with a very brief set of instructions on how to start 
  326.   the installation of Communications Manager.  It is intended primarily for 
  327.   those who want to accept most or all of the preselected choices during 
  328.   installation.  Quick Installation provides only limited instructions to get 
  329.   you started.  If you want more detailed information about installing 
  330.   Communications Manager, refer to Workstation Installation Guide. 
  331.  
  332. o Start Here, SC31-6104 
  333.  
  334.   This book contains a brief overview of Communications Manager and guides you 
  335.   to the Communications Manager library and related publications.  In addition, 
  336.   this book identifies tasks you need to perform related to planning, 
  337.   installing, and configuring Communications Manager, and it provides you with 
  338.   information sources to support these tasks. 
  339.  
  340. o Information and Planning Guide, SC31-7007 
  341.  
  342.   This book provides an overview of Communications Manager, including 
  343.   descriptions of new and enhanced functions and productivity aids, information 
  344.   on administration and usage of Communications Manager, and system 
  345.   requirements. It also provides technical advice on performance and 
  346.   coexistence considerations, planning new installations, and migrating from 
  347.   previous releases. 
  348.  
  349. o Workstation Installation Guide, SC31-6169 
  350.  
  351.   This book provides the steps and basic information to install Communications 
  352.   Manager.  This book also contains information about using a response file and 
  353.   changing a configuration. 
  354.  
  355. o Configuration Guide, SC31-6171 
  356.  
  357.   This book describes how to configure Communications Manager for various 
  358.   connections and features.  It also describes advanced user tasks, such as how 
  359.   to use the keylock function to protect configuration files. 
  360.  
  361. o Configuration Worksheets, SX75-0088 
  362.  
  363.   A set of worksheets for the user or network administrator to map 
  364.   configurations for Communications Manager. 
  365.  
  366. o User's Guide, SC31-6108 
  367.  
  368.   This book provides information necessary to accomplish basic communications 
  369.   tasks using Communications Manager. For example, this volume contains 
  370.   information and procedures for starting and stopping Communications Manager, 
  371.   using the clipboard to mark and copy data from one application to another, 
  372.   using 3270 and 5250 emulation, transferring files, and printing files. In 
  373.   addition, this book explains how to use keyboard remap for changing the 
  374.   functions of the keys on your terminal emulation keyboard.  It also explains 
  375.   how to use messages and the message log. 
  376.  
  377. o Keyboard Templates, SX75-0073 
  378.  
  379.   This documentation provides templates to place on your workstation keyboard 
  380.   that show you the keystrokes to use for 3270 and 5250 functions. 
  381.  
  382. o Command Reference 
  383.  
  384.   This online documentation lists the Communications Manager commands and their 
  385.   syntax diagrams. It also describes Communications Manager device drivers. 
  386.  
  387. o Glossary, SC31-6155 
  388.  
  389.   This book defines technical terms and acronyms that are used throughout the 
  390.   Communications Manager program and publications. It is available online and 
  391.   is separately orderable in hard copy. 
  392.  
  393.  
  394. ΓòÉΓòÉΓòÉ 3.4.1.2. Advanced User Books ΓòÉΓòÉΓòÉ
  395.  
  396. The following separately orderable books provide advanced planning and 
  397. installation information for Communications Manager: 
  398.  
  399. o Network Administration and Subsystem Management Guide, SC31-6168 
  400.  
  401.   This book defines concepts and planning procedures for configuration, 
  402.   installation, and networking considerations. It also describes how to prepare 
  403.   a response file and how to use a response file to create or modify a 
  404.   configuration. Network Administrator Sample Program Diskette, which contains 
  405.   sample response files, is shipped with this book. 
  406.  
  407. o Scenarios, SC31-6174 
  408.  
  409.   This book contains sample scenarios with steps to install and configure 
  410.   several different kinds of networks with attached workstations. 
  411.  
  412. o Problem Determination Guide, SC31-6156 
  413.  
  414.   This book describes Communications Manager diagnostic tools and provides 
  415.   instructions for using them, including specific directions for using First 
  416.   Failure Support Technology/2* (FFST/2*) to identify problems or errors. It 
  417.   also contains reference information to assist in problem determination, as 
  418.   well as a Problem Report Form to use when contacting IBM. 
  419.  
  420. o Host Connection Reference, SC31-6170 
  421.  
  422.   This book contains parameter matching and sample system generations for OS/2 
  423.   connections to System/370* (S/370) and Application System/400* (AS/400*) 
  424.   hosts. 
  425.  
  426. o Service Point Application Router and Remote Operations Service Guide, 
  427.   SC31-7006 
  428.  
  429.   This book contains guidance and reference information for using two 
  430.   Communications Manager functions, Service Point Application Router and Remote 
  431.   Operations Service, to handle network management commands directed to a 
  432.   workstation by a NetView* operator or an application program. 
  433.  
  434. o Message Reference, SC31-6159 
  435.  
  436.   This book contains the text, explanations, and suggested actions for all 
  437.   Communications Manager messages, including alerts and errors. This document 
  438.   is also available online. 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 3.4.1.3. Programming Books ΓòÉΓòÉΓòÉ
  442.  
  443. The following books provide Communications Manager application programming 
  444. interface (API) information for creating and maintaining Communications Manager 
  445. programs: 
  446.  
  447. o Application Programming Guide, SC31-7012 
  448.  
  449.   This book describes application program development for Communications 
  450.   Manager.  It is the starting point for writing application programs that use 
  451.   any of the Communications Manager application programming interfaces (APIs) 
  452.   and contains information common to all of the APIs. The Communications 
  453.   Manager/2 API Support Diskette, which contains sample programs, API data 
  454.   structures, and header files, is provided with this book. 
  455.  
  456. o ACDI Programming Reference, SC31-6161 
  457.  
  458.   This book introduces and defines the procedures for using the Asynchronous 
  459.   Communications Device Interface (ACDI). This book serves as a reference for 
  460.   programmers who want to use the asynchronous programming functions to create 
  461.   their own application programs using C and Macro Assembler languages. 
  462.  
  463. o APPC Programming Guide and Reference, SC31-6160 
  464.  
  465.   This book provides information necessary to create application programs in 
  466.   the C, COBOL, or Macro Assembler programming languages that use the advanced 
  467.   program-to-program communications (APPC) programming interface functions. 
  468.  
  469. o Conventional LU Application Programming Reference, SC31-6166 
  470.  
  471.   This book provides information necessary to create application programs in 
  472.   the C, COBOL, or Macro Assembler programming languages that use the IBM OS/2 
  473.   Conventional LU Application (LUA) programming interface. 
  474.  
  475. o ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 
  476.  
  477.   This book provides programmers with the information necessary to create 
  478.   requester application programs that use the Server-Requester Programming 
  479.   Interface (SRPI) functions in Communications Manager. 
  480.  
  481. o EHLLAPI Programming Reference, SC31-6163 
  482.  
  483.   This book defines the Emulator High-Level Language Application Programming 
  484.   Interface (EHLLAPI). Applications written to this programming interface can 
  485.   access and control the 3270 and 5250 host presentation spaces. 
  486.  
  487. o ISDN Connection Manager Interface (CMI) Programming Reference, SC31-7010 
  488.  
  489.   This book describes how to use the integrated services digital network (ISDN) 
  490.   connection manager interface (CMI) to make a connection for user applications 
  491.   through a switched network. 
  492.  
  493. o ISDN Port Connection Manager (PCM) Programming Reference, SC31-7011 
  494.  
  495.   This book describes how to develop and implement a call control module (a 
  496.   port connection manager) for use in Communications Manager's switched network 
  497.   environment. 
  498.  
  499. o Realtime Interface Co-Processor Device Driver Programming Reference, 
  500.   SC31-6164 
  501.  
  502.   This book provides information for writing programs that support the Realtime 
  503.   Interface Co-Processor adapters. The dynamic link libraries, the application 
  504.   loader, and the device driver interface are discussed. 
  505.  
  506. o System Management Programming Reference, SC31-6173 
  507.  
  508.   This book provides detailed descriptions of the Advanced Peer-to-Peer 
  509.   Networking* (APPN*) configuration and subsystem management verbs.  These 
  510.   verbs allow configuration and management of APPN nodes. 
  511.  
  512. o X.25 Programming Reference, SC31-6167 
  513.  
  514.   This book provides the information necessary to create application programs 
  515.   in the C, COBOL, or Macro Assembler programming languages that use the X.25 
  516.   API. 
  517.  
  518.  
  519. ΓòÉΓòÉΓòÉ 3.4.2. Related Publications ΓòÉΓòÉΓòÉ
  520.  
  521. The following publications are referred to in this book: 
  522.  
  523. o IBM Operating System/2 Technical Library, 10G3356 
  524.  
  525.   The seventeen volumes in this library provide reference and tutorial 
  526.   information for OS/2 2.0 programming end user interfaces, device driver 
  527.   development, and application program development. The guidance information 
  528.   provides a complete guide to designing, writing, and building your 
  529.   application. The reference information is for all the application program 
  530.   interface (API) functions. The entire library can be ordered with a single 
  531.   part number. 
  532.  
  533. o IBM Systems Network Architecture Network Product Formats, LY43-0081-01 
  534.  
  535.   This publication is a summary (at an architecture level) of the formats used 
  536.   between subarea nodes and SNA peripheral nodes, and between type 2.1 nodes 
  537.   using peer-to-peer protocols. 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 4. Communications Manager, Asynchronous Communications, and ACDI ΓòÉΓòÉΓòÉ
  541.  
  542. Communications Manager provides the user with comprehensive communications 
  543. ability in a single system. 
  544.  
  545. ACDI functions do the following: 
  546.  
  547. o Provide device independence and support a variety of asynchronous 
  548.   communications devices and connection types such as: 
  549.  
  550.    - Switched and non-switched lines 
  551.    - Modems (auto-dial, auto-answer, manual dial, manual answer) 
  552.    - Direct connections 
  553.  
  554. o Support asynchronous communications device command sets: 
  555.  
  556.    - ATtention command set (an IBM-supplied and user-edited device command set 
  557.      that supports Hayes** Smartmodem** and compatibles) 
  558.  
  559.    - CCITT V.25bis command set (an IBM-supplied and user-edited device command 
  560.      set that supports V.25bis) 
  561.  
  562.    - No command set (a user-supplied device command set that supports circuits 
  563.      that adhere to CCITT V.24) 
  564.  
  565. o Support traditional asynchronous communication protocols such as: 
  566.  
  567.    - Flow control 
  568.    - Break processing 
  569.  
  570. o Support two dissimilar external devices attached through an A/B switch 
  571.  
  572. o Provide ports for resource management: 
  573.  
  574.    - Three asynchronous ports for computers with Micro Channel* buses (COM1, 
  575.      COM2, COM3) 
  576.  
  577.    - Two asynchronous ports for computers with AT type buses (COM1, COM2) 
  578.  
  579. o Provide Communications and System Management (C & SM) support 
  580.  
  581. o Provide flexible input and output interfaces for data transfers 
  582.  
  583. o Manage application buffers for transmitted and received data 
  584.  
  585. o Provide asynchronous port sharing where auto-answer and auto-dial are 
  586.   allocated to the same port 
  587.  
  588. o Assist country requirements for connecting computers to telephone networks 
  589.  
  590. Communications Manager enables users to access a range of computers, including 
  591. IBM and non-IBM host computer systems. In addition, several connections can be 
  592. active concurrently, giving users rapid access to information from any point in 
  593. a network. Communications Manager also provides a programming interface for 
  594. asynchronous communications. 
  595.  
  596. The Asynchronous Communications Device Interface (ACDI) can be redirected to an 
  597. IBM* Local Area Network Asynchronous Connection Server (LANACS) Version 2.0. 
  598. LANACS is an IBM DOS product that provides asynchronous connection server 
  599. capability to a LAN. The server that runs the LANACS program provides 
  600. asynchronous resources-serial ports, asynchronous connection equipment, and 
  601. telephone lines-that can be shared by workstations on a LAN. An Operating 
  602. System/2* (OS/2*) workstation on the LAN can use serial ports on the 
  603. asynchronous connection server as if the serial ports were located at the 
  604. workstation. For more information on redirecting the serial ports, refer to 
  605. User's Guide. 
  606.  
  607. ACDI is the programming interface that provides support for those who want to 
  608. use the serial ports for asynchronous communications in a multitasking 
  609. environment. ACDI interacts with the serial ports through the base operating 
  610. system and ensures that interrupts are handled and data is buffered for 
  611. applications as required. 
  612.  
  613. ACDI contains verbs that enable the programmer to set asynchronous 
  614. communications parameters, such as character length, bit rate, and flow control 
  615. mode, in addition to verbs for sending and receiving data through the serial 
  616. port. 
  617.  
  618. ACDI is a high-level, hardware-independent interface. Application developers 
  619. using ACDI need not worry about the hardware installed and applications need 
  620. not change when a user changes hardware. This flexibility allows a programmer 
  621. to develop and use an asynchronous communications protocol without having 
  622. detailed knowledge of the asynchronous communications hardware or device 
  623. drivers. For example, the application developer issues a ComConnect verb to 
  624. ACDI to establish an asynchronous communications connection. ACDI directs the 
  625. attached modem appropriately (based upon how the user has configured 
  626. Communications Manager) to establish the connection. 
  627.  
  628. ACDI can be accessed from multiple applications concurrently. An individual 
  629. application can perform asynchronous communications over a maximum of three 
  630. serial ports on a Personal System/2* (PS/2*) workstation concurrently through 
  631. ACDI. 
  632.  
  633.  
  634. ΓòÉΓòÉΓòÉ 4.1. Communications and System Management Support ΓòÉΓòÉΓòÉ
  635.  
  636. Communications Manager supports Communications and System Management (C & SM) 
  637. by sending alerts to the host system over a Systems Network Architecture (SNA) 
  638. connection when link-related failures are detected for Synchronous Data Link 
  639. Control (SDLC) and asynchronous communications connections. If an IBM 
  640. System/370* (S/370) host connection is not available, alerts and link 
  641. statistics are logged locally. 
  642.  
  643. The alert and link statistics network management vector transport (NMVT) are 
  644. also logged to the OS/2 system error log. The alert NMVT contains information 
  645. about the type of errors detected, probable causes of failure, and recommended 
  646. corrective actions when information is available. The information is made 
  647. available at the central location for network problem determination and 
  648. analysis. The link statistics NMVT contains statistics for an asynchronous 
  649. communications session. 
  650.  
  651. For detailed information on alerts, refer to Problem Determination Guide. 
  652.  
  653.  
  654. ΓòÉΓòÉΓòÉ 4.2. Using ACDI and ACDI Redirection Features ΓòÉΓòÉΓòÉ
  655.  
  656. Before running your program, you must install the ACDI feature and the ACDI 
  657. Redirection feature and start Communications Manager. For configuration 
  658. information, refer to Configuration Guide. For information on starting and 
  659. stopping ACDI, refer to User's Guide. 
  660.  
  661. The ACDI Redirection feature allows you to redirect ACDI using an application 
  662. program. Using ACDI Redirection, you can set and query ACDI by interfaces other 
  663. than a command line. For example, an ACDI application program can determine if 
  664. a port is currently redirected. 
  665.  
  666.  
  667. ΓòÉΓòÉΓòÉ 5. ACDI Functions, Structure, and Verb Overview ΓòÉΓòÉΓòÉ
  668.  
  669.  
  670. ACDI defines the interface for asynchronous communications in the 
  671. Communications Manager program and provides a logical interface that is 
  672. hardware-independent. It also provides a higher level function than traditional 
  673. asynchronous communications device support. 
  674.  
  675. ACDI Architectural Layers provides a general view of how ACDI architectural 
  676. layers are structured: 
  677.  
  678. ACDI Architectural Layers
  679.  
  680. Applications call the ACDI dynamic link library (DLL), which issues calls to 
  681. the ACDI device driver. ACDI programs the asynchronous adapter and the attached 
  682. supported modem. 
  683.  
  684. The device drivers, shipped with Communications Manager, drive the asynchronous 
  685. communications adapter. 
  686.  
  687. ACDI supports a wide variety of asynchronous adapters and provides support for 
  688. data circuit-terminating equipment (DCE). Refer to Network Administration and 
  689. Subsystem Management Guide for the supported adapters. 
  690.  
  691.  
  692. ΓòÉΓòÉΓòÉ 5.1. Establishing Asynchronous Communications Connections ΓòÉΓòÉΓòÉ
  693.  
  694. An application written for ACDI can establish asynchronous communications 
  695. connections in several ways. Once the connection is made, little difference 
  696. exists between connection types. 
  697.  
  698.  
  699. ΓòÉΓòÉΓòÉ 5.1.1. Connection Types ΓòÉΓòÉΓòÉ
  700.  
  701. The connection types are: 
  702.  
  703. o Auto-dial, auto-answer. 
  704.  
  705.   The application can instruct ACDI to dial a number and establish a connection 
  706.   or instruct ACDI to set up for answering an incoming call. 
  707.  
  708. o Manual dial, manual answer. 
  709.  
  710.   The application can set up a user-established voice connection, instruct ACDI 
  711.   to switch a modem from voice to data mode, and assert either the originate or 
  712.   answer frequencies. 
  713.  
  714. o No command set support-user-established. 
  715.  
  716.   ACDI monitors circuits according to CCITT V.24 recommendations but does not 
  717.   issue commands to any attached data circuit-terminating equipment (DCE). The 
  718.   user establishes the data connection. 
  719.  
  720. The auto-dial, auto-answer, manual dial, and manual answer connection types are 
  721. available for ports configured for the following modems: 
  722.  
  723. o Hayes Smartmodem 1200, 2400 
  724. o Hayes V-Series Modem Enhancer 1200, 2400 
  725. o IBM PC Series 1200, 2400 
  726. o MicroCom** AX/2400C, AX/9624C 
  727. o Racal-Vadic** VI2422PA, VI2422S 
  728.  
  729.   Note:  The device initialization string for the VI2422S model is the default 
  730.          value of ^C|. When using the VI2422PA model, the device initialization 
  731.          string must be modified to a value of ATV.25 by means of ACDI 
  732.          configuration. 
  733.  
  734.  
  735. o IBM 7855 V.42 
  736. o IBM Asynchronous/SDLC V.32 Modem/A 
  737.  
  738. Only the auto-dial and auto-answer connection types are available when the port 
  739. is configured for ROLMphone** 244PC. 
  740.  
  741. The connection type that has no command set support works for ports configured 
  742. for Other modem or devices. For more information on configuration, refer to 
  743. Configuration Guide. 
  744.  
  745.  
  746. ΓòÉΓòÉΓòÉ 5.1.2. Device String Profile ΓòÉΓòÉΓòÉ
  747.  
  748. A device string profile is used to specify to ACDI what type of modem is 
  749. attached to a specific COM port. The profile defines the modem commands and 
  750. modem responses used by ACDI to manage the modem. The default modem commands 
  751. shipped with ACDI support Hayes ATtention command set and V.25bis command set. 
  752. If your modem uses other commands, you may need to change the defaults in the 
  753. device string profile. For detailed descriptions on specific device strings 
  754. used with asynchronous connections, see ComOpen (X'02'). 
  755.  
  756.  
  757. ΓòÉΓòÉΓòÉ 5.1.3. Asynchronous Port Sharing ΓòÉΓòÉΓòÉ
  758.  
  759. ACDI allows two processes to share the same communication port if the port is 
  760. not configured as Other modem or devices. For a further description, refer to 
  761. Configuration Guide. 
  762.  
  763. Both processes can set: 
  764.  
  765. o Input and output buffers for the port 
  766. o Rates and communications parameters for the port 
  767. o Flow control parameters 
  768. o Event notification parameters 
  769. o Time-out values 
  770. o Error substitution characters 
  771.  
  772. ACDI tracks the information for both processes. Each process can use the port 
  773. serially for establishing a connection. When a process issues a successful 
  774. ComConnect verb, it owns the communication port, and ACDI enables its 
  775. communications parameters. 
  776.  
  777. If the second process issues a ComConnect verb while the first process has a 
  778. connection established, it receives a return code indicating that the port is 
  779. in use. 
  780.  
  781. When the first process ends its connection, both processes can attempt to 
  782. establish a new connection. The first one to issue a ComConnect verb owns the 
  783. port until the connection ends. 
  784.  
  785. All communications devices, except for those classified as V.24-compatible 
  786. devices that do not have a command set or whose telephony command sets are not 
  787. known by ACDI, can be shared. Ports configured as Other modem or devices cannot 
  788. be shared. 
  789.  
  790. ACDI saves the current port parameters for each process and activates those 
  791. parameters before a ComConnect verb completes for that process. 
  792.  
  793. The following values are saved by ACDI for each port: 
  794.  
  795. o Send and receive speeds (bits per second) 
  796. o Number of stop bits 
  797. o Parity selection 
  798. o Number of data bits 
  799. o Flow control characters 
  800. o Flow control mode 
  801. o Flow control threshold levels 
  802. o Event mask and semaphore handle 
  803. o Application input and output buffers, associated I/O pointers and counters 
  804. o Time-out values 
  805. o Error substitution character and mode 
  806. o Input mode (fixed-length block, variable-length block, or character) and the 
  807.   associated parameters 
  808.  
  809. ACDI provides additional port-sharing capability for a port that is used by an 
  810. application for auto-answer. If a process issues a ComConnect verb to ACDI for 
  811. auto-answer with infinite time-out, ACDI lets another process that issues a 
  812. ComConnect verb for auto-dial borrow the communication port. 
  813.  
  814. ACDI lets the auto-dial process make its outgoing call and when the auto-dial 
  815. process connection ends, ACDI reinstates the first process for auto-answer. The 
  816. auto-answer process never knows that another process borrowed the port to place 
  817. an outgoing call. ACDI holds the auto-answer process's ComConnect thread while 
  818. the auto-dial process borrows the port. 
  819.  
  820. To allow port sharing, the process requesting the auto-answer connection must 
  821. specify infinite time-out (X'0000') in the ConnectTimeout1 parameter of the 
  822. ComConnect verb. 
  823.  
  824.  
  825. ΓòÉΓòÉΓòÉ 5.2. Bit Rate and Line Control Parameters ΓòÉΓòÉΓòÉ
  826.  
  827. ACDI provides verbs for programming bit rate and line control parameters at the 
  828. data terminal equipment (DTE) or the data circuit-terminating equipment (DCE) 
  829. interface on the asynchronous communications hardware. 
  830.  
  831. These verbs program the universal asynchronous receiver/transmitter (UART) on 
  832. the asynchronous communications hardware adapter or internal modem for the 
  833. following parameters: 
  834.  
  835. o Bit rate 
  836. o Parity 
  837. o Number of data bits 
  838. o Number of stop bits 
  839.  
  840. Changing the bit rate and line control parameters after a connection is 
  841. established can cause the following situations to occur: 
  842.  
  843. o The data the application receives is unintelligible. 
  844.  
  845. o The data the application transmits is unintelligible to the remote receiver. 
  846.  
  847. o The application is not able to disconnect the communications session 
  848.   successfully without closing the communications port. 
  849.  
  850. After the bit rate is set with the ComSetBitRate verb and an application issues 
  851. the verb to establish a connection, the local modem and the remote system can 
  852. renegotiate the line speed and set it to a different value than that set by the 
  853. application. The application can request the interface speed between the UART 
  854. and modem by issuing the ComRetBitRate verb. 
  855.  
  856. Note:  Some networks require a 7-bit configuration to establish connections but 
  857.        may require a change to 8-bit for a file transfer protocol like XMODEM. 
  858.  
  859. Some modems and UARTs do not support all of the bit rates and line control 
  860. parameters selectable with ACDI. The application must instruct ACDI to program 
  861. the UART for values that the modem and UART support. Unsupported values may 
  862. cause communications problems. 
  863.  
  864.  
  865. ΓòÉΓòÉΓòÉ 5.3. Resource Management and Input/Output Processing ΓòÉΓòÉΓòÉ
  866.  
  867. The ACDI interface for sending and receiving application data centers around 
  868. circular application buffers that the application defines with the 
  869. ComDefOutputBuff and ComDefInputverbs. The application uses these verbs to 
  870. describe the location and length of its buffers to ACDI, and to describe the 
  871. input mode. 
  872.  
  873.  
  874. ΓòÉΓòÉΓòÉ 5.3.1. Overview of Character and Block Input/Output Processing ΓòÉΓòÉΓòÉ
  875.  
  876. After defining these buffers to ACDI and establishing a connection with the 
  877. ComConnectverb, the application can receive and send data in the following 
  878. ways: 
  879.  
  880. o When data is received, ACDI places it directly into the input buffer defined 
  881.   by the application. The application can retrieve the data that is queued in 
  882.   the buffer by ACDI by using the ComReadCharString or ComReadBlock verb. It 
  883.   can inform ACDI how much of the previously returned data it has removed from 
  884.   the buffer queue. 
  885.  
  886. o When the application wants to transmit data, it requests buffer space from 
  887.   ACDI with the ComWriteCharString verb. ACDI returns the location and amount 
  888.   of free space in the output buffer. The application places its data into the 
  889.   output buffer. Next, the application tells ACDI the amount of data it has 
  890.   queued in the output buffer and makes a request for more free space by 
  891.   issuing the ComWriteCharString verb. 
  892.  
  893. ACDI manages the application input and output buffers as circular buffers or 
  894. ring buffers. For example, when data is received, ACDI queues it starting at 
  895. the beginning of the application input buffer. When ACDI reaches the end of the 
  896. application input buffer, it starts queuing data at the beginning of the 
  897. application input buffer, provided that space at the beginning of the buffer 
  898. has been freed by the application. 
  899.  
  900. When ACDI reaches the end of the application output buffer, it starts obtaining 
  901. new data to transmit from the beginning of the application output buffer, 
  902. provided that new data has been written to the buffer. 
  903.  
  904. ACDI also tracks pointers into the buffer for the application. When an 
  905. application issues a ComWriteCharString verb, ACDI returns a pointer to the 
  906. free space remaining in the buffer and returns the length of the free space, so 
  907. that the application can continue to fill the output buffer with data to 
  908. transmit. Similarly, when an application issues a ComReadCharString or 
  909. ComReadBlock verb, ACDI returns a pointer to the data queued in the buffer and 
  910. returns the length of the data. 
  911.  
  912. Application Output Buffer Structure shows the data structure of an application 
  913. output buffer: 
  914.  
  915. Application Output Buffer Structure
  916.  
  917. The x's represent new data copied into the buffer by the application for ACDI 
  918. to transmit. The o's represent data that the application told ACDI to transmit 
  919. on previous ComWriteCharString verb requests. ACDI returns a pointer to the 
  920. free space. The current amount of free space returned to the application is the 
  921. sum of the two blocks of free space minus 1 byte. (ACDI always reserves 1 byte 
  922. of data at the logical end of the free space.) 
  923.  
  924. Note:  The application must consider the buffer wrap when it receives the 
  925.        pointer and the amount of free space available from ACDI. 
  926.  
  927.  
  928. ΓòÉΓòÉΓòÉ 5.3.2. Input Processing Modes ΓòÉΓòÉΓòÉ
  929.  
  930. ACDI provides the following three modes for processing received data: 
  931.  
  932. o Character mode 
  933.  
  934.   Input Buffer in Character Mode shows an input buffer in character mode: 
  935.  
  936.     Input Buffer in Character Mode
  937.  
  938.   When the application issues the ComReadCharString verb, it receives input 
  939.   data from ACDI and instructs ACDI that it has freed space in the input buffer 
  940.   (the application has finished processing some of the data that was returned 
  941.   on previous ComReadCharString verb requests). When needed, this free space is 
  942.   used by ACDI to queue incoming data. When ACDI returns the ComReadCharString 
  943.   verb request to the application, it returns a pointer to all of the data in 
  944.   the buffer. This data includes any new data that the application does not 
  945.   know about and any old data that the application has not yet freed. 
  946.  
  947.   In the diagram in Input Buffer in Character Mode, the o's represent old data 
  948.   that the application has not freed and that ACDI returned to the application 
  949.   on previous ComReadCharString verb requests. The x's represent new data that 
  950.   has been queued in the buffer since the last ComReadCharString verb request 
  951.   was issued. 
  952.  
  953. o Fixed-length block mode 
  954.  
  955.   The diagram in Input Buffer in Fixed-Length Block Mode depicts the input 
  956.   buffer in fixed-length block mode: 
  957.  
  958.     Input Buffer in Fixed-Length Block Mode
  959.  
  960.   The application specifies this mode and a block length that ACDI uses to 
  961.   group incoming data into blocks on the ComDefInput verb. 
  962.  
  963.   The application issues the ComReadBlock verb to receive data in this mode. On 
  964.   the ComReadBlock verb, ACDI returns a pointer to the next block of data in 
  965.   the buffer and returns the block length. If a complete block is not received, 
  966.   ACDI still returns the block length. See ComReadBlock (X'19') for additional 
  967.   information. 
  968.  
  969. o Variable-length block mode 
  970.  
  971.   The diagram in Input Buffer in Variable-Length Block Mode depicts the input 
  972.   buffer in variable-length block mode: 
  973.  
  974.     Input Buffer in Variable-Length Block Mode
  975.  
  976.   The application specifies up to five end-of-block (EOB) strings that ACDI 
  977.   should look for to divide incoming data into blocks. For example, an 
  978.   application can specify a carriage return and a line-feed pair as the EOB 
  979.   delimiter. 
  980.  
  981.   In this input mode, the application issues the ComReadBlock verb to get input 
  982.   data, and ACDI returns a pointer to the data and the block length. Because 
  983.   ACDI does not strip the actual EOB string from the data, the block length 
  984.   includes the EOB string data. 
  985.  
  986.  
  987. ΓòÉΓòÉΓòÉ 5.4. Flow Control ΓòÉΓòÉΓòÉ
  988.  
  989. ACDI provides verbs that allow you to manage the flow of data between your 
  990. application and the remote receiver or sender. 
  991.  
  992. In asynchronous communications, when one station cannot process incoming data, 
  993. it can signal the remote station to stop sending data by sending the remote 
  994. station an XOFF character. When the local station is able to receive data, it 
  995. sends an XON character to signal the remote station to start sending data. 
  996.  
  997. An application can manage data flow on its own with functions provided by ACDI, 
  998. or it can program ACDI to manage flow control automatically. 
  999.  
  1000.  
  1001. ΓòÉΓòÉΓòÉ 5.4.1. Application Flow Control ΓòÉΓòÉΓòÉ
  1002.  
  1003. An application can use ComStartTrans and ComStopTrans verbs to instruct ACDI to 
  1004. start or stop transmitting data in the application output buffer when the 
  1005. application recognizes that the remote receiver has sent an XON or XOFF 
  1006. character. When an application realizes that it cannot process more incoming 
  1007. data, it can use the ComTransImm verb to send an XOFF character to the remote 
  1008. sender. When it is able to resume processing data, it can use the ComTransImm 
  1009. verb to send an XON character to the remote sender. 
  1010.  
  1011.  
  1012. ΓòÉΓòÉΓòÉ 5.4.2. Automatic Flow Control ΓòÉΓòÉΓòÉ
  1013.  
  1014. With the ComSetFlowMode verb, an application enables automatic flow control. 
  1015. ACDI detects XON and XOFF characters sent by the remote sender and 
  1016. automatically starts or stops sending data in the application output buffer. In 
  1017. this mode, ACDI removes the XON and XOFF characters from the incoming data 
  1018. stream. The characters are not placed in the application input buffer. 
  1019.  
  1020. When free space in the application input buffer declines to a certain 
  1021. threshold, ACDI sends the remote sender an XOFF character. When enough free 
  1022. space becomes available in the application input buffer, ACDI sends the remote 
  1023. sender an XON character. 
  1024.  
  1025. The ComSetFlowChar verb allows an application to define the XON and XOFF 
  1026. characters that ACDI detects in the incoming data stream and sends to the 
  1027. remote sender. 
  1028.  
  1029. The ComSetFlowThresh verb allows the application to set the levels of free 
  1030. space in the input buffer for which ACDI should send either an XON or XOFF 
  1031. character to the remote sender. 
  1032.  
  1033.  
  1034. ΓòÉΓòÉΓòÉ 5.5. Event Processing ΓòÉΓòÉΓòÉ
  1035.  
  1036. ACDI uses an application-defined semaphore to notify the application that an 
  1037. asynchronous communications event has occurred. This semaphore can be either a 
  1038. RAM semaphore or a system semaphore. 
  1039.  
  1040. The application sets up a mask of the events for which it wants notification. 
  1041. When an enabled event occurs and the application notifies you when the event 
  1042. occurred, ACDI copies the event information into the application's event data 
  1043. area and clears the application's semaphore to signal that the event has 
  1044. occurred. See ComReadEvent (X'13') for more information on ACDI event 
  1045. processing. 
  1046.  
  1047.  
  1048. ΓòÉΓòÉΓòÉ 5.6. Country or Network Requirements ΓòÉΓòÉΓòÉ
  1049.  
  1050. ACDI also enforces each country's requirements for auto-dialing and 
  1051. auto-answering based on a telephone network ID that the user specifies during 
  1052. configuration. For example, many countries have requirements for how often a 
  1053. computer can call a number within a certain amount of time. Some countries also 
  1054. have requirements for how long a computer should wait before answering a call. 
  1055.  
  1056. These requirements are enforced when the application issues a ComConnect verb. 
  1057. Connection attempts violating a country's telecommunications requirements are 
  1058. returned with an error code. 
  1059.  
  1060. Refer to Configuration Guide for additional information. 
  1061.  
  1062.  
  1063. ΓòÉΓòÉΓòÉ 5.7. Ending Asynchronous Communications ΓòÉΓòÉΓòÉ
  1064.  
  1065. Asynchronous communications links established using ACDI can be disconnected or 
  1066. ended in any of the following ways: 
  1067.  
  1068. o The application issues a ComDisconnect verb. 
  1069. o The remote end disconnects the session. 
  1070. o A user requests an abnormal stop to the ACDI feature by selecting Stop 
  1071.   Communications Abnormally from the Communications group. 
  1072.  
  1073. When an asynchronous connection is ended, ACDI logs a communications and system 
  1074. management (C & SM) vector containing link statistics, such as the average data 
  1075. transmission and data reception rates, in the OS/2 system error log. If 
  1076. Communications Manager is stopped, your program must be ended before you can 
  1077. restart Communications Manager and ACDI. 
  1078.  
  1079. For additional information on the OS/2 system error log, refer to Problem 
  1080. Determination Guide. 
  1081.  
  1082.  
  1083. ΓòÉΓòÉΓòÉ 5.8. Verb Overview ΓòÉΓòÉΓòÉ
  1084.  
  1085. The functions and verbs that are supplied by ACDI are listed as follows and are 
  1086. grouped into functional categories. It is suggested that applications use 
  1087. specific threads for specific verbs. An E (event/status), O (output), or I 
  1088. (input) is listed next to the verb, indicating which thread is better suited 
  1089. for those verbs. The absence of E, O, or I means any thread can be used. 
  1090.  
  1091.  
  1092. ΓòÉΓòÉΓòÉ 5.8.1. Resource Management ΓòÉΓòÉΓòÉ
  1093.  
  1094. ComClose 
  1095.           Closes the specified communications device. 
  1096.  
  1097. ComDefInput (I) 
  1098.           Defines the application input buffer and input mode. 
  1099.  
  1100. ComDefOutputBuff (O) 
  1101.           Defines the application output buffer. 
  1102.  
  1103. ComOpen 
  1104.           Opens a communications device for an application. 
  1105.  
  1106.  
  1107. ΓòÉΓòÉΓòÉ 5.8.2. Line Characteristics ΓòÉΓòÉΓòÉ
  1108.  
  1109. ComRetBitRate 
  1110.           Returns the bit rate for which the asynchronous receiver/transmitter 
  1111.           hardware is programmed. 
  1112.  
  1113. ComRetLineCtrl 
  1114.           Returns the current line control values for which the asynchronous 
  1115.           receiver/transmitter hardware is programmed. 
  1116.  
  1117. ComSetBitRate 
  1118.           Sets the bit rate of the asynchronous receiver/transmitter hardware. 
  1119.  
  1120. ComSetLineCtrl 
  1121.           Sets the line control values for the asynchronous 
  1122.           receiver/transmitter hardware. 
  1123.  
  1124.  
  1125. ΓòÉΓòÉΓòÉ 5.8.3. Application Flow Control ΓòÉΓòÉΓòÉ
  1126.  
  1127. ComStartTrans 
  1128.           Instructs ACDI to start transmitting data in the application buffer. 
  1129.  
  1130. ComStopTrans 
  1131.           Instructs ACDI to stop transmitting data in the application buffer. 
  1132.  
  1133. ComTransImm 
  1134.           Sends a character immediately. 
  1135.  
  1136.  
  1137. ΓòÉΓòÉΓòÉ 5.8.4. Automatic Flow Control ΓòÉΓòÉΓòÉ
  1138.  
  1139. ComRetFlowChar 
  1140.           Returns flow control (XOFF and XON) characters. 
  1141.  
  1142. ComRetFlowMode 
  1143.           Returns flow control (XOFF and XON) mode, specifying whether 
  1144.           automatic flow control is enabled. 
  1145.  
  1146. ComRetFlowThresh 
  1147.           Returns flow control threshold levels for the application input 
  1148.           buffer. 
  1149.  
  1150. ComSetFlowChar 
  1151.           Sets flow control (XOFF and XON) characters. 
  1152.  
  1153. ComSetFlowMode 
  1154.           Sets flow control (XON and XOFF) mode. 
  1155.  
  1156. ComSetFlowThresh 
  1157.           Sets the flow control threshold levels for the application input 
  1158.           buffer. 
  1159.  
  1160.  
  1161. ΓòÉΓòÉΓòÉ 5.8.5. Break Processing ΓòÉΓòÉΓòÉ
  1162.  
  1163. ComSendBreak (O) 
  1164.           Sends a break signal for the user-specified duration. 
  1165.  
  1166.  
  1167. ΓòÉΓòÉΓòÉ 5.8.6. Event Processing ΓòÉΓòÉΓòÉ
  1168.  
  1169. ComGetLineInfo 
  1170.           Returns information about the RS232-C circuits. 
  1171.  
  1172. ComReadEvent (E) 
  1173.           Enables the communications event queue. 
  1174.  
  1175.  
  1176. ΓòÉΓòÉΓòÉ 5.8.7. Character and Block I/O Processing ΓòÉΓòÉΓòÉ
  1177.  
  1178. ComDrainOutput (O) 
  1179.           Blocks thread until the application output buffer is empty. 
  1180.  
  1181. ComFlushInput 
  1182.           Clears the application input buffer. 
  1183.  
  1184. ComFlushOutput 
  1185.           Clears the application output buffer. 
  1186.  
  1187. ComReadBlock (I) 
  1188.           Reads a block of data from the application input buffer and frees the 
  1189.           block returned on the previous ComReadBlock. 
  1190.  
  1191. ComReadCharString (I) 
  1192.           Reads a character string from the application input buffer. 
  1193.  
  1194. ComRetErrorCharSub (I) 
  1195.           Returns the current error substitution character and mode. 
  1196.  
  1197. ComRetTimeout 
  1198.           Returns time-out values for the ComReadCharString, ComReadBlock, and 
  1199.           ComWriteCharString verbs. 
  1200.  
  1201. ComSetErrorCharSub (I) 
  1202.           Sets the current error substitution character and mode. 
  1203.  
  1204. ComSetTimeout 
  1205.           Sets time-out values for the ComReadCharString, ComReadBlock, and 
  1206.           ComWriteCharString verbs. 
  1207.  
  1208. ComUnblockThreads 
  1209.           Unblocks the specified thread if it is currently blocked. 
  1210.  
  1211. ComWriteCharString (O) 
  1212.           Writes new data in the application output buffer and gets updated 
  1213.           free space in the buffer. 
  1214.  
  1215.  
  1216. ΓòÉΓòÉΓòÉ 5.8.8. Connection Control ΓòÉΓòÉΓòÉ
  1217.  
  1218. ComConnect 
  1219.           Establishes an asynchronous communications connection. 
  1220.  
  1221. ComDisconnect 
  1222.           Disconnects the asynchronous communications connection. 
  1223.  
  1224.  
  1225. ΓòÉΓòÉΓòÉ 5.9. Communications Manager Common Services API Service Verbs ΓòÉΓòÉΓòÉ
  1226.  
  1227. Communications Manager also supplies service verbs that can be used by all 
  1228. application programs that use a Communications Manager API. The Common Services 
  1229. API (service verbs) provides the following functions: 
  1230.  
  1231. o Converts ASCII data to EBCDIC data 
  1232. o Converts EBCDIC data to ASCII data 
  1233. o Builds code-page conversion tables 
  1234. o Traces API interfaces and data 
  1235. o Queues the OS/2 system error log on a user-supplied queue 
  1236. o Logs messages in the OS/2 system error log 
  1237. o Transfers diagnostic information to a host computer 
  1238.  
  1239. The service verbs provided by Communications Manager serve all of the 
  1240. application programs that use a Communications Manager API. For complete 
  1241. information on these verbs, refer to Application Programming Guide. 
  1242.  
  1243. A description of each verb in the Common Services API follows: 
  1244.  
  1245. CONNECT_PHYSICAL_LINK 
  1246.           Enables an X.25 physical link. 
  1247.  
  1248. CONVERT 
  1249.           Converts ASCII character strings to EBCDIC and EBCDIC character 
  1250.           strings to ASCII. 
  1251.  
  1252. COPY_TRACE_TO_FILE 
  1253.           Formats the data in the trace storage buffer and copies it to a 
  1254.           specified file. 
  1255.  
  1256. DEFINE_DUMP 
  1257.           Selects the components for which dumping is to be performed and 
  1258.           specifies the file to which the data is to be written. 
  1259.  
  1260. DEFINE_TRACE 
  1261.           Specifies those API verbs and data on which an internal trace can be 
  1262.           run, and turns a trace on or off, as specified. 
  1263.  
  1264. DISCONNECT_PHYSICAL_LINK 
  1265.           Disables an X.25 physical link. 
  1266.  
  1267. DISPLAY 
  1268.           Returns configuration information and current operating values for 
  1269.           the active SNA node. 
  1270.  
  1271. DISPLAY_APPN 
  1272.           Returns information about Advanced Peer-to-Peer Networking* (APPN*) 
  1273.           resources. 
  1274.  
  1275. GET_CP_CONVERT_TABLE 
  1276.           Provides a utility service for building a conversion table from one 
  1277.           code page supported by Communications Manager to another code page. 
  1278.  
  1279. LOG_MESSAGE 
  1280.           Instructs Communications Manager to record a previously created 
  1281.           message in the message log. 
  1282.  
  1283. SET_USER_LOG_QUEUE 
  1284.           Defines a user-supplied queue. The user creates the queue before this 
  1285.           verb is issued and sends messages, error logs, or both to the queue. 
  1286.  
  1287. TRANSFER_MS_DATA 
  1288.           Builds and sends an unsolicited network management vector transport 
  1289.           (NMVT) request/response unit (RU) to the System Services Control 
  1290.           Point (SSCP). 
  1291.  
  1292.  
  1293. ΓòÉΓòÉΓòÉ 6. Writing, Building, and Debugging Your Application Using ACDI ΓòÉΓòÉΓòÉ
  1294.  
  1295. This chapter outlines the main topics for writing, building, and debugging your 
  1296. applications for ACDI. 
  1297.  
  1298.  
  1299. ΓòÉΓòÉΓòÉ 6.1. Writing Your Application ΓòÉΓòÉΓòÉ
  1300.  
  1301. Applications written in either C or Macro Assembler language can use the 
  1302. following include files provided by Communications Manager for writing an 
  1303. application to ACDI: 
  1304.  
  1305. o ACDI_C.H for C 
  1306. o ACDI_A.INC for Macro Assembler 
  1307.  
  1308. These language bindings contain constant definitions for ACDI return codes, 
  1309. verb function codes, parameter values, and structure mappings for the verb 
  1310. control blocks. 
  1311.  
  1312.  
  1313. ΓòÉΓòÉΓòÉ 6.1.1. Using Versions of ACDI ΓòÉΓòÉΓòÉ
  1314.  
  1315. The Version parameter identifies the ACDI version for which your application is 
  1316. written. The valid values for the Version parameter are X'00', X'01', X'02', 
  1317. X'03', and X'04'. 
  1318.  
  1319. If you have an application that was written for a previous ACDI version and you 
  1320. want to update the application to use any new verb functions in this version of 
  1321. ACDI, you need to change the Version parameter for the verb that has been 
  1322. enhanced and add any new parameters required by the new version of the verb. 
  1323. See the individual verb descriptions to determine the supported ACDI versions 
  1324. and parameters for each verb. 
  1325.  
  1326. If you are writing a new application, you can set the version in all of the 
  1327. verb control blocks that you use to call ACDI to the latest version. When you 
  1328. are designing a new application that you expect to run only on a specific 
  1329. version, you do not need to concern yourself with using other version values. 
  1330.  
  1331. As new functions are added to ACDI and as the ACDI interface is expanded, your 
  1332. application will be able to use ACDI in different ways. 
  1333.  
  1334.  
  1335. ΓòÉΓòÉΓòÉ 6.1.2. Calling ACDI ΓòÉΓòÉΓòÉ
  1336.  
  1337. The high-level language syntax for calling ACDI is: 
  1338.  
  1339. call ACDI (addr(verb control block))
  1340.  
  1341. where the address of the verb control block is a far address and the call to 
  1342. ACDI is a far call. 
  1343.  
  1344. For the C language, a sample call to ACDI is: 
  1345.  
  1346. extern void pascal far ACDI (unsigned far *);
  1347. ACDI (vcbptr);
  1348.  
  1349. For Macro Assembler, a sample call to ACDI is: 
  1350.  
  1351. EXTRN ACDI:FAR
  1352.  
  1353. PUSH SEG VCB
  1354. PUSH OFFSET VCB
  1355. CALL FAR PTR ACDI
  1356.  
  1357. An application must build the verb control block that it passes to ACDI in a 
  1358. read/write data segment. Threads of execution that call ACDI concurrently must 
  1359. call ACDI with separate control blocks, and an application should not change 
  1360. the content of a control block while ACDI is processing the verb associated 
  1361. with the control block. 
  1362.  
  1363. Note:  If the pointer to the verb control block is not valid, X'02' is returned 
  1364.        in the AX register. For more information, see ACDI Return Codes. 
  1365.  
  1366. ACDI and OS/2 require up to 2650 bytes of stack space for processing. Each 
  1367. application thread that calls an ACDI function needs to allocate an additional 
  1368. 2650 bytes of stack space. 
  1369.  
  1370.  
  1371. ΓòÉΓòÉΓòÉ 6.1.3. Thread Usage ΓòÉΓòÉΓòÉ
  1372.  
  1373. Multiple applications can call the ACDI DLL and each application can call ACDI 
  1374. from multiple threads. An application can also establish communications 
  1375. connections over multiple communication ports through ACDI. 
  1376.  
  1377. An application using ACDI typically creates three threads of execution for 
  1378. controlling each port. They are: 
  1379.  
  1380. o Event/status processing 
  1381. o Reading (input) 
  1382. o Writing (output) 
  1383.  
  1384. The opening and closing of each communication port can take place in any thread 
  1385. of the process. Once a handle is obtained by an opened port, calls are made 
  1386. from the specific threads. Applications should use specific threads for 
  1387. specific verbs. In the Verb Overview, an E (event/status), O (output), or I 
  1388. (input) is listed next to the verb indicating which thread is better suited for 
  1389. that verb. The absence of E, O, or I means any thread can be used. 
  1390.  
  1391.  
  1392. ΓòÉΓòÉΓòÉ 6.1.4. Segment Attributes ΓòÉΓòÉΓòÉ
  1393.  
  1394. The segment containing the control block must be a read/write data segment. If 
  1395. the verb has an associated data buffer, the segment containing the data buffer 
  1396. must also be a read/write data segment. 
  1397.  
  1398. Because the ACDI DLL routine runs under the caller's thread and performs all 
  1399. its own verb processing, control blocks and data segments may reside in shared 
  1400. memory created by DosAllocSeg or in the program's local data segment. When 
  1401. shared memory is used, multiple segments may be allocated for different data 
  1402. buffers.  However, no data buffer may span multiple segments. Multiple control 
  1403. blocks and data buffers may coexist in the same segment, provided the preceding 
  1404. segment requirements are met. 
  1405.  
  1406.  
  1407. ΓòÉΓòÉΓòÉ 6.1.5. Application Exit List Processing ΓòÉΓòÉΓòÉ
  1408.  
  1409. When an application successfully opens a communication port with the ComOpen 
  1410. verb, ACDI puts itself on the application's exit list. When an application 
  1411. closes all of the communication ports it opened through ACDI, ACDI removes 
  1412. itself from the application's exit list. 
  1413.  
  1414. If the application puts itself on its own OS/2 exit list, the application 
  1415. should not call ACDI from its exit list routine. There is no need for the 
  1416. application to perform ACDI cleanup on its exit list since ACDI does its own 
  1417. cleaning up for the application. Refer to OS/2 Technical Library for a 
  1418. description of the OS/2 exit list. 
  1419.  
  1420.  
  1421. ΓòÉΓòÉΓòÉ 6.2. Building Your Application ΓòÉΓòÉΓòÉ
  1422.  
  1423. For information about compiling your application program, refer to your 
  1424. compiler documentation. 
  1425.  
  1426.  
  1427. ΓòÉΓòÉΓòÉ 6.2.1. Dynamic Link Interface ΓòÉΓòÉΓòÉ
  1428.  
  1429. The base operating system provides two types of dynamic linking to the DLL: 
  1430.  
  1431. o Load-time linking 
  1432. o Run-time linking 
  1433.  
  1434. To link to ACDI at load time, you must either include an IMPORTS statement in 
  1435. the .DEF file that you use to link your program, or you must link with the 
  1436. ACS.LIB library at link time.  ACS.LIB is in \CMLIB. 
  1437.  
  1438. The IMPORTS statement is: 
  1439.  
  1440. IMPORTS ACDI.ACDI
  1441.  
  1442. The ACS.LIB library contains entry-point linkage information for all of the 
  1443. Communications Manager API entry points. 
  1444.  
  1445. Run-time linking provides the ability to link conditionally to a DLL. With 
  1446. run-time linking, your application issues the OS/2 DosLoadModule and 
  1447. DosGetProcAddr function calls to obtain linkage to the ACDI entry point. The 
  1448. name of the ACDI dynamic link library is ACDI.DLL, and the name of the entry is 
  1449. ACDI. ACDI.DLL is in \CMLIB\DLL. 
  1450.  
  1451. Although run-time linking is supported by ACDI, the capability to unlink is not 
  1452. supported. Once an application has performed the run-time link to ACDI.DLL, it 
  1453. should not unlink using the OS/2 DosFreeModule function call. 
  1454.  
  1455. Refer to Application Programming Guide and OS/2 Technical Library for 
  1456. additional information on run-time linking. 
  1457.  
  1458.  
  1459. ΓòÉΓòÉΓòÉ 6.2.2. Linking Your Program ΓòÉΓòÉΓòÉ
  1460.  
  1461. Before you can run your program, you must create a program module to run on the 
  1462. base operating system (an .EXE file) by linking your compiled source files with 
  1463. the LINK utility supplied with your compiler. 
  1464.  
  1465. For additional information on the linking process, refer to OS/2 Technical 
  1466. Library. For specific guidelines about linking Communications Manager APIs, see 
  1467. Application Programming Guide. 
  1468.  
  1469.  
  1470. ΓòÉΓòÉΓòÉ 6.3. Debugging Your Application ΓòÉΓòÉΓòÉ
  1471.  
  1472. Communications Manager provides an API trace service for all calls to and 
  1473. returns from each of its application programming interfaces. The ACDI trace 
  1474. service logs the verb control block that your application passes to ACDI as 
  1475. well as the verb control block that ACDI returns to your application on each 
  1476. call to ACDI. 
  1477.  
  1478. Refer to Problem Determination Guide for an example trace and additional 
  1479. information. 
  1480.  
  1481.  
  1482. ΓòÉΓòÉΓòÉ 7. ACDI Verb Descriptions ΓòÉΓòÉΓòÉ
  1483.  
  1484. ACDI provides the verbs listed in this chapter to serve application programs 
  1485. that use ACDI. Return codes are provided with each verb. 
  1486.  
  1487.  
  1488. ΓòÉΓòÉΓòÉ 7.1. ComClose (X'03') ΓòÉΓòÉΓòÉ
  1489.  
  1490. ComClose (X'03') 
  1491.  
  1492.           This verb closes the specified communications device. 
  1493.  
  1494.  Prerequisite Calls 
  1495.  
  1496.           ComOpen 
  1497.  
  1498.           Note:  There can be no outstanding ComReadBlock, ComReadCharString, 
  1499.                  or ComWriteCharString verbs. 
  1500.  
  1501.  Verb Control Block Format 
  1502.  
  1503.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  1504.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  1505.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  1506.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1507.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  1508.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1509.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  1510.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1511.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  1512.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1513.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  1514.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1515.  
  1516.  Supplied Parameters 
  1517.  
  1518.           FunctionCode 
  1519.                     Defines the function to be performed. Must be X'03'. 
  1520.  
  1521.           Version 
  1522.                     Identifies the version of ACDI your application is written 
  1523.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  1524.  
  1525.           DeviceHandle 
  1526.                     Returned by the ComOpen verb; identifies the device to 
  1527.                     ACDI. 
  1528.  
  1529.  Returned Parameters 
  1530.  
  1531.           ReturnCode 
  1532.                     Returns the completion status of the verb. 
  1533.  
  1534.                     The following values can be returned: 
  1535.  
  1536.              X'00'     Successful. 
  1537.  
  1538.              X'01'     Invalid device handle. 
  1539.  
  1540.              X'11'     Requests outstanding. 
  1541.  
  1542.              X'F1'     Base operating system error occurred during execution. 
  1543.  
  1544.              X'F4'     Invalid version of ACDI. 
  1545.  
  1546.              X'FF'     ACDI not started. 
  1547.  
  1548.           For more information, see ACDI Return Codes. 
  1549.  
  1550.  Comments 
  1551.  
  1552.           When an application successfully issues ComClose, the application no 
  1553.           longer owns the port. If the application no longer owns a 
  1554.           communication port through ACDI, ACDI removes itself from the 
  1555.           application's OS/2 exit list. Refer to OS/2 Technical Library for a 
  1556.           description of the OS/2 exit list. 
  1557.  
  1558.  
  1559. ΓòÉΓòÉΓòÉ 7.2. ComConnect (X'21') ΓòÉΓòÉΓòÉ
  1560.  
  1561. ComConnect (X'21') 
  1562.  
  1563.           This verb establishes an asynchronous communications connection. 
  1564.  
  1565.  Prerequisite Calls 
  1566.  
  1567.           ComOpen 
  1568.           ComDefInput 
  1569.           ComDefOutputBuff 
  1570.  
  1571.  Verb Control Block Format 
  1572.  
  1573.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  1574.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  1575.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  1576.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1577.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  1578.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1579.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  1580.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1581.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  1582.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1583.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  1584.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1585.                     Γöé CONNECTTYPE       Γöé    X    Γöé       Γöé      Word      Γöé
  1586.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1587.                     Γöé CONNECTTIMEOUT1     Γöé    X    Γöé       Γöé      Word      Γöé
  1588.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1589.                     Γöé CONNECTTIMEOUT2     Γöé    X    Γöé       Γöé      Word      Γöé
  1590.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1591.                     Γöé TELENETPREFIXLNG     Γöé    X    Γöé       Γöé      Byte      Γöé
  1592.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1593.                     Γöé TELENETPREFIXPTR     Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  1594.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1595.                     Γöé TELENETSUFFIXLNG     Γöé    X    Γöé       Γöé      Byte      Γöé
  1596.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1597.                     Γöé TELENETSUFFIXPTR     Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  1598.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1599.                     Γöé TELENUMBERLNG      Γöé    X    Γöé       Γöé      Byte      Γöé
  1600.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1601.                     Γöé TELENUMBERPTR      Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  1602.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1603.  
  1604.  Supplied Parameters 
  1605.  
  1606.           FunctionCode 
  1607.                     Defines the function to be performed. Must be X'21'. 
  1608.  
  1609.           Version 
  1610.                     Identifies the version of ACDI your application is written 
  1611.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  1612.  
  1613.           DeviceHandle 
  1614.                     Returned by the ComOpen verb; identifies the device to 
  1615.                     ACDI. 
  1616.  
  1617.           ConnectType 
  1618.                     Defined as follows: 
  1619.  
  1620.              Type      Description 
  1621.  
  1622.              0         Used for manual connection to the destination and for 
  1623.                        the establishment of the data connection by the DCE with 
  1624.                        the originate frequency. The user establishes the voice 
  1625.                        connection. When ACDI receives a ComConnect verb for 
  1626.                        this type, ACDI commands the attached DCE to switch to a 
  1627.                        data connection with the originate frequency. The 
  1628.                        command string passed to the DCE is the voice to the 
  1629.                        data originate string. 
  1630.  
  1631.              1         Used for manual connection to the destination and for 
  1632.                        the establishment of data connection by the DCE with the 
  1633.                        answer frequency. The user establishes the voice 
  1634.                        connection, and when ACDI receives a ComConnect verb for 
  1635.                        this type, ACDI commands the attached DCE to switch to a 
  1636.                        data connection with the answer frequency. The command 
  1637.                        string passed to the DCE is the voice to the data answer 
  1638.                        string. 
  1639.  
  1640.              2         For automatic data dialing, the connect string passed to 
  1641.                        the DCE consists of configured strings and command 
  1642.                        strings passed on this verb. 
  1643.  
  1644.              3         For automatic data answering, the command string passed 
  1645.                        to the DCE is the voice to the data answer string if 
  1646.                        ACDI is managing an auto-answer delay. If not, the 
  1647.                        auto-answer string is used. 
  1648.  
  1649.              4         Used for activating other connections. For example, 
  1650.                        user-configured V.24/RS-232C devices with data switches, 
  1651.                        or direct connections to hosts. No command string passes 
  1652.                        to the DCE for this connect type. 
  1653.  
  1654.           ConnectTimeout1, ConnectTimeout2 
  1655.                     Defined as follows: 
  1656.  
  1657.              For ConnectType=0, 1, or 4 ConnectTimeout1 should be set to 
  1658.                        X'0000'. ConnectTimeout2 determines how long ACDI waits 
  1659.                        for the connection to be established before returning 
  1660.                        the ComConnect verb with a time-out return code. 
  1661.                        ConnectTimeout2 is in the range X'0001' to X'FFFF'. 
  1662.  
  1663.                        The time-out value is in the range of 1 to 65535 
  1664.                        seconds. The time is started when the command (and 
  1665.                        equivalent circuit behavior) is sent to the device. 
  1666.  
  1667.              For ConnectType=2 ConnectTimeout1 should be set to X'0000'. 
  1668.                        ConnectTimeout2 determines how long ACDI waits for the 
  1669.                        connection to be established before returning the 
  1670.                        ComConnect verb with a time-out return code. 
  1671.                        ConnectTimeout2 is in the range X'0001' to X'FFFF'. 
  1672.  
  1673.                        The time-out value is in the range of 1 to 65535 
  1674.                        seconds. This is the amount of time to wait before 
  1675.                        disconnecting or hanging up. The time is started when 
  1676.                        the command (and equivalent circuit behavior) is sent to 
  1677.                        the device. 
  1678.  
  1679.                        If ConnectTimeout1 and ConnectTimeout2= X'0000', ACDI 
  1680.                        chooses a default that agrees with the requirements of 
  1681.                        the attached network. 
  1682.  
  1683.                        Note:  Asking for a default is recommended.
  1684.  
  1685.              For ConnectType=3 ConnectTimeout1 indicates how long ACDI waits 
  1686.                        for a call to come in before returning with a time-out 
  1687.                        error. A value of 0 (X'0000') means infinite time-out. 
  1688.                        All other values (X'0001'to X'FFFF') specify a time-out 
  1689.                        in seconds. The time starts when the auto-answer command 
  1690.                        is sent to the device. When ConnectType=3, 
  1691.                        ConnectTimeout2 is ignored. 
  1692.  
  1693.           TeleNetPrefixLng 
  1694.                     The length of the ASCII string containing the telephone 
  1695.                     network prefix. 
  1696.  
  1697.           TeleNetPrefixPtr 
  1698.                     A pointer to the ASCII string containing the telephone 
  1699.                     network prefix. Both the pointer and the string can be 
  1700.                     null. This pointer is not examined unless the ConnectType 
  1701.                     is 2 (auto-dial). ASCII characters between X'00' and X'FF' 
  1702.                     are allowed in the string. 
  1703.  
  1704.           TeleNetSuffixLng 
  1705.                     The length of the ASCII string containing the telephone 
  1706.                     network suffix. 
  1707.  
  1708.           TeleNetSuffixPtr 
  1709.                     A pointer to the ASCII string containing the telephone 
  1710.                     network routing suffix. Both the pointer and the string can 
  1711.                     be null. This pointer is not examined unless the 
  1712.                     ConnectType is 2 (auto-dial). ASCII characters between 
  1713.                     X'00' and X'FF' are allowed in the string. 
  1714.  
  1715.           TeleNumberLng 
  1716.                     The length of the ASCII string containing the telephone 
  1717.                     number. 
  1718.  
  1719.           TeleNumberPtr 
  1720.                     A pointer to the ASCII string containing the telephone 
  1721.                     number. This pointer must point to a valid string for 
  1722.                     ConnectType2. This pointer is not examined unless the 
  1723.                     ConnectType is 2 (auto-dial). ASCII characters between 
  1724.                     X'00' and X'FF' are allowed in the string. 
  1725.  
  1726.  Returned Parameters 
  1727.  
  1728.           ReturnCode 
  1729.                     Returns the completion status of the verb. 
  1730.  
  1731.                     The following values can be returned: 
  1732.  
  1733.              X'00'     Successful. 
  1734.  
  1735.              X'01'     Invalid device handle. 
  1736.  
  1737.              X'02'     Invalid parameter address. 
  1738.  
  1739.              X'03'     No connection exists. 
  1740.  
  1741.              X'3B'     Undefined input or output buffers. 
  1742.  
  1743.              X'61'     DCE hardware not responding. 
  1744.  
  1745.              X'62'     Invalid ConnectTimeout value. 
  1746.  
  1747.              X'63'     Data set ready (DSR) signal was not negated for at least 
  1748.                        100 milliseconds. 
  1749.  
  1750.              X'65'     Call violates country requirements. 
  1751.  
  1752.              X'66'     Call attempt cannot be made. 
  1753.  
  1754.              X'67'     Time-out occurred. 
  1755.  
  1756.              X'69'     Physical port being used for a connection. 
  1757.  
  1758.              X'6C'     Requested connection time-out value violates network 
  1759.                        requirements. 
  1760.  
  1761.              X'6D'     Successful connection - switched. This return code 
  1762.                        returns only when ConnectType=4. 
  1763.  
  1764.              X'6E'     Successful connection - non-switched. This return code 
  1765.                        returns only when ConnectType=4. 
  1766.  
  1767.              X'71'     Requested function not supported. 
  1768.  
  1769.              X'7B'     Call collision occurred. 
  1770.  
  1771.              X'F1'     Base operating system error occurred during execution. 
  1772.  
  1773.              X'F4'     Invalid version of ACDI. 
  1774.  
  1775.              X'FF'     ACDI not started. 
  1776.  
  1777.           For more information, see ACDI Return Codes. 
  1778.  
  1779.  Comments 
  1780.  
  1781.           ACDI sends the modem initialization command string to the modem prior 
  1782.           to attempting to send the modem command string for ConnectTypes 0, 1, 
  1783.           2, and 3. This ensures that the proper line speed is set and that the 
  1784.           modem is in a known state for receiving the connection command 
  1785.           string. 
  1786.  
  1787.           ACDI assembles an auto-dial command string and sends the string to 
  1788.           the DCE when ConnectType=2 (auto-dial). This string is assembled as 
  1789.           follows: 
  1790.  
  1791.            1. The first section of the string is the current dialing prefix 
  1792.               string. 
  1793.  
  1794.            2. The second section of the string is the telephone network prefix 
  1795.               string defined on this verb. 
  1796.  
  1797.            3. The third section of the string is the telephone number string 
  1798.               defined on this verb. This portion of the verb is monitored in 
  1799.               accordance with the parameters defined for the current country 
  1800.               and network ID. 
  1801.  
  1802.            4. The fourth section of the string is the telephone network suffix 
  1803.               string defined on this verb. 
  1804.  
  1805.            5. The final section of the string is the current dialing suffix 
  1806.               string. 
  1807.  
  1808.           After sending the dialing suffix string, ACDI monitors the received 
  1809.           data and compares the data for reception of the valid connection 
  1810.           response string. After detecting the string and determining that the 
  1811.           physical circuit conditions are correct, ACDI returns a successful 
  1812.           return code. 
  1813.  
  1814.           Note:  For further information on carriage control, see ComOpen 
  1815.                  (X'02'). 
  1816.  
  1817.           Each of the strings that make up the connect string can contain ASCII 
  1818.           characters between X'00' and X'FF'. When the X'FF' character is 
  1819.           encountered in the connect string, a 1-second pause is executed. This 
  1820.           pause character is not transmitted to the DCE. 
  1821.  
  1822.           ACDI does not allow a single process to own the port in two modes. 
  1823.           Any application that utilizes port sharing by sharing the port with 
  1824.           itself must have two separate processes:  one for auto-answer mode 
  1825.           and one for auto-dial mode. 
  1826.  
  1827.           The thread is blocked until a time-out occurs, the requested 
  1828.           connection is established, or an error situation is detected. 
  1829.  
  1830.           Modification of telephone routing/number strings passed on ComConnect 
  1831.           while this verb has not returned may cause unpredictable results. 
  1832.  
  1833.           When a command string is sent to the data circuit-terminating 
  1834.           equipment (DCE), a device carrier exchange time-out timer is started 
  1835.           that runs out at the end of a user-defined time (default is 60 
  1836.           seconds). If the ConnectTimeout timer has more time remaining than 
  1837.           the device carrier exchange time-out timer, the attempt is 
  1838.           terminated. The device carrier exchange time-out timer is used to 
  1839.           ensure that the local and remote DCEs attain carrier-exchange status. 
  1840.           This timer replaces the ConnectTimeout timer only if the 
  1841.           ConnectTimeout timer has more time remaining. 
  1842.  
  1843.           If the device carrier exchange time-out timer expires without the 
  1844.           DCEs attaining carrier-exchange status, the following occurs: 
  1845.  
  1846.           o For ConnectType=0, 1, or 2, ACDI disconnects and then returns an 
  1847.             error (time-out occurred). 
  1848.  
  1849.           o For ConnectType=3, ACDI disconnects and then returns to auto-answer 
  1850.             mode with the ConnectTimeout timer running. 
  1851.  
  1852.           The ConnectTimeout timer is not used for ConnectType=4. ACDI does not 
  1853.           send command strings for this connect type. 
  1854.  
  1855.           Note:  In this version of ACDI, when ConnectType=4, you will receive 
  1856.                  a different indicator for a successful ComConnect. 
  1857.  
  1858.           The application issues a ReturnCode X'6D' when a successful switched 
  1859.           connection is accomplished for ConnectType=4 or a X'6E' when a 
  1860.           successful non-switched connection is accomplished for ConnectType=4. 
  1861.           These return codes give an application developer more information. 
  1862.           When a connection is established for ConnectType=4, the connection 
  1863.           cannot be broken except by the application issuing a ComDisconnect 
  1864.           verb. When an application has established a data connection and the 
  1865.           connection is lost, the application can continue to send commands to 
  1866.           the DCE and begin a new data connection. This capability allows 
  1867.           applications and users to establish multiple connections, reset 
  1868.           errors, and test command combinations without having to reissue the 
  1869.           ComConnect verb. 
  1870.  
  1871.  
  1872. ΓòÉΓòÉΓòÉ 7.3. ComDefInput (X'14') ΓòÉΓòÉΓòÉ
  1873.  
  1874. ComDefInput (X'14') 
  1875.  
  1876.           This verb defines the input buffer and input mode. 
  1877.  
  1878.  Prerequisite Calls 
  1879.  
  1880.           ComOpen 
  1881.  
  1882.           Note:  There can be no outstanding ComReadBlock or ComReadCharString 
  1883.                  verbs. 
  1884.  
  1885.  Verb Control Block Format 
  1886.  
  1887.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  1888.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  1889.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  1890.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1891.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  1892.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1893.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  1894.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1895.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  1896.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1897.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  1898.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1899.                     Γöé INPUTBUFF        Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  1900.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1901.                     Γöé INBUFFLENGTH       Γöé    X    Γöé       Γöé      Word      Γöé
  1902.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1903.                     Γöé REMAININGDATAPTR     Γöé       Γöé    X    Γöé  Doubleword Address  Γöé
  1904.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1905.                     Γöé REMAININGDATALGTH    Γöé       Γöé    X    Γöé      Word      Γöé
  1906.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1907.                     Γöé REMAININGDATAERRS    Γöé       Γöé    X    Γöé      Byte      Γöé
  1908.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1909.                     Γöé INPUTMODE        Γöé    X    Γöé       Γöé      Byte      Γöé
  1910.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1911.                     Γöé MODEDATA         Γöé    X    Γöé       Γöé     Structure    Γöé
  1912.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1913.  
  1914.  Supplied Parameters 
  1915.  
  1916.           FunctionCode 
  1917.                     Defines the function to be performed. Must be X'14'. 
  1918.  
  1919.           Version 
  1920.                     Identifies the version of ACDI your application is written 
  1921.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  1922.  
  1923.           DeviceHandle 
  1924.                     Returned by the ComOpen verb; identifies the device to 
  1925.                     ACDI. 
  1926.  
  1927.           InputBuff 
  1928.                     Starting address of the input buffer. 
  1929.  
  1930.           InBuffLength 
  1931.                     The input buffer length in bytes. 
  1932.  
  1933.           InputMode 
  1934.                     A value indicating either character, fixed-length block, or 
  1935.                     variable-length block mode. 
  1936.  
  1937.                     The valid input modes are: 
  1938.  
  1939.              X'01'     Character. 
  1940.  
  1941.              X'02'     Fixed-length block. 
  1942.  
  1943.              X'03'     Variable-length block. 
  1944.  
  1945.           ModeData 
  1946.                     A data structure based on the character, fixed-length 
  1947.                     block, or variable-length block mode of the InputMode: 
  1948.  
  1949.              o Character mode 
  1950.  
  1951.                The data structure does not contain any useful data and is not 
  1952.                examined. 
  1953.  
  1954.  
  1955.              o Fixed-length block mode 
  1956.  
  1957.                The data structure is as follows: 
  1958.  
  1959.                BlkLength is a word-size variable the length of the fixed-length 
  1960.                block. It is an unsigned integer with a minimum value of 2 and a 
  1961.                maximum value of 65535. 
  1962.  
  1963.  
  1964.              o Variable-length block mode 
  1965.  
  1966.                The data structure is as follows: 
  1967.  
  1968.                NumStrings is a byte-size variable that defines the number of 
  1969.                end-of-data blocks. The range is 1 to 5. 
  1970.  
  1971.                StringLgth is a byte-size variable that defines the length of 
  1972.                the string in EOBString. The range is 1 to 4. 
  1973.  
  1974.                EOBString is the end-of-block string. This is a 4-byte 
  1975.                fixed-length, left-justified field. StringLgth bytes of this 
  1976.                field are used as the end-of-block string. There can be 1 to 5 
  1977.                of these strings. The number is defined in NumStrings. 
  1978.  
  1979.  Returned Parameters 
  1980.  
  1981.           ReturnCode 
  1982.                     Returns the completion status of the verb. 
  1983.  
  1984.                     The following values can be returned: 
  1985.  
  1986.              X'00'     Successful. 
  1987.  
  1988.              X'01'     Invalid device handle. 
  1989.  
  1990.              X'02'     Invalid parameter address. 
  1991.  
  1992.              X'3E'     More than 128 blocks possible in buffer. 
  1993.  
  1994.              X'3F'     A read command is outstanding for this process. 
  1995.  
  1996.              X'45'     Data segment cannot be locked. 
  1997.  
  1998.              X'49'     Invalid input mode. 
  1999.  
  2000.              X'4B'     Invalid string length or number of strings. 
  2001.  
  2002.              X'5C'     Invalid block or buffer size. 
  2003.  
  2004.              X'5D'     Input buffer smaller than block size. 
  2005.  
  2006.              X'F1'     Base operating system error occurred during execution. 
  2007.  
  2008.              X'F4'     Invalid version of ACDI. 
  2009.  
  2010.              X'FF'     ACDI not started. 
  2011.  
  2012.           RemainingDataPtr 
  2013.                     Address of data remaining in the previous input buffer. 
  2014.                     This is data that has not been previously returned to the 
  2015.                     application. 
  2016.  
  2017.           RemainingDataLgth 
  2018.                     Length of data remaining in previous buffer. 
  2019.  
  2020.           RemainingDataErrs 
  2021.                     Errors in data remaining in previous buffer. See 
  2022.                     ComReadBlock (X'19') for more information. 
  2023.  
  2024.           For more information, see ACDI Return Codes. 
  2025.  
  2026.  Comments 
  2027.  
  2028.           This function is to be used to define a new input buffer. If an input 
  2029.           buffer has already been defined, this function unlocks the existing 
  2030.           buffer and locks the new buffer. 
  2031.  
  2032.           The maximum amount of data contained in the application input buffer 
  2033.           at any time is 1 byte less than the total buffer size. ACDI reserves 
  2034.           a floating byte at the logical end of the data in the buffer. The 
  2035.           application input buffer size should be at least 1 byte larger than 
  2036.           the fixed-length block size and at least 1 byte larger than the 
  2037.           maximum variable-length block size (up to 65535 bytes). This 
  2038.           establishes the minimum size at 2 bytes. 
  2039.  
  2040.           No received data is queued prior to the input buffer being defined. 
  2041.  
  2042.           The application defines the valid input mode: character mode, 
  2043.           fixed-length block mode, or variable-length block mode. 
  2044.  
  2045.           o In character mode, all data is assembled as a single character 
  2046.             string and error information is tracked for the entire string. Use 
  2047.             the ComReadCharString verb in this mode. 
  2048.  
  2049.           o In fixed-length block mode, all data is assembled into fixed-sized 
  2050.             blocks and error information is tracked for each block. Use the 
  2051.             ComReadBlock verb in this mode. 
  2052.  
  2053.           o In variable-length block mode, all data is assembled into 
  2054.             variable-length blocks, which end in application defined strings. 
  2055.             Up to five strings, up to 4 bytes each, can be defined as 
  2056.             terminating strings. Error information is tracked for each block. 
  2057.             Use the ComReadBlock verb in this mode. 
  2058.  
  2059.           When the application redefines the input buffer, ACDI returns the 
  2060.           location, length, and errors for any data in the old buffer that has 
  2061.           not been returned to the application. 
  2062.  
  2063.           The application cannot redefine the input buffer while either a 
  2064.           ComReadCharString or a ComReadBlock verb is outstanding. If an 
  2065.           attempt is made to redefine the input buffer, the ComDefInput verb 
  2066.           returns an error indication. 
  2067.  
  2068.           When the input buffer is redefined, any existing flow thresholds are 
  2069.           reset to computed defaults. The application computes the defaults 
  2070.           using the size of the new buffer. See ComRetFlowThresh (X'10') for a 
  2071.           description of how the defaults are computed. 
  2072.  
  2073.           The ComDefInput function can be called regardless of whether a link 
  2074.           is connected and must be called before a connection is established. 
  2075.  
  2076.           The BlkLength and EobString parameters are ignored in character mode. 
  2077.           All EobString parameters are ignored in fixed-length block mode. 
  2078.  
  2079.           If the BlkLength and InBuffLength parameters result in the 
  2080.           possibility of more than 128 blocks existing in the input buffer, a 
  2081.           warning return code is returned. However, the buffer size and block 
  2082.           length remain as defined. 
  2083.  
  2084.           When data being received in either fixed- or variable-length block 
  2085.           mode causes more than 128 blocks of data to exist in the buffer, ACDI 
  2086.           discards the incoming data as if no more space in the input buffer 
  2087.           exists and an overflow event is posted. See ComReadEvent (X'13') for 
  2088.           information on events queued. 
  2089.  
  2090.           Note:  ACDI calls the OS/2 base operating system to lock the 
  2091.                  application input buffer in the long-term lock area. The base 
  2092.                  operating system locks the entire data segment containing the 
  2093.                  input buffer in the long-term lock memory. To use your system 
  2094.                  resources most efficiently, allocate your application input 
  2095.                  buffer in its own data segment. One way to do this is to use 
  2096.                  the OS/2 command DosAllocSeg to allocate the space for your 
  2097.                  buffer. 
  2098.  
  2099.  
  2100. ΓòÉΓòÉΓòÉ 7.4. ComDefOutputBuff (X'16') ΓòÉΓòÉΓòÉ
  2101.  
  2102. ComDefOutputBuff (X'16') 
  2103.  
  2104.           This verb defines the application output buffer. 
  2105.  
  2106.  Prerequisite Calls 
  2107.  
  2108.           ComOpen 
  2109.  
  2110.           Note:  There can be no outstanding ComReadBlock verb, and all data 
  2111.                  must be transmitted. 
  2112.  
  2113.  Verb Control Block Format 
  2114.  
  2115.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2116.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2117.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2118.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2119.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2120.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2121.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2122.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2123.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  2124.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2125.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  2126.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2127.                     Γöé OUTPUTBUFF        Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  2128.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2129.                     Γöé OUTBUFFLENGTH      Γöé    X    Γöé       Γöé      Word      Γöé
  2130.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2131.  
  2132.  Supplied Parameters 
  2133.  
  2134.           FunctionCode 
  2135.                     Defines the function to be performed. Must be X'16'. 
  2136.  
  2137.           Version 
  2138.                     Identifies the version of ACDI your application is written 
  2139.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2140.  
  2141.           DeviceHandle 
  2142.                     Returned by the ComOpen verb; identifies the device to 
  2143.                     ACDI. 
  2144.  
  2145.           OutputBuff 
  2146.                     The starting address of the output buffer. 
  2147.  
  2148.           OutBuffLength 
  2149.                     The length (size) of the output buffer in bytes. 
  2150.  
  2151.  Returned Parameters 
  2152.  
  2153.           ReturnCode 
  2154.                     Returns the completion status of the verb. 
  2155.  
  2156.                     The following values can be returned: 
  2157.  
  2158.              X'00'     Successful. 
  2159.  
  2160.              X'01'     Invalid device handle. 
  2161.  
  2162.              X'02'     Invalid parameter address. 
  2163.  
  2164.              X'38'     Cannot redefine the buffer; write request in progress. 
  2165.  
  2166.              X'45'     Buffer cannot be locked. 
  2167.  
  2168.              X'4E'     Buffer not empty. 
  2169.  
  2170.              X'5C'     Invalid buffer size. 
  2171.  
  2172.              X'F1'     Base operating system error occurred during execution. 
  2173.  
  2174.              X'F4'     Invalid version of ACDI. 
  2175.  
  2176.              X'FF'     ACDI not started. 
  2177.  
  2178.           For more information, see ACDI Return Codes. 
  2179.  
  2180.  Comments 
  2181.  
  2182.           The maximum amount of data that can be contained in an asynchronous 
  2183.           output buffer at any time is 1 byte less than the total buffer size. 
  2184.           The output buffer size should be at least 1 byte larger than the 
  2185.           maximum number of bytes to be written by a single ComWriteCharString 
  2186.           verb. 
  2187.  
  2188.           This function is used to define a new buffer. When issued, this 
  2189.           function unlocks any existing output buffer and locks the new buffer. 
  2190.  
  2191.           Note:  ACDI calls the OS/2 base operating system to lock the 
  2192.                  application output buffer in the long-term lock area. The base 
  2193.                  operating system locks the entire data segment containing the 
  2194.                  output buffer in the long-term lock memory. To use your system 
  2195.                  resources most efficiently, allocate your application output 
  2196.                  buffer in its own data segment. One way to do this is to use 
  2197.                  the OS/2 command DosAllocSeg to allocate the space for your 
  2198.                  buffer. 
  2199.  
  2200.  
  2201. ΓòÉΓòÉΓòÉ 7.5. ComDisconnect (X'22') ΓòÉΓòÉΓòÉ
  2202.  
  2203. ComDisconnect (X'22') 
  2204.  
  2205.           This verb disconnects the asynchronous communications connection. 
  2206.  
  2207.  Prerequisite Calls 
  2208.  
  2209.           ComOpen 
  2210.           ComConnect (must be connected or pending) 
  2211.  
  2212.  Verb Control Block Format 
  2213.  
  2214.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2215.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2216.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2217.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2218.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2219.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2220.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2221.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2222.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  2223.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2224.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  2225.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2226.  
  2227.  Supplied Parameters 
  2228.  
  2229.           FunctionCode 
  2230.                     Defines the function to be performed. Must be X'22'. 
  2231.  
  2232.           Version 
  2233.                     Identifies the version of ACDI your application is written 
  2234.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2235.  
  2236.           DeviceHandle 
  2237.                     Returned by the ComOpen verb; identifies the device to 
  2238.                     ACDI. 
  2239.  
  2240.  Returned Parameters 
  2241.  
  2242.           ReturnCode 
  2243.                     Returns the completion status of the verb. 
  2244.  
  2245.                     The following values can be returned: 
  2246.  
  2247.              X'00'     Successful. 
  2248.  
  2249.              X'01'     Invalid device handle. 
  2250.  
  2251.              X'80'     No on-hook indication from DCE. 
  2252.  
  2253.              X'F1'     Base operating system error occurred during execution. 
  2254.  
  2255.              X'F4'     Invalid version of ACDI. 
  2256.  
  2257.              X'FF'     ACDI not started. 
  2258.  
  2259.           For more information, see ACDI Return Codes. 
  2260.  
  2261.  Comments 
  2262.  
  2263.           When the application issues this verb: 
  2264.  
  2265.           o ACDI sends the hang-up string to the modem (DCE). This negates the 
  2266.             request to send (RTS) and then negates the data terminal ready 
  2267.             (DTR). 
  2268.  
  2269.           o ACDI returns an error that indicates that the DCE did not 
  2270.             disconnect from the line if data set ready (DSR) is not negated by 
  2271.             the DCE 10 seconds after the DTR is negated. 
  2272.  
  2273.           All of the I/O buffers are flushed as if the ComFlushInput and 
  2274.           ComFlushOutput verbs had been called. ACDI logs the link statistics 
  2275.           network management vector in the Communications Manager error log. 
  2276.  
  2277.           The following verbs are unblocked if necessary and return with a 
  2278.           return code X'03' (no connection exists): 
  2279.  
  2280.           o ComWriteCharString 
  2281.           o ComReadCharString 
  2282.           o ComReadBlock 
  2283.           o ComDrainOutput 
  2284.           o ComConnect 
  2285.  
  2286.  
  2287. ΓòÉΓòÉΓòÉ 7.6. ComDrainOutput (X'1C') ΓòÉΓòÉΓòÉ
  2288.  
  2289. ComDrainOutput (X'1C') 
  2290.  
  2291.           This verb blocks the thread until the transmit output buffer is 
  2292.           emptied. 
  2293.  
  2294.  Prerequisite Calls 
  2295.  
  2296.           ComOpen 
  2297.           ComConnect (must be connected) 
  2298.           ComDefOutputBuff 
  2299.  
  2300.           Note:  There can be no outstanding ComWriteCharString verbs. 
  2301.  
  2302.  Verb Control Block Format 
  2303.  
  2304.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2305.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2306.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2307.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2308.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2309.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2310.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2311.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2312.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  2313.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2314.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  2315.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2316.                     Γöé DRAINTIMEOUT       Γöé    X    Γöé       Γöé      Word      Γöé
  2317.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2318.  
  2319.  Supplied Parameters 
  2320.  
  2321.           FunctionCode 
  2322.                     Defines the function to be performed. Must be X'1C'. 
  2323.  
  2324.           Version 
  2325.                     Identifies the version of ACDI your application is written 
  2326.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2327.  
  2328.           DeviceHandle 
  2329.                     Returned by the ComOpen verb; identifies the device to 
  2330.                     ACDI. 
  2331.  
  2332.           DrainTimeout 
  2333.                     Time to wait for the buffer to drain. This time-out is 
  2334.                     specified in increments of 10-millisecond units. The valid 
  2335.                     input values for this time-out are between 1 and 65535. 
  2336.  
  2337.  Returned Parameters 
  2338.  
  2339.           ReturnCode 
  2340.                     Returns the completion status of the verb. 
  2341.  
  2342.                     The following values can be returned: 
  2343.  
  2344.              X'00'     Successful. 
  2345.  
  2346.              X'01'     Invalid device handle. 
  2347.  
  2348.              X'03'     No connection exists. 
  2349.  
  2350.              X'37'     Write request outstanding. 
  2351.  
  2352.              X'3B'     Undefined output buffer. 
  2353.  
  2354.              X'53'     Time-out exceeded while in XOFF state. 
  2355.  
  2356.              X'54'     Time-out exceeded while in XON state. 
  2357.  
  2358.              X'62'     Invalid time-out. 
  2359.  
  2360.              X'F1'     Base operating system error occurred during execution. 
  2361.  
  2362.              X'F4'     Invalid version of ACDI. 
  2363.  
  2364.              X'FF'     ACDI not started. 
  2365.  
  2366.           For more information, see ACDI Return Codes. 
  2367.  
  2368.  Comments 
  2369.  
  2370.           This verb can only be used while a connection exists. When an 
  2371.           application calls ACDI with this verb, ACDI blocks or holds the 
  2372.           application's thread of execution until the output buffer empties, 
  2373.           the request times out, or a ComDisconnect verb is received by ACDI. 
  2374.  
  2375.           If the application buffer does not empty in the specified amount of 
  2376.           time and ACDI has received an XOFF from the remote sender, or the 
  2377.           application has issued the ComStopTrans verb, this request returns 
  2378.           with a return code of X'53'. A request that times out returns with a 
  2379.           return code of X'54'. 
  2380.  
  2381.           When using adapters containing UARTs with first-in-first-out (FIFO) 
  2382.           buffers (16550A), ensure that line speed or line control values are 
  2383.           changed. Use of the ComDrainOutput verb prior to these types of 
  2384.           changes will alleviate this problem. This verb does not return while 
  2385.           data is waiting in the transmit FIFO buffer. To use the 
  2386.           ComDrainOutput: 
  2387.  
  2388.            1. Issue a ComWriteCharString verb. 
  2389.  
  2390.               Make a change in either the bit rate or line speed. 
  2391.  
  2392.            2. Issue a ComDrainOutput verb. 
  2393.  
  2394.               Make changes in line speed or line control values using a 
  2395.               ComSetBitRate or a ComSetLineCtrl verb. 
  2396.  
  2397.            3. Issue your new ComWriteCharString verb. 
  2398.  
  2399.  
  2400. ΓòÉΓòÉΓòÉ 7.7. ComFlushInput (X'1A') ΓòÉΓòÉΓòÉ
  2401.  
  2402. ComFlushInput (X'1A') 
  2403.  
  2404.           This verb clears the application input buffer. 
  2405.  
  2406.  Prerequisite Calls 
  2407.  
  2408.           ComOpen 
  2409.           ComDefInput 
  2410.  
  2411.  Verb Control Block Format 
  2412.  
  2413.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2414.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2415.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2416.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2417.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2418.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2419.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2420.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2421.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  2422.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2423.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  2424.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2425.  
  2426.  Supplied Parameters 
  2427.  
  2428.           FunctionCode 
  2429.                     Defines the function to be performed. Must be X'1A'. 
  2430.  
  2431.           Version 
  2432.                     Identifies the version of ACDI your application is written 
  2433.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2434.  
  2435.           DeviceHandle 
  2436.                     Returned by the ComOpen verb; identifies the device to 
  2437.                     ACDI. 
  2438.  
  2439.  Returned Parameters 
  2440.  
  2441.           ReturnCode 
  2442.                     Returns the completion status of the verb. 
  2443.  
  2444.                     The following values can be returned: 
  2445.  
  2446.              X'00'     Successful. 
  2447.  
  2448.              X'01'     Invalid device handle. 
  2449.  
  2450.              X'3B'     Undefined input buffer. 
  2451.  
  2452.              X'F1'     Base operating system error occurred during execution. 
  2453.  
  2454.              X'F4'     Invalid version of ACDI. 
  2455.  
  2456.              X'FF'     ACDI not started. 
  2457.  
  2458.           For more information, see ACDI Return Codes. 
  2459.  
  2460.  Comments 
  2461.  
  2462.           Any data in the application input buffer is cleared, and any 
  2463.           outstanding read request is unblocked and returned to the application 
  2464.           with a canceled return code. After this verb has completed 
  2465.           successfully, new incoming data is queued at the start of the 
  2466.           application input buffer. 
  2467.  
  2468.  
  2469. ΓòÉΓòÉΓòÉ 7.8. ComFlushOutput (X'1B') ΓòÉΓòÉΓòÉ
  2470.  
  2471. ComFlushOutput (X'1B') 
  2472.  
  2473.           This verb clears the application output buffer. 
  2474.  
  2475.  Prerequisite Calls 
  2476.  
  2477.           ComOpen 
  2478.           ComDefOutputBuff 
  2479.  
  2480.  Verb Control Block Format 
  2481.  
  2482.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2483.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2484.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2485.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2486.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2487.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2488.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2489.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2490.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  2491.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2492.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  2493.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2494.  
  2495.  Supplied Parameters 
  2496.  
  2497.           FunctionCode 
  2498.                     Defines the function to be performed. Must be X'1B'. 
  2499.  
  2500.           Version 
  2501.                     Identifies the version of ACDI your application is written 
  2502.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2503.  
  2504.           DeviceHandle 
  2505.                     Returned by the ComOpen verb; identifies the device to 
  2506.                     ACDI. 
  2507.  
  2508.  Returned Parameters 
  2509.  
  2510.           ReturnCode 
  2511.                     Returns the completion status of the verb. 
  2512.  
  2513.                     The following values can be returned: 
  2514.  
  2515.              X'00'     Successful. 
  2516.  
  2517.              X'01'     Invalid device name. 
  2518.  
  2519.              X'3B'     Undefined output buffer. 
  2520.  
  2521.              X'F1'     Base operating system error occurred during execution. 
  2522.  
  2523.              X'F4'     Invalid version of ACDI. 
  2524.  
  2525.              X'FF'     ACDI not started. 
  2526.  
  2527.           For more information, see ACDI Return Codes. 
  2528.  
  2529.  Comments 
  2530.  
  2531.           This verb does not flush data pending from a ComTransImm verb or a 
  2532.           pending XON or XOFF character. This verb cancels a break signal that 
  2533.           is currently being transmitted. ACDI does not transmit any data that 
  2534.           has been cleared from the application output buffer. Any blocked 
  2535.           outstanding write request is unblocked and returned to the 
  2536.           application with a canceled return code. The next available write 
  2537.           pointer is reset to point to the beginning of the buffer when this 
  2538.           verb has completed successfully. 
  2539.  
  2540.           The application places any subsequent data to transmit at the 
  2541.           beginning of the output buffer after this verb has completed 
  2542.           successfully. This verb can be called regardless of whether a 
  2543.           connection exists. 
  2544.  
  2545.  
  2546. ΓòÉΓòÉΓòÉ 7.9. ComGetLineInfo (X'25') ΓòÉΓòÉΓòÉ
  2547.  
  2548. ComGetLineInfo (X'25') 
  2549.  
  2550.           This verb returns information about the RS232-C circuits. 
  2551.  
  2552.  Prerequisite Calls 
  2553.  
  2554.           ComOpen 
  2555.  
  2556.  Verb Control Block Format 
  2557.  
  2558.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2559.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2560.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2561.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2562.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2563.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2564.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2565.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2566.                     Γöé RETURNCODE        Γöé       Γöé    X   Γöé      Word      Γöé
  2567.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2568.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  2569.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2570.                     Γöé INTERFACETYPE      Γöé    X    Γöé       Γöé      Byte      Γöé
  2571.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2572.                     Γöé CIRCUITS         Γöé       Γöé    X   Γöé     Bits (16)    Γöé
  2573.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2574.  
  2575.  Supplied Parameters 
  2576.  
  2577.           FunctionCode 
  2578.                     Defines the function to be performed. Must be X'25'. 
  2579.  
  2580.           Version 
  2581.                     Identifies the version of ACDI your application is written 
  2582.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2583.  
  2584.           DeviceHandle 
  2585.                     Returned by the ComOpen verb; identifies the device to 
  2586.                     ACDI. 
  2587.  
  2588.           InterfaceType 
  2589.                     Identifies the type of interface your application is 
  2590.                     written for. Must be X'00' or X'01'. 
  2591.  
  2592.  Returned Parameters 
  2593.  
  2594.           ReturnCode 
  2595.                     Returns the completion status of the verb. 
  2596.  
  2597.                     The following values can be returned: 
  2598.  
  2599.              X'00'     Successful. 
  2600.  
  2601.              X'01'     Invalid device handle. 
  2602.  
  2603.              X'F1'     Base operating system error occurred during execution. 
  2604.  
  2605.              X'F4'     Invalid version of ACDI. 
  2606.  
  2607.              X'FF'     ACDI not started. 
  2608.  
  2609.           Circuits 
  2610.                     State of each of the signals. 
  2611.  
  2612.                     The Circuits are: 
  2613.  
  2614.              Bit       Meaning 
  2615.  
  2616.              0         Carrier detect signal status (0,1). 
  2617.  
  2618.              1         Data set ready signal status (0,1). 
  2619.  
  2620.              2         Clear to send signal status (0,1). 
  2621.  
  2622.              3         Data terminal ready (DTR) signal status (0,1). 
  2623.  
  2624.                     Other bits are reserved. 
  2625.  
  2626.           For more information, see ACDI Return Codes. 
  2627.  
  2628.  Comments 
  2629.  
  2630.           An application issues this verb to find out whether the RS232-C 
  2631.           carrier detect, data set ready, clear to send, and data terminal 
  2632.           ready signals are asserted or negated. 
  2633.  
  2634.  
  2635. ΓòÉΓòÉΓòÉ 7.10. ComOpen (X'02') ΓòÉΓòÉΓòÉ
  2636.  
  2637. ComOpen (X'02') 
  2638.  
  2639.           This verb opens an asynchronous communications device and passes 
  2640.           configuration information to ACDI. 
  2641.  
  2642.  Prerequisite Calls 
  2643.  
  2644.           None. 
  2645.  
  2646.  Verb Control Block Format 
  2647.  
  2648.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  2649.                     Γöé             Γöé  SUPPLIED  Γöé  RETURNED  Γöé             Γöé
  2650.                     Γöé PARAMETER NAME      Γöé  PARAMETER  Γöé  PARAMETER  Γöé     LENGTH     Γöé
  2651.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2652.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  2653.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2654.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  2655.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2656.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  2657.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2658.                     Γöé DEVICEHANDLE       Γöé       Γöé    X    Γöé      Word      Γöé
  2659.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2660.                     Γöé COMDEVNAME        Γöé    X    Γöé       Γöé     Bytes (9)    Γöé
  2661.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2662.                     Γöé FLAGS          Γöé    X    Γöé       Γöé      Word      Γöé
  2663.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2664.                     Γöé TELEPHONENETWORKID    Γöé    X    Γöé       Γöé      Word      Γöé
  2665.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2666.                     Γöé DEVICETYPE        Γöé    X    Γöé       Γöé      Byte      Γöé
  2667.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2668.                     Γöé AUTOANSDELDUR      Γöé    X    Γöé       Γöé      Byte      Γöé
  2669.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2670.                     Γöé CAREXCHTIMEOUT      Γöé    X    Γöé       Γöé      Byte      Γöé
  2671.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2672.                     Γöé DICMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2673.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2674.                     Γöé CPCMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2675.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2676.                     Γöé DSCMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2677.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2678.                     Γöé SCRESPSTRING       Γöé    X    Γöé       Γöé    Bytes (24)    Γöé
  2679.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2680.                     Γöé UCRESPSTRING       Γöé    X    Γöé       Γöé    Bytes (24)    Γöé
  2681.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2682.                     Γöé ICRESPSTRING       Γöé    X    Γöé       Γöé    Bytes (24)    Γöé
  2683.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2684.                     Γöé CFBUSYFLAGS       Γöé    X    Γöé       Γöé      Byte      Γöé
  2685.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2686.                     Γöé CFWRONGNUMFLAGS     Γöé    X    Γöé       Γöé      Byte      Γöé
  2687.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2688.                     Γöé CFOTHERFLAGS       Γöé    X    Γöé       Γöé      Byte      Γöé
  2689.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2690.                     Γöé CFRESPSTRING1-      Γöé       Γöé       Γöé             Γöé
  2691.                     Γöé CFRESPSTRING8      Γöé    X    Γöé       Γöé   Bytes (24 each)   Γöé
  2692.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2693.                     Γöé AACMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2694.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2695.                     Γöé HUCMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2696.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2697.                     Γöé VOCMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2698.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2699.                     Γöé VACMDSTRING       Γöé    X    Γöé       Γöé    Bytes (256)    Γöé
  2700.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2701.                     Γöé VCRESPSTRING       Γöé    X    Γöé       Γöé    Bytes (24)    Γöé
  2702.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2703.  
  2704.           Note:  The application must not already be opened by this function 
  2705.                  and must not be opened by more than one other process. 
  2706.  
  2707.  Supplied Parameters 
  2708.  
  2709.           FunctionCode 
  2710.                     Defines the function to be performed. Must be X'02'. 
  2711.  
  2712.           Version 
  2713.                     Identifies the version of ACDI your application is written 
  2714.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  2715.  
  2716.           ComDevName 
  2717.                     An ASCII string that contains a base operating system 
  2718.                     character device name such as COM1. The length can be 8 
  2719.                     characters maximum (plus the X'00' terminator). 
  2720.  
  2721.                     The valid device names for ACDI are COM1, COM2, and COM3. 
  2722.  
  2723.           Flags 
  2724.                     A group of flags that indicate configurable options. The 
  2725.                     flags are defined as follows: 
  2726.  
  2727.              Bit       Meaning 
  2728.  
  2729.              0         Type of line interface. 
  2730.  
  2731.                                               OFF = Switched
  2732.                                               ON  = Non-switched
  2733.  
  2734.                        This bit is only valid when DeviceType = 9 (V.24). 
  2735.  
  2736.              1         Is DSR always asserted? 
  2737.  
  2738.                                               OFF = No
  2739.                                               ON  = Yes
  2740.  
  2741.                        This bit is only valid when Device Type = 9 (V.24) and 
  2742.                        bit 0 is OFF (switched). 
  2743.  
  2744.              2         Does DTE or DCE do auto-answer delay? 
  2745.  
  2746.                                               OFF = DTE
  2747.                                               ON  = DCE
  2748.  
  2749.              3         What is the auto-answer delay increment? 
  2750.  
  2751.                                               OFF = Seconds
  2752.                                               ON  = Rings
  2753.  
  2754.              4         What command strings are to be used when the DeviceType 
  2755.                        value is other than 9? 
  2756.  
  2757.                                               OFF = ACDI-supplied
  2758.                                               ON  = User-supplied
  2759.  
  2760.                        If ACDI-supplied is selected, the standard ACDI command 
  2761.                        strings for DeviceType are used. If user-supplied is 
  2762.                        selected, the command and response strings in the 
  2763.                        following parameters are used: 
  2764.  
  2765.                 o DICmdString 
  2766.                 o DPCmdString 
  2767.                 o SDCmdString 
  2768.                 o AACmdString 
  2769.                 o HUCmdString 
  2770.                 o VOCmdString 
  2771.                 o VACmdString 
  2772.                 o SCRespString 
  2773.                 o UCRespString 
  2774.                 o ICRespString 
  2775.                 o CFRespString1 through CFRespString8 
  2776.                 o VCRespString 
  2777.  
  2778.              5         Reserved. This bit must be OFF. 
  2779.  
  2780.              6         Reserved. This bit must be OFF. 
  2781.  
  2782.              7         Reserved. This bit must be OFF. 
  2783.  
  2784.              8         Reserved. This bit must be OFF. 
  2785.  
  2786.              9         Reserved. This bit must be OFF. 
  2787.  
  2788.              10        Reserved. This bit must be OFF. 
  2789.  
  2790.              11        Reserved. This bit must be OFF. 
  2791.  
  2792.              12        Reserved. This bit must be OFF. 
  2793.  
  2794.              13        Reserved. This bit must be OFF. 
  2795.  
  2796.              14        Reserved. This bit must be OFF. 
  2797.  
  2798.              15        Is configuration information being passed on this verb? 
  2799.  
  2800.                                               OFF = No
  2801.                                               ON  = Yes
  2802.  
  2803.                        If this bit is OFF, bits 0 through 14 and the remaining 
  2804.                        parameters are ignored. The configuration information 
  2805.                        used by ACDI when this bit is OFF is found in the 
  2806.                        configuration file produced when the Asynchronous 
  2807.                        Communications Port Profiles were configured. 
  2808.  
  2809.           TelephoneNetworkID 
  2810.                     This is the code for the country in which the program is to 
  2811.                     be run. For a list of telephone network IDs, refer to 
  2812.                     Configuration Guide. 
  2813.  
  2814.                     Note:  If the specific country is not listed, choose a 
  2815.                            country that contains the same homologation 
  2816.                            requirements as the country in which the program is 
  2817.                            to run. 
  2818.  
  2819.           DeviceType 
  2820.                     The type of DCE that is attached. DCEs that support the 
  2821.                     same command sets as the devices listed are also supported. 
  2822.                     The valid values are: 
  2823.  
  2824.              1         Hayes Smartmodem 1200 (AT command set) 
  2825.  
  2826.              2         Hayes Smartmodem 2400 (AT command set) 
  2827.  
  2828.              3         Hayes V-Series Modem Enhancer 1200 (AT command set) 
  2829.  
  2830.              4         Hayes V-Series Modem Enhancer 2400 (AT command set) 
  2831.  
  2832.              5         IBM Personal Computer Series (AT command set) 
  2833.  
  2834.              6         ROLMphone 244PC (AT command set) 
  2835.  
  2836.              7         MicroCom AX/2400C, AX/9624C (AT command set) 
  2837.  
  2838.              8         Racal-Vadic VI2422PA, VI2422S (V.25bis command set) 
  2839.  
  2840.              9         Other (V.24 circuits) 
  2841.  
  2842.           AutoAnsDelDur 
  2843.                     The time that ACDI waits before answering the call. 
  2844.  
  2845.                     This delay increment is specified in bit 3 of the preceding 
  2846.                     Flags byte. The delay is ignored if bit 2 of the Flags byte 
  2847.                     is ON. Valid values are 0 through 255. 
  2848.  
  2849.           CarExchTimeout 
  2850.                     The amount of time (in seconds) that ACDI waits for the 
  2851.                     modems to exchange carrier signals. 
  2852.  
  2853.                     Time begins when the modem goes off-hook, and time 
  2854.                     terminates when the modem asserts carrier detect (CD). 
  2855.                     Valid values are 1 through 255. 
  2856.  
  2857.           DICmdString 
  2858.                     The device-initialization command string is composed of a 
  2859.                     1-byte field followed by a 255-byte command string field. 
  2860.  
  2861.                     The command string sets the DCE into a known, initialized 
  2862.                     state. The command string is sent to the DCE whenever ACDI 
  2863.                     initializes the DCE. 
  2864.  
  2865.           DPCmdString 
  2866.                     The dialing-prefix command string is composed of a 1-byte 
  2867.                     field followed by a 255-byte command string field. 
  2868.  
  2869.                     The command string navigates the call to a node in order to 
  2870.                     initialize the call. This command string is sent to the DCE 
  2871.                     when ACDI receives a ComConnect verb with ConnectType2 
  2872.                     (auto-dial). 
  2873.  
  2874.           DSCmdString 
  2875.                     The dialing-suffix command string is composed of a 1-byte 
  2876.                     field followed by a 255-byte command string field. 
  2877.  
  2878.                     The command string completes the call navigation and 
  2879.                     signals the DCE to place the call. This command string is 
  2880.                     sent to the DCE when ACDI receives the ComConnect verb with 
  2881.                     ConnectType2 (auto-dial). 
  2882.  
  2883.           SCRespString 
  2884.                     The successful command response string is composed of a 
  2885.                     1-byte field followed by a 24-byte response string field. 
  2886.  
  2887.                     The response string notifies the DTE that the DCE has 
  2888.                     successfully executed the last command. The input data 
  2889.                     stream is monitored for this response each time a 
  2890.                     command-execution character (carriage return) is detected 
  2891.                     in the outgoing command. This response indicates that the 
  2892.                     DTE should proceed to the next command or continue sending 
  2893.                     the current command string. 
  2894.  
  2895.           UCRespString 
  2896.                     The unsuccessful command response string is composed of a 
  2897.                     1-byte length field followed by a 24-byte response string 
  2898.                     field. 
  2899.  
  2900.                     The response string notifies the DTE that the DCE has not 
  2901.                     successfully executed the last command. It is possible that 
  2902.                     the command or its parameters are not recognized or 
  2903.                     supported at this time. The input data stream is monitored 
  2904.                     for this response each time a command-execution character 
  2905.                     (carriage return) is detected in the outgoing command. This 
  2906.                     response indicates that the DTE may want to take 
  2907.                     alternative action. 
  2908.  
  2909.           ICRespString 
  2910.                     The incoming-call response string is composed of a 1-byte 
  2911.                     length field followed by a 24-byte response string field. 
  2912.  
  2913.                     This response string notifies the DTE that the DCE has 
  2914.                     detected an incoming call or call attempt. The input data 
  2915.                     stream is monitored for this response each time ACDI goes 
  2916.                     into auto-answer mode (ConnectType3) and the DTE is 
  2917.                     configured as doing auto-answer delay (bit 2 of Flags is 
  2918.                     OFF). 
  2919.  
  2920.                     This response indicates that the DTE may want to instruct 
  2921.                     the DCE to go off-hook (answer the call) when the 
  2922.                     appropriate delay count is achieved (when the DTE is 
  2923.                     configured as doing the auto-answer delay). 
  2924.  
  2925.                     When the DCE is configured as doing the auto-answer delay 
  2926.                     (bit 2 of Flags is ON), this response is ignored. In the 
  2927.                     case of auto-dialing, this response is classified as an 
  2928.                     other-call response for homologation purposes. This 
  2929.                     response indicates that the DTE may want to take 
  2930.                     alternative action. 
  2931.  
  2932.           CFBusyFlags 
  2933.                     Contains a flag for each of the call-failure response 
  2934.                     strings. Each flag indicates that the corresponding 
  2935.                     call-failure response string is a busy-number response from 
  2936.                     the DCE. 
  2937.  
  2938.                     This response string notifies the DTE that the DCE detected 
  2939.                     a busy signal for the remote DCE and that the call attempt 
  2940.                     was (usually) ended. The input data stream waits for this 
  2941.                     response each time an attempt is made to auto-dial. 
  2942.  
  2943.                     A bit that is ON indicates that the corresponding 
  2944.                     call-failure response string is to be treated as a busy 
  2945.                     response for homologation purposes. 
  2946.  
  2947.           CFWrongNumFlags 
  2948.                     Contains a flag for each of the call-failure response 
  2949.                     strings that indicates that the corresponding call-failure 
  2950.                     response string is a wrong-number response from the DCE. 
  2951.  
  2952.                     This response string notifies the DTE that the DCE detected 
  2953.                     a wrong-number signal from the remote DCE that the call 
  2954.                     attempt was (usually) ended. The input data stream waits 
  2955.                     for this response each time an attempt is made to 
  2956.                     auto-dial. 
  2957.  
  2958.                     A bit that is ON indicates that the corresponding 
  2959.                     call-failure response string is to be treated as a wrong 
  2960.                     number for homologation purposes. 
  2961.  
  2962.           CFOtherFlags 
  2963.                     Contains a flag for each of the call-failure response 
  2964.                     strings. Each flag indicates that the corresponding 
  2965.                     call-failure response string is another response from the 
  2966.                     DCE. 
  2967.  
  2968.                     This response string notifies the DTE that the DCE has 
  2969.                     failed to make a call because of a local condition or a 
  2970.                     time-out. The input data stream waits for this response 
  2971.                     each time an attempt is made to auto-dial. 
  2972.  
  2973.                     A bit that is ON indicates that the corresponding 
  2974.                     call-failure response string is to be treated as a busy 
  2975.                     response for homologation purposes. 
  2976.  
  2977.           CFRespString1-8 
  2978.                     The call-failure response strings are composed of a 1-byte 
  2979.                     length field followed by a 24-byte response string field. 
  2980.                     The input data stream waits for these strings each time an 
  2981.                     attempt is made to auto-dial. Each string length is greater 
  2982.                     than 0. 
  2983.  
  2984.                     The call-failure flags specify the correct action for ACDI 
  2985.                     to take with respect to homologation enforcement for the 
  2986.                     string detected. 
  2987.  
  2988.           AACmdString 
  2989.                     The auto-answer command string is composed of a 1-byte 
  2990.                     length field followed by a 255-byte command string field. 
  2991.  
  2992.                     This command string instructs the DCE to answer an incoming 
  2993.                     call after a specified period has elapsed since the first 
  2994.                     indication of the incoming call. This command string is 
  2995.                     sent to the DCE whenever ACDI receives a ComConnect verb 
  2996.                     with ConnectType3 and bit 2 of the Flags byte is set to ON 
  2997.                     (DCE does auto-answer delay). 
  2998.  
  2999.                     This string should contain the auto-answer delay 
  3000.                     programming for the DCE and is not used for V.25bis 
  3001.                     configurations. 
  3002.  
  3003.           HUCmdString 
  3004.                     The hang-up command string is composed of a 1-byte length 
  3005.                     field followed by a 255-byte command string field. 
  3006.  
  3007.                     This command string instructs the DCE to terminate a call 
  3008.                     connection. It is sent to the DCE whenever ACDI receives a 
  3009.                     ComDisconnect verb and is not used for V.25bis 
  3010.                     configuration. 
  3011.  
  3012.           VOCmdString 
  3013.                     The voice-to-data-originate command string is composed of a 
  3014.                     1-byte length field followed by a 255-byte command string 
  3015.                     field. 
  3016.  
  3017.                     This command string instructs the DCE to go off-hook in 
  3018.                     originate frequency mode. It is sent to the DCE whenever 
  3019.                     ACDI receives a ComConnect verb with ConnectType0 (manually 
  3020.                     established connection with originate frequency). 
  3021.                     VOCmdString is not used for V.25bis configuration. 
  3022.  
  3023.           VACmdString 
  3024.                     The voice-to-data-answer command string is composed of a 
  3025.                     1-byte length field followed by a 255-byte command string. 
  3026.  
  3027.                     This command instructs the DCE to go off-hook in answer 
  3028.                     frequency mode. It is sent to the DCE: 
  3029.  
  3030.              o After ACDI receives a ComConnect verb with ConnectType1 
  3031.                (manually established connection with answer frequency) 
  3032.  
  3033.              o After the delay specified by AutoAnsDelDur has occurred and bit 
  3034.                3 of the Flags byte is specified. ACDI receives a ComConnect 
  3035.                verb with ConnectType3, and bit 2 of the Flags byte is set to 0 
  3036.                (DTE does auto-answer delay). 
  3037.  
  3038.                     This string is not used for V.25bis configurations. 
  3039.  
  3040.           VCRespString 
  3041.                     The valid-connection response string is composed of a 
  3042.                     1-byte length field followed by a 24-byte response string 
  3043.                     field. 
  3044.  
  3045.                     This string provides ACDI with the standard response from 
  3046.                     the DCE that indicates a data connection has occurred. 
  3047.                     VCRespString is received in addition to the DSR and CD 
  3048.                     control signals. It is not used for V.25bis configurations. 
  3049.  
  3050.  Returned Parameters 
  3051.  
  3052.           ReturnCode 
  3053.                     Returns the completion status of the verb. 
  3054.  
  3055.                     The following values can be returned: 
  3056.  
  3057.              X'00'     Successful. 
  3058.  
  3059.              X'0B'     Invalid device name. 
  3060.  
  3061.              X'0C'     Device cannot be opened. 
  3062.  
  3063.              X'0D'     ACDI device driver not installed. 
  3064.  
  3065.              X'36'     Device already opened. 
  3066.  
  3067.              X'F1'     Base operating system error occurred during execution. 
  3068.  
  3069.              X'F4'     Invalid version of ACDI. 
  3070.  
  3071.              X'FF'     ACDI not started. 
  3072.  
  3073.           DeviceHandle 
  3074.                     Returned by the ComOpen verb; identifies the device to 
  3075.                     ACDI. 
  3076.  
  3077.           For more information, see ACDI Return Codes. 
  3078.  
  3079.  Comments 
  3080.  
  3081.           An application must issue this verb to obtain a communication port. 
  3082.           ACDI returns a device handle for the port when the ComOpen verb is 
  3083.           successful, and the application uses that handle on successive calls 
  3084.           to ACDI. ACDI may then perform functions for a specific device that 
  3085.           the application owns. 
  3086.  
  3087.           Note:  The word application refers to an OS/2 process. ACDI tracks 
  3088.                  resources for an application based on the OS/2 process ID of 
  3089.                  the application. 
  3090.  
  3091.           Up to two processes may open a communication port as long as the user 
  3092.           has not configured the port as Other modem or device. See 
  3093.           Asynchronous Port Sharing for additional information. 
  3094.  
  3095.           When a port is successfully opened, ACDI puts itself on the 
  3096.           application's OS/2 exit list. See Application Exit List Processing 
  3097.           for further information. Refer to OS/2 Technical Library for a 
  3098.           description of the OS/2 exit list. 
  3099.  
  3100.           When bit 15 of Flags is ON, ACDI assumes the application is passing 
  3101.           configuration data on this verb. When this bit is OFF, ACDI assumes 
  3102.           the application is to use the configuration defined by the user 
  3103.           during Asynchronous Feature Configuration. For more information, 
  3104.           refer to Configuration Guide. 
  3105.  
  3106.           The configuration passed on this verb is valid until a ComClose verb 
  3107.           is received. 
  3108.  
  3109.           ACDI searches the telephony homologation file for an entry with the 
  3110.           designated telephone network ID. If no entry is found, an error is 
  3111.           returned. If an entry is found, it is used to validate the 
  3112.           configuration parameters passed on this verb. 
  3113.  
  3114.           When the command strings are passed to ACDI (bit 4 of Flags is ON), 
  3115.           they replace the ACDI supplied strings. There is no facility in the 
  3116.           interface for the application to pass less than the entire complement 
  3117.           of strings. 
  3118.  
  3119.           If command strings are defined in the DICmdString, String, 
  3120.           DSCmdString, AACmdString, HUCmdString, VOCmdString, VACmdString, 
  3121.           SCRespString, UCRespString, ICRespString, CFRespString1 through 
  3122.           CFRespString8, and VCRespString parameters, and bit 4 of Flags is 
  3123.           OFF, ACDI ignores the passed strings and retrieves the ACDI supplied 
  3124.           strings for the specified device type. 
  3125.  
  3126.           Command strings are allowed to be null. The length of the string 
  3127.           structure should be set to 0 bytes to indicate a null string 
  3128.  
  3129.           When a ComConnect verb is received by ACDI with ConnectType2 
  3130.           (auto-dial), ACDI constructs a command string to send to the DCE as 
  3131.           follows: 
  3132.  
  3133.           o Dialing-prefix command string 
  3134.           o Telephone-network-prefix command string from the ComConnect verb 
  3135.           o Telephone-number string from the ComConnect verb 
  3136.           o Telephone-network-suffix command string from the ComConnect verb 
  3137.           o Dialing-suffix command string 
  3138.  
  3139.           The purpose of the dialing-prefix and dialing-suffix command strings 
  3140.           is to handle any special predialing requirements, such as selecting a 
  3141.           modem from a modem pool, navigating through a CBX to a private 
  3142.           network (such as a tie line) or navigating through a CBX to a public 
  3143.           network (dialing 9 for outside). Once the navigation is completed, 
  3144.           the telephone-network command strings instruct the DCE when the 
  3145.           command string is connecting to another network such as MCI** or 
  3146.           Sprint**. The dialing suffix normally contains only the 
  3147.           begin-execution character (usually carrier return) to indicate to the 
  3148.           DCE that it is to begin dialing the requested number. 
  3149.  
  3150.           When a DCE or telephone network does not permit tone dialing, the 
  3151.           DPCmdString should be modified to instruct the DCE to perform pulse 
  3152.           dialing. 
  3153.  
  3154.           Either process that is sharing the port may supply configuration 
  3155.           information on the ComOpen verb. 
  3156.  
  3157.           When the ComConnect verb for auto-dial from a second process is 
  3158.           received by ACDI, the configuration in effect for the first process 
  3159.           (the one allowing the port to be shared) is saved. When the 
  3160.           ComDisconnect verb from the second process is received, the 
  3161.           configuration for the first process is restored. 
  3162.  
  3163.           Note:  No attempt is made by ACDI to ensure the two configurations 
  3164.                  are compatible. It is the responsibility of the application 
  3165.                  and its users to make sure the proper hardware is attached to 
  3166.                  the port prior to an attempt to share the port between 
  3167.                  different devices. 
  3168.  
  3169.           The arrangement of the command string and response string structures 
  3170.           allows V.25bis users to allocate less memory for the strings than is 
  3171.           required for ATtention-command-set users for this verb's control 
  3172.           block. This occurs because the strings that are not valid for V.25bis 
  3173.           are grouped at the end of the control block. While this seems awkward 
  3174.           to ATtention-command-set users, it makes little or no difference to 
  3175.           the application writer's implementation. The major advantage of this 
  3176.           arrangement is that it saves approximately 1KB of memory allocation 
  3177.           per port for the V.25bis user. 
  3178.  
  3179.  
  3180. ΓòÉΓòÉΓòÉ 7.11. ComReadBlock (X'19') ΓòÉΓòÉΓòÉ
  3181.  
  3182. ComReadBlock (X'19') 
  3183.  
  3184.           This verb reads a block of data from the input buffer and frees the 
  3185.           block returned on the previous ComReadBlock. 
  3186.  
  3187.  Prerequisite Calls 
  3188.  
  3189.           ComOpen 
  3190.           ComConnect (must be connected or auto-dial connection pending) 
  3191.           ComDefInput 
  3192.  
  3193.  Verb Control Block Format 
  3194.  
  3195.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  3196.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  3197.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3198.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  3199.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3200.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  3201.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3202.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  3203.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3204.                     Γöé NEXTAVAILBLKPTR     Γöé       Γöé    X    Γöé  Doubleword Address  Γöé
  3205.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3206.                     Γöé NEXTAVAILBLKLGTH     Γöé       Γöé    X    Γöé      Word      Γöé
  3207.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3208.                     Γöé READERRORMASK      Γöé       Γöé    X    Γöé      Byte      Γöé
  3209.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3210.  
  3211.  Supplied Parameters 
  3212.  
  3213.           FunctionCode 
  3214.                     Defines the function to be performed. Must be X'19'. 
  3215.  
  3216.           Version 
  3217.                     Identifies the version of ACDI your application is written 
  3218.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  3219.  
  3220.           DeviceHandle 
  3221.                     Returned by the ComOpen verb; identifies the device to 
  3222.                     ACDI. 
  3223.  
  3224.  Returned Parameters 
  3225.  
  3226.           ReturnCode 
  3227.                     Returns the completion status of the verb. 
  3228.  
  3229.                     The following values can be returned: 
  3230.  
  3231.              X'00'     Successful. 
  3232.  
  3233.              X'01'     Invalid device handle. 
  3234.  
  3235.              X'02'     Invalid parameter address. 
  3236.  
  3237.              X'03'     No connection exists. 
  3238.  
  3239.              X'33'     Verb prematurely unblocked. 
  3240.  
  3241.              X'3A'     Verb canceled by the ComFlushInput verb. 
  3242.  
  3243.              X'3B'     Undefined input buffer. 
  3244.  
  3245.              X'3C'     The previous ComReadBlock verb still in progress. 
  3246.  
  3247.              X'53'     Time-out exceeded in XOFF state. 
  3248.  
  3249.              X'54'     Time-out exceeded in XON state. 
  3250.  
  3251.              X'55'     Terminated due to data error. 
  3252.  
  3253.              X'57'     Not valid in current input mode. 
  3254.  
  3255.              X'5E'     Input buffer is full. 
  3256.  
  3257.              X'F1'     Base operating system error occurred during execution. 
  3258.  
  3259.              X'F4'     Invalid version of ACDI. 
  3260.  
  3261.              X'FF'     ACDI not started. 
  3262.  
  3263.           NextAvailBlkPtr 
  3264.                     The address of the next available block of data in the 
  3265.                     application input buffer. 
  3266.  
  3267.           NextAvailBlkLgth 
  3268.                     The length of the block of data in the application input 
  3269.                     buffer. 
  3270.  
  3271.           ReadErrorMask 
  3272.                     The types of errors detected that are being returned to the 
  3273.                     application in this block of data. Detected errors are 
  3274.                     defined as follows: 
  3275.  
  3276.              Bit       Meaning 
  3277.  
  3278.              0         Parity error. 
  3279.  
  3280.                        The hardware detected a parity error. At least one 
  3281.                        parity error is contained in the data being returned. 
  3282.                        Ensure that the correct parity type has been set. See 
  3283.                        ComSetLineCtrl (X'05') for a description of setting the 
  3284.                        data parity. 
  3285.  
  3286.              1         Framing error. 
  3287.  
  3288.                        The hardware detected a framing error. At least one 
  3289.                        framing error is contained in the data being returned. 
  3290.                        Ensure that the correct stop bits, data bits, and parity 
  3291.                        have been set. See ComSetLineCtrl (X'05') for a 
  3292.                        description of setting the number of stop bits and data 
  3293.                        bits. 
  3294.  
  3295.              2         Overrun error. 
  3296.  
  3297.                        The hardware detected an overrun error. At least one 
  3298.                        overrun error is contained in the data being returned. 
  3299.                        An overrun error is caused by a bit rate that prevents 
  3300.                        the system from processing an arriving byte of data 
  3301.                        before a new byte arrives. Two options are available to 
  3302.                        prevent this occurrence: 
  3303.  
  3304.                 o Decreasing the bit rate. See ComSetBitRate (X'04') for a 
  3305.                   description of setting the bit rate. 
  3306.  
  3307.                 o Decreasing the number of concurrent tasks. 
  3308.  
  3309.              3         Overflow error. 
  3310.  
  3311.                        At least one overflow error is contained in the data 
  3312.                        being returned. This error is caused by the application 
  3313.                        not removing data from the input buffer before the input 
  3314.                        buffer fills. The application should: 
  3315.  
  3316.                 o Read the buffer more often. 
  3317.  
  3318.                 o Enable automatic flow control. See ACDI Functions, Structure, 
  3319.                   and Verb Overview for a description of enabling automatic 
  3320.                   flow control. 
  3321.  
  3322.                 o Make the input buffer larger. See ComDefInput (X'14'), for a 
  3323.                   description of redefining the input buffer. 
  3324.  
  3325.                 o Lower the bit rate. See ComSetBitRate (X'04') for a 
  3326.                   description of setting the bit rate. 
  3327.  
  3328.              4-7       Reserved byte, not 0. 
  3329.  
  3330.           For more information, see ACDI Return Codes. 
  3331.  
  3332.  Comments 
  3333.  
  3334.           This verb can only be used while a connection exists. An application 
  3335.           issues this verb to receive data when the input mode is fixed-length 
  3336.           block mode or variable-length block mode. 
  3337.  
  3338.           This verb informs ACDI that the application has processed the block 
  3339.           returned on the previous ComReadBlock verb and that ACDI may use this 
  3340.           free space to queue incoming data, if necessary. When ACDI returns 
  3341.           this verb to the application, the NextAvailBlkPtr points to the next 
  3342.           block of data in the buffer and the NextAvailBlkLgth contains the 
  3343.           number of bytes in that block. 
  3344.  
  3345.           The length of a block includes the end-of-block string for 
  3346.           variable-length blocks. In variable-length block mode, end-of-block 
  3347.           string detection is not performed, and any states in progress reset 
  3348.           when any of the following occur: 
  3349.  
  3350.           o The received data contains either a parity or framing error. 
  3351.           o The received data creates either an overflow or overrun error. 
  3352.           o The received data is a break. 
  3353.  
  3354.           A line drop causes the read thread to be unblocked and returned to 
  3355.           the calling application. 
  3356.  
  3357.           If the application unblocks a blocked ComReadBlock verb with the 
  3358.           ComUnblockThread verb, ACDI returns the ComReadBlock verb with 0's in 
  3359.           the NextAvailBlkLgth and ReadErrorMask return parameters. In this 
  3360.           case, the data remains in the buffer, but the application is not 
  3361.           informed of this read. 
  3362.  
  3363.           If error-character substitution has been enabled and if errors are 
  3364.           detected, this function replaces the bad byte with the substitution 
  3365.           character specified with the ComSetErrorCharSub verb. See 
  3366.           ComSetErrorCharSub (X'1F') for additional information. 
  3367.  
  3368.           ACDI sets the NextAvailBlkPtr return parameter to the beginning of 
  3369.           the buffer, immediately after the buffer has been redefined or the 
  3370.           data communication channel has been disconnected. 
  3371.  
  3372.           The amount of data that ACDI queues in the application input buffer 
  3373.           never exceeds the input buffer size minus 1 byte. ACDI reserves 1 
  3374.           byte at the logical end of the data in the buffer at all times. 
  3375.  
  3376.  Warning: Hardware defects in some UARTs might cause erroneous functions when 
  3377.  used with the ACDI Personal Computer AT* device driver (ASYNCDDA.SYS). These 
  3378.  defects cannot be compensated for in the device driver software. These 
  3379.  problems exist in the INS 8250 and INS 8250-B asynchronous communication 
  3380.  element (UART) manufactured by National Semiconductor** and in any internal 
  3381.  modem UART that emulates these devices. However, the INS 8250-A device does 
  3382.  not have these problems and appears as an INS 16450 to the device driver. The 
  3383.  8250-A is a member of the 8250 series UARTs. 
  3384.  
  3385.  The following defects are known to exist: 
  3386.  
  3387.  o The 8250 and 8250-B UARTs might transmit bad data when configured for 5 data 
  3388.    bits and 1.5 stop bits. Although rarely used, this combination is not 
  3389.    prohibited, and the data sent by these UARTs might not be valid with this 
  3390.    setting. 
  3391.  
  3392.  o The 8250 and 8250-B UARTs occasionally drop received characters without 
  3393.    posting the receive overrun error flag. ACDI device drivers cannot detect 
  3394.    data loss due to this hardware deficiency. To ensure accurate data, your 
  3395.    application should implement error detection and correction protocols when 
  3396.    using the 8250 and 8250-B UARTs. 
  3397.  
  3398.  o The 8250 and 8250-B UARTs can transmit a single random character at 
  3399.    power-on. The connected device (DCE) should not be expecting valid data from 
  3400.    the DTE until data terminal ready (DTR) has been raised by ACDI. 
  3401.  
  3402.  
  3403. ΓòÉΓòÉΓòÉ 7.12. ComReadCharString (X'18') ΓòÉΓòÉΓòÉ
  3404.  
  3405. ComReadCharString (X'18') 
  3406.  
  3407.           This verb reads a character string and frees space previously 
  3408.           occupied by input data. 
  3409.  
  3410.  Prerequisite Calls 
  3411.  
  3412.           ComOpen 
  3413.           ComConnect (must be connected or auto-dial connection pending) 
  3414.           ComDefInput 
  3415.  
  3416.  Verb Control Block Format 
  3417.  
  3418.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  3419.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  3420.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3421.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  3422.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3423.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  3424.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3425.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  3426.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3427.                     Γöé BYTESFREED        Γöé    X    Γöé       Γöé      Word      Γöé
  3428.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3429.                     Γöé READBYTESNEEDED     Γöé    X    Γöé       Γöé      Word      Γöé
  3430.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3431.                     Γöé INITIALWAIT       Γöé    X    Γöé       Γöé      Word      Γöé
  3432.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3433.                     Γöé NEXTAVAILREADPTR     Γöé       Γöé    X    Γöé  Doubleword Address  Γöé
  3434.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3435.                     Γöé NEXTAVAILREADLGTH    Γöé       Γöé    X    Γöé      Word      Γöé
  3436.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3437.                     Γöé READERRORMASK      Γöé       Γöé    X    Γöé      Byte      Γöé
  3438.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3439.  
  3440.  Supplied Parameters 
  3441.  
  3442.           FunctionCode 
  3443.                     Defines the function to be performed. Must be X'18'. 
  3444.  
  3445.           Version 
  3446.                     Identifies the version of ACDI your application is written 
  3447.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  3448.  
  3449.           DeviceHandle 
  3450.                     Returned by the ComOpen verb; identifies the device to 
  3451.                     ACDI. 
  3452.  
  3453.           BytesFreed 
  3454.                     The number of characters that the application reads from 
  3455.                     the input buffer. ACDI may use this free space to queue new 
  3456.                     data. 
  3457.  
  3458.           ReadBytesNeeded 
  3459.                     Indicates that at least this many characters should be in 
  3460.                     the application input buffer before ACDI returns the verb. 
  3461.  
  3462.           InitialWait 
  3463.                     The number of seconds to wait before activating the 
  3464.                     intercharacter time-out. See ComSetTimeout (X'1D') for 
  3465.                     additional information. Values from 0 to 1952 indicate the 
  3466.                     number of seconds to wait before activating the 
  3467.                     intercharacter timer. Values from 1953 to 65534 are 
  3468.                     returned as an error. To obtain an infinite wait time, this 
  3469.                     value must be X'FFFF'. 
  3470.  
  3471.  Returned Parameters 
  3472.  
  3473.           ReturnCode 
  3474.                     Returns the completion status of the verb. 
  3475.  
  3476.                     The following values can be returned: 
  3477.  
  3478.              X'00'     Successful. 
  3479.  
  3480.              X'01'     Invalid device handle. 
  3481.  
  3482.              X'03'     No connection exists. 
  3483.  
  3484.              X'33'     Verb unblocked. 
  3485.  
  3486.              X'3A'     Verb canceled by the ComFlushInput verb. 
  3487.  
  3488.              X'3B'     Undefined input buffer. 
  3489.  
  3490.              X'3C'     Previous ComReadCharString verb still in progress. 
  3491.  
  3492.              X'52'     The parameters for bytes needed is larger than the input 
  3493.                        buffer's usable space. 
  3494.  
  3495.              X'53'     Time-out occurred while in XOFF state. 
  3496.  
  3497.              X'54'     Time-out occurred while in XON state. 
  3498.  
  3499.              X'57'     Not valid in the current input mode. 
  3500.  
  3501.              X'59'     The parameters for bytes freed is larger than the number 
  3502.                        of characters returned on the previous ComReadCharString 
  3503.                        verb. 
  3504.  
  3505.              X'62'     Invalid initial wait time. 
  3506.  
  3507.              X'F1'     Base operating system error occurred during execution. 
  3508.  
  3509.              X'F4'     Invalid version of ACDI. 
  3510.  
  3511.              X'FF'     ACDI not started. 
  3512.  
  3513.           NextAvailReadPtr 
  3514.                     Returned to the application and is the address of the next 
  3515.                     available character in the input buffer. 
  3516.  
  3517.           NextAvailReadLgth 
  3518.                     The number of bytes available in the input buffer. 
  3519.  
  3520.           ReadErrorMask 
  3521.                     A mask that defines the types of detected errors being 
  3522.                     returned to the application in this string. Detected errors 
  3523.                     are defined as follows: 
  3524.  
  3525.              Bit       Meaning 
  3526.  
  3527.              0         Parity error. 
  3528.  
  3529.                        The hardware detected a parity error. At least one 
  3530.                        parity error is contained in the data being returned. 
  3531.                        Ensure that the correct parity type has been set. See 
  3532.                        ComSetLineCtrl (X'05') for a description of setting the 
  3533.                        data parity. 
  3534.  
  3535.              1         Framing error. 
  3536.  
  3537.                        The hardware detected a framing error. At least one 
  3538.                        framing error is contained in the data being returned. 
  3539.                        Ensure that the correct number of stop bits and data 
  3540.                        bits has been set. See ComSetLineCtrl (X'05') for a 
  3541.                        description of setting the number of stop bits and data 
  3542.                        bits. 
  3543.  
  3544.              2         Overrun error. 
  3545.  
  3546.                        The hardware detected an overrun error. At least one 
  3547.                        overrun error is contained in the data being returned. 
  3548.                        An overrun error is caused by a bit rate that prevents 
  3549.                        the system from processing an arriving byte of data 
  3550.                        before a new byte arrives. Some options available to 
  3551.                        prevent this occurrence are: 
  3552.  
  3553.                 o Decreasing the bit rate. See ComSetBitRate (X'04') for a 
  3554.                   description of setting the bit rate. 
  3555.  
  3556.                 o Decreasing the number of concurrent tasks. 
  3557.  
  3558.              3         Overflow error. 
  3559.  
  3560.                        At least one overflow error is contained in the data 
  3561.                        being returned. This error occurs when the application 
  3562.                        does not remove data from the input buffer before the 
  3563.                        input buffer fills. The application should: 
  3564.  
  3565.                 o Read the buffer more often. 
  3566.  
  3567.                 o Enable automatic flow control. See Automatic Flow Control for 
  3568.                   a description of enabling automatic flow control. 
  3569.  
  3570.                 o Make the input buffer larger. See ComDefInput (X'14') for a 
  3571.                   description of redefining the input buffer. 
  3572.  
  3573.                 o Lower the bit rate. See ComSetBitRate (X'04') for a 
  3574.                   description of setting the bit rate. 
  3575.  
  3576.              4-7       Reserved byte, not 0. 
  3577.  
  3578.           For more information, see ACDI Return Codes. 
  3579.  
  3580.  Comments 
  3581.  
  3582.           This verb can generally be used only while a connection exists. For 
  3583.           auto-dial connections, this verb may be used while the connection is 
  3584.           pending. This verb must be issued when the application is in 
  3585.           character mode. 
  3586.  
  3587.           This function is a request to ACDI to free characters (BytesFreed) in 
  3588.           the input buffer and block the thread until ReadBytesNeeded data is 
  3589.           available. When ACDI returns the verb, the NextAvailReadPtr parameter 
  3590.           is set to point to all available characters, even if there are more 
  3591.           characters than the application requested. 
  3592.  
  3593.           If the connection drops or if the application issues a ComDisconnect 
  3594.           verb, any blocked read thread unblocks and returns with an error 
  3595.           condition (X'03'). 
  3596.  
  3597.           When this verb returns as a result of a ComUnblockThread verb, 
  3598.           NextAvailReadLgth and ReadErrorMask are set to 0. In addition, this 
  3599.           verb returns an error code that indicates that it was unblocked 
  3600.           before it completed execution. 
  3601.  
  3602.           If error-character substitution has been enabled and if an error is 
  3603.           detected, this function replaces the bad byte with the substitution 
  3604.           character specified with the ComSetErrorCharSub verb. See 
  3605.           ComSetErrorCharSub (X'1F') for additional information. 
  3606.  
  3607.           ACDI stops its InitialWait timer if one of the following conditions 
  3608.           becomes true: 
  3609.  
  3610.           o Time expires before receiving any data. 
  3611.  
  3612.           o At least 1 byte of data arrives or is in the input buffer when this 
  3613.             verb is received by ACDI. 
  3614.  
  3615.           o Sufficient data in the buffer satisfies the request when this verb 
  3616.             is received by ACDI. 
  3617.  
  3618.           When a time-out occurs, the NextAvailReadPtr parameter points to the 
  3619.           next available data byte in the input buffer, and the 
  3620.           NextAvailReadLgth parameter is the number of characters received 
  3621.           prior to the time-out. The ReadErrorMask parameter reflects the 
  3622.           errors in all new characters being returned to the application on 
  3623.           this ComReadCharString verb. 
  3624.  
  3625.           ACDI sets the NextAvailReadPtr parameter to the first word of the 
  3626.           buffer, immediately after the buffer has been redefined or the data 
  3627.           communication channel has been disconnected. 
  3628.  
  3629.           The amount of data that ACDI queues in the application input buffer 
  3630.           never exceeds the input buffer size minus 1 byte. ACDI reserves 1 
  3631.           byte at the logical end of the data in the buffer at all times. 
  3632.  
  3633.           Warning: Hardware defects in some UARTs might cause erroneous 
  3634.           functions when used with the ACDI Personal Computer AT device driver 
  3635.           (ASYNCDDA.SYS). These defects cannot be compensated for in the device 
  3636.           driver software. These problems exist in the INS 8250 and INS 8250-B 
  3637.           UARTs manufactured by National Semiconductor and in any internal 
  3638.           modem UART that emulates these devices. However, the INS 8250-A 
  3639.           device does not have these problems and appears as an INS 16450 to 
  3640.           the device driver. The 8250-A is a member of the 8250 series UARTs. 
  3641.  
  3642.           The following defects are known to exist: 
  3643.  
  3644.           o The 8250 and 8250-B UARTs might transmit bad data when configured 
  3645.             for 5 data bits and 1.5 stop bits. Although rarely used, this 
  3646.             combination is not prohibited, and the data sent by these UARTs 
  3647.             might not be valid with this setting. 
  3648.  
  3649.           o The 8250 and 8250-B UARTs occasionally drop the received characters 
  3650.             without posting the receive overrun error flag. ACDI device drivers 
  3651.             cannot detect data loss due to this hardware deficiency. To ensure 
  3652.             accurate data, your application should implement error detection 
  3653.             and correction protocols when using the 8250 and 8250-B UARTs. 
  3654.  
  3655.           o The 8250 and 8250-B UARTs can transmit a single random character at 
  3656.             power-on. The connected device (DCE) should not be expecting valid 
  3657.             data from the DTE until data terminal ready (DTR) has been raised 
  3658.             by ACDI. 
  3659.  
  3660.  
  3661. ΓòÉΓòÉΓòÉ 7.13. ComReadEvent (X'13') ΓòÉΓòÉΓòÉ
  3662.  
  3663. ComReadEvent (X'13') 
  3664.  
  3665.           This verb enables the communications event queue. 
  3666.  
  3667.  Prerequisite Calls 
  3668.  
  3669.           ComOpen 
  3670.  
  3671.  Verb Control Block Format 
  3672.  
  3673.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  3674.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  3675.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3676.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  3677.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3678.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  3679.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3680.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  3681.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3682.                     Γöé SEMHANDLE        Γöé    X    Γöé       Γöé    Doubleword    Γöé
  3683.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3684.                     Γöé BUFFERADDRESS      Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  3685.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3686.                     Γöé EVENTMASKS        Γöé    X    Γöé       Γöé  Doubleword Address  Γöé
  3687.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3688.  
  3689.  Supplied Parameters 
  3690.  
  3691.           FunctionCode 
  3692.                     Defines the function to be performed. Must be X'13'. 
  3693.  
  3694.           Version 
  3695.                     Identifies the version of ACDI your application is written 
  3696.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  3697.  
  3698.           DeviceHandle 
  3699.                     Returned by the ComOpen verb; identifies the device to 
  3700.                     ACDI. 
  3701.  
  3702.           SemHandle 
  3703.                     The handle of a semaphore that is used by ACDI to signal 
  3704.                     the application to examine its event structure for an event 
  3705.                     notification. 
  3706.  
  3707.           BufferAddress 
  3708.                     A far pointer to a data structure in the application's 
  3709.                     address space where the event information is placed. The 
  3710.                     data structure has the following format: 
  3711.  
  3712.              EventType1 Bits (32) 
  3713.  
  3714.              EventType2 Bits (32) 
  3715.  
  3716.              Reserved  Word 
  3717.  
  3718.           EventMasks 
  3719.                     The address of a data structure in the application's data 
  3720.                     space that consists of two doublewords, called EventMask1 
  3721.                     and EventMask2. These masks correspond to EventType1 and 
  3722.                     EventType2, respectively. A 1 in a defined bit position 
  3723.                     enables notification of the event when it occurs. 
  3724.  
  3725.                     EventType1 is defined as follows: 
  3726.  
  3727.              Bit       Meaning 
  3728.  
  3729.              0         XON received. 
  3730.  
  3731.                        This event indicates that the XON character was 
  3732.                        received. 
  3733.  
  3734.              1         XOFF received. 
  3735.  
  3736.                        This event indicates that the XOFF character was 
  3737.                        received. 
  3738.  
  3739.              2         User stopped ACDI. 
  3740.  
  3741.                        This event, when enabled, is used to notify the 
  3742.                        application that the user has stopped ACDI from the 
  3743.                        Communications Manager Main Menu. 
  3744.  
  3745.              3         Hardware overrun error occurred. 
  3746.  
  3747.                        This event occurs if the hardware queue is full when new 
  3748.                        data is received by the hardware. If the input mode is 
  3749.                        fixed- or variable-length block mode, a hardware overrun 
  3750.                        event will be generated only once per block with 
  3751.                        multiple hardware overruns. Note that in any mode a 
  3752.                        hardware overrun event may correspond to several lost 
  3753.                        characters, depending on the time elapsed before the 
  3754.                        hardware was serviced. 
  3755.  
  3756.              4         Reserved. 
  3757.  
  3758.              5         Reserved. 
  3759.  
  3760.              6         Clear to send (CTS) asserted. 
  3761.  
  3762.              7         CTS negated. 
  3763.  
  3764.                        The preceding events, CTS asserted and CTS negated, are 
  3765.                        generated when the clear to send signal changes state. 
  3766.  
  3767.              8         Carrier detect (DCD) asserted. 
  3768.  
  3769.              9         DCD negated. 
  3770.  
  3771.                        The preceding events, DCD asserted and DCD negated, are 
  3772.                        generated when the carrier detect signal changes state. 
  3773.                        It is recommended that the application issue a 
  3774.                        ComDisconnect verb when the events indicate a line drop. 
  3775.  
  3776.              10        Data set ready (DSR) asserted. 
  3777.  
  3778.              11        DSR negated. 
  3779.  
  3780.                        The preceding events, DSR asserted and DSR negated, are 
  3781.                        generated when the data set ready signal changes state. 
  3782.                        It is recommended that the application issue a 
  3783.                        ComDisconnect verb when the events indicate a line drop. 
  3784.  
  3785.              12        Break signal received. 
  3786.  
  3787.                        This event is generated when a break signal is received 
  3788.                        and recognized by the hardware. 
  3789.  
  3790.              13        Reserved. 
  3791.  
  3792.              14        Application buffer overflow occurred. 
  3793.  
  3794.                        This event occurs if the input buffer is full when data 
  3795.                        needs to be moved into it. If the input mode is a fixed- 
  3796.                        or variable-length block mode, an application buffer 
  3797.                        overflow event is generated only once per block that 
  3798.                        contains multiple buffer overflow instances. 
  3799.                        Additionally, for any input mode, the event is generated 
  3800.                        only once per logical overflow. This event also occurs 
  3801.                        when data is received and 128 blocks of data already 
  3802.                        exist in the buffer. 
  3803.  
  3804.                        Note:  ACDI maintains information for 128 blocks of data.
  3805.  
  3806.              15        Data connection lost. 
  3807.  
  3808.                        This event occurs when ACDI determines that the data 
  3809.                        connection with the session partner is lost. The 
  3810.                        application should issue a ComDisconnect verb when 
  3811.                        notified of this event. 
  3812.  
  3813.              16-30     Reserved. 
  3814.  
  3815.              31        Event queue overrun occurred. 
  3816.  
  3817.                        ACDI maintains an internal event queue for each device 
  3818.                        opened through the ComOpen verb. Events are queued in 
  3819.                        this structure until the application is notified. This 
  3820.                        event is generated if events could not be queued 
  3821.                        properly and a queue overrun has occurred. The 
  3822.                        application is notified of this event before it is 
  3823.                        notified of any other events. 
  3824.  
  3825.                     EventType2 is reserved. 
  3826.  
  3827.  Returned Parameters 
  3828.  
  3829.           ReturnCode 
  3830.                     Returns the completion status of the verb. 
  3831.  
  3832.                     The following values can be returned: 
  3833.  
  3834.              X'00'     Successful. 
  3835.  
  3836.              X'01'     Invalid device handle. 
  3837.  
  3838.              X'02'     Invalid parameter address. 
  3839.  
  3840.              X'44'     Invalid semaphore handle. 
  3841.  
  3842.              X'F1'     Base operating system error occurred during execution. 
  3843.  
  3844.              X'F4'     Invalid version of ACDI. 
  3845.  
  3846.              X'FF'     ACDI not started. 
  3847.  
  3848.           For more information, see ACDI Return Codes. 
  3849.  
  3850.  Comments 
  3851.  
  3852.           An application initiates a request for event notification by calling 
  3853.           the ComReadEvent verb once. It then receives notification of events 
  3854.           by setting its semaphore and waiting for it to be cleared through the 
  3855.           DosSemSetWait verb of the base operating system. 
  3856.  
  3857.           When an event occurs, ACDI examines the semaphore to see if it has 
  3858.           been set. If the semaphore is set, ACDI sets the appropriate bit in 
  3859.           the applications event structure and clears the semaphore. Otherwise, 
  3860.           ACDI queues this event and waits for the application to set the 
  3861.           semaphore. 
  3862.  
  3863.           Each time the semaphore is cleared by ACDI, the application should 
  3864.           read the event information from the event structure, reset the 
  3865.           semaphore, and wait for the semaphore to be cleared. 
  3866.  
  3867.           To terminate event notification, the application issues a 
  3868.           ComReadEvent verb with the two masks (EventMask1 and EventMask2) set 
  3869.           to 0. 
  3870.  
  3871.           Only a single ComReadEvent verb is active at any time. 
  3872.  
  3873.           When a ComReadEvent verb is issued and a previous ComReadEvent verb 
  3874.           is still in effect, the data buffer address and the semaphore handle 
  3875.           of the newest ComReadEvent verb is used. 
  3876.  
  3877.           Warning: The 8250 and 8250-B UARTs occasionally drop the received 
  3878.           characters without posting the Receive Overrun error flag. ACDI 
  3879.           device drivers cannot detect data loss due to this hardware 
  3880.           deficiency. 
  3881.  
  3882.  
  3883. ΓòÉΓòÉΓòÉ 7.14. ComRetBitRate (X'06') ΓòÉΓòÉΓòÉ
  3884.  
  3885. ComRetBitRate (X'06') 
  3886.  
  3887.           This verb returns the bit rate for which the asynchronous 
  3888.           communications hardware is programmed. 
  3889.  
  3890.  Prerequisite Calls 
  3891.  
  3892.           ComOpen 
  3893.  
  3894.  Verb Control Block Format 
  3895.  
  3896.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  3897.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  3898.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3899.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  3900.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3901.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  3902.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3903.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  3904.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3905.                     Γöé BITRATERCV        Γöé       Γöé    X    Γöé      Word      Γöé
  3906.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3907.                     Γöé BITRATESEND       Γöé       Γöé    X    Γöé      Word      Γöé
  3908.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3909.  
  3910.  Supplied Parameters 
  3911.  
  3912.           FunctionCode 
  3913.                     Defines the function to be performed. Must be X'06'. 
  3914.  
  3915.           Version 
  3916.                     Identifies the version of ACDI your application is written 
  3917.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  3918.  
  3919.           DeviceHandle 
  3920.                     Returned by the ComOpen verb; identifies the device to 
  3921.                     ACDI. 
  3922.  
  3923.  Returned Parameters 
  3924.  
  3925.           ReturnCode 
  3926.                     Returns the completion status of the verb. 
  3927.  
  3928.                     The following values can be returned: 
  3929.  
  3930.              X'00'     Successful. 
  3931.  
  3932.              X'01'     Invalid device handle. 
  3933.  
  3934.              X'F1'     Base operating system error occurred during execution. 
  3935.  
  3936.              X'F4'     Invalid version of ACDI. 
  3937.  
  3938.              X'FF'     ACDI not started. 
  3939.  
  3940.           BitRateRcv 
  3941.                     The receive bits per second (bps) value at which the 
  3942.                     asynchronous receiver operates. 
  3943.  
  3944.           BitRateSend 
  3945.                     The transmit bits per second (bps) value at which the 
  3946.                     asynchronous transmitter operates. 
  3947.  
  3948.           For more information, see ACDI Return Codes. 
  3949.  
  3950.  Comments 
  3951.  
  3952.           If your application has not issued the ComSetBitRate verb, this verb 
  3953.           returns the default bit rate in both the BitRateRcv and BitRateSend 
  3954.           parameters. The default speed is 1200 bps. 
  3955.  
  3956.           The ComRetBitRate verb returns values as set by the the ComSetBitRate 
  3957.           verb. 
  3958.  
  3959.           Note:  The return values may be different from the values set by your 
  3960.                  application, since some asynchronous communications hardware 
  3961.                  adjusts the bit rate for the communications environment.
  3962.  
  3963.  
  3964. ΓòÉΓòÉΓòÉ 7.15. ComRetErrorCharSub (X'20') ΓòÉΓòÉΓòÉ
  3965.  
  3966. ComRetErrorCharSub (X'20') 
  3967.  
  3968.           This verb returns the current error-character substitution and mode. 
  3969.  
  3970.  Prerequisite Calls 
  3971.  
  3972.           ComOpen 
  3973.  
  3974.  Verb Control Block Format 
  3975.  
  3976.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  3977.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  3978.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3979.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  3980.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3981.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  3982.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3983.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  3984.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3985.                     Γöé ERRORCHAR        Γöé       Γöé    X    Γöé      Byte      Γöé
  3986.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3987.                     Γöé MODE           Γöé       Γöé    X    Γöé      Byte      Γöé
  3988.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3989.  
  3990.  Supplied Parameters 
  3991.  
  3992.           FunctionCode 
  3993.                     Defines the function to be performed. Must be X'20'. 
  3994.  
  3995.           Version 
  3996.                     Identifies the version of ACDI your application is written 
  3997.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  3998.  
  3999.           DeviceHandle 
  4000.                     Returned by the ComOpen verb; identifies the device to 
  4001.                     ACDI. 
  4002.  
  4003.  Returned Parameters 
  4004.  
  4005.           ReturnCode 
  4006.                     Returns the completion status of the verb. 
  4007.  
  4008.                     The following values can be returned: 
  4009.  
  4010.              X'00'     Successful. 
  4011.  
  4012.              X'01'     Invalid device handle. 
  4013.  
  4014.              X'F1'     Base operating system error occurred during execution. 
  4015.  
  4016.              X'F4'     Invalid version of ACDI. 
  4017.  
  4018.              X'FF'     ACDI not started. 
  4019.  
  4020.           ErrorChar 
  4021.                     The character to be substituted for invalid data when 
  4022.                     parity, framing, hardware overrun, or application buffer 
  4023.                     overflow errors are detected. 
  4024.  
  4025.           Mode 
  4026.                     An integer that specifies whether substitution is enabled 
  4027.                     (1) or disabled (0). 
  4028.  
  4029.           For more information, see ACDI Return Codes. 
  4030.  
  4031.  Comments 
  4032.  
  4033.           See ComSetErrorCharSub (X'1F') for a description of the default 
  4034.           settings and error-character substitution. 
  4035.  
  4036.  
  4037. ΓòÉΓòÉΓòÉ 7.16. ComRetFlowChar (X'0E') ΓòÉΓòÉΓòÉ
  4038.  
  4039. ComRetFlowChar (X'0E') 
  4040.  
  4041.           This verb returns flow control XOFF and XON characters. 
  4042.  
  4043.  Prerequisite Calls 
  4044.  
  4045.           ComOpen 
  4046.  
  4047.  Verb Control Block Format 
  4048.  
  4049.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4050.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4051.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4052.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4053.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4054.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4055.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4056.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4057.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4058.                     Γöé XONCHAR         Γöé       Γöé    X    Γöé      Byte      Γöé
  4059.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4060.                     Γöé RESERVED         Γöé    X    Γöé       Γöé      Byte      Γöé
  4061.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4062.                     Γöé XOFFCHAR         Γöé       Γöé    X    Γöé      Byte      Γöé
  4063.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4064.                     Γöé RESERVED         Γöé    X    Γöé       Γöé      Byte      Γöé
  4065.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4066.  
  4067.  Supplied Parameters 
  4068.  
  4069.           FunctionCode 
  4070.                     Defines the function to be performed. Must be X'0E'. 
  4071.  
  4072.           Version 
  4073.                     Identifies the version of ACDI your application is written 
  4074.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4075.  
  4076.           DeviceHandle 
  4077.                     Returned by the ComOpen verb; identifies the device to 
  4078.                     ACDI. 
  4079.  
  4080.  Returned Parameters 
  4081.  
  4082.           ReturnCode 
  4083.                     Returns the completion status of the verb. 
  4084.  
  4085.                     The following values can be returned: 
  4086.  
  4087.              X'00'     Successful. 
  4088.  
  4089.              X'01'     Invalid device handle. 
  4090.  
  4091.              X'F1'     Base operating system error occurred during execution. 
  4092.  
  4093.              X'F4'     Invalid version of ACDI. 
  4094.  
  4095.              X'FF'     ACDI not started. 
  4096.  
  4097.           XOnChar 
  4098.                     The XON character. 
  4099.  
  4100.           XOffChar 
  4101.                     The XOFF character. 
  4102.  
  4103.           For more information, see ACDI Return Codes. 
  4104.  
  4105.  Comments 
  4106.  
  4107.           The current values for the flow control characters are returned. See 
  4108.           ComSetFlowChar (X'0B') for the definition of the parameters and 
  4109.           processing. 
  4110.  
  4111.           If an application has not previously issued the ComSetFlowChar verb 
  4112.           to change the flow control characters, the following defaults are 
  4113.           returned: 
  4114.  
  4115.           ACDI returns values even if the application has not enabled automatic 
  4116.           flow control. ACDI uses these returned values to detect XON and XOFF 
  4117.           characters in the incoming data to generate communications events. 
  4118.  
  4119.  
  4120. ΓòÉΓòÉΓòÉ 7.17. ComRetFlowMode (X'0F') ΓòÉΓòÉΓòÉ
  4121.  
  4122. ComRetFlowMode (X'0F') 
  4123.  
  4124.           This verb returns information specifying whether automatic flow 
  4125.           control is enabled. 
  4126.  
  4127.  Prerequisite Calls 
  4128.  
  4129.           ComOpen 
  4130.  
  4131.  Verb Control Block Format 
  4132.  
  4133.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4134.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4135.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4136.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4137.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4138.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4139.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4140.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4141.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4142.                     Γöé FLOWMODE         Γöé       Γöé    X    Γöé      Word      Γöé
  4143.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4144.  
  4145.  Supplied Parameters 
  4146.  
  4147.           FunctionCode 
  4148.                     Defines the function to be performed. Must be X'0F'. 
  4149.  
  4150.           Version 
  4151.                     Identifies the version of ACDI your application is written 
  4152.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4153.  
  4154.           DeviceHandle 
  4155.                     Returned by the ComOpen verb; identifies the device to 
  4156.                     ACDI. 
  4157.  
  4158.  Returned Parameters 
  4159.  
  4160.           ReturnCode 
  4161.                     Returns the completion status of the verb. 
  4162.  
  4163.                     The following values can be returned: 
  4164.  
  4165.              X'00'     Successful. 
  4166.  
  4167.              X'01'     Invalid device handle. 
  4168.  
  4169.              X'F1'     Base operating system error occurred during execution. 
  4170.  
  4171.              X'F4'     Invalid version of ACDI. 
  4172.  
  4173.              X'FF'     ACDI not started. 
  4174.  
  4175.           FlowMode 
  4176.                     The following identifies the flow control mode: 
  4177.  
  4178.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4179.                     Γöé MODE        Γöé FLOW CONTROL    Γöé DELETE XON     Γöé DELETE XOFF    Γöé
  4180.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4181.                     Γöé 0         Γöé Off        Γöé No         Γöé No        Γöé
  4182.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4183.                     Γöé 7         Γöé On         Γöé Yes        Γöé Yes        Γöé
  4184.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4185.  
  4186.           FlowMode=0 is the default (when automatic flow control is off), and 
  4187.           both the XON and XOFF characters are left in the data stream when 
  4188.           received. 
  4189.  
  4190.           Note:  When using the default choice, there is no requirement that 
  4191.                  buffer levels must have been previously specified since none 
  4192.                  are used. 
  4193.  
  4194.           See ComSetFlowThresh (X'0D') for additional information. 
  4195.  
  4196.  Comments 
  4197.  
  4198.           When automatic flow control is enabled, XON and XOFF characters are 
  4199.           consumed by ACDI and are not placed into the application input 
  4200.           buffer. 
  4201.  
  4202.           Applications that do not use automatic flow control often implement 
  4203.           their own flow control at the application level (for example, 
  4204.           implementations of frame-level protocols). 
  4205.  
  4206.           Note:  Frame-level protocols may use flow control packets instead of 
  4207.                  flow control characters.
  4208.  
  4209.  
  4210. ΓòÉΓòÉΓòÉ 7.18. ComRetFlowThresh (X'10') ΓòÉΓòÉΓòÉ
  4211.  
  4212. ComRetFlowThresh (X'10') 
  4213.  
  4214.           This verb returns flow control threshold levels for the application 
  4215.           input buffer. 
  4216.  
  4217.  Prerequisite Calls 
  4218.  
  4219.           ComOpen 
  4220.           ComDefInput 
  4221.  
  4222.  Verb Control Block Format 
  4223.  
  4224.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4225.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4226.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4227.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4228.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4229.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4230.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4231.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4232.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4233.                     Γöé XOFFBUFFLEVEL      Γöé       Γöé    X    Γöé      Word      Γöé
  4234.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4235.                     Γöé XONBUFFLEVEL       Γöé       Γöé    X    Γöé      Word      Γöé
  4236.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4237.  
  4238.  Supplied Parameters 
  4239.  
  4240.           FunctionCode 
  4241.                     Defines the function to be performed. Must be X'10'. 
  4242.  
  4243.           Version 
  4244.                     Identifies the version of ACDI your application is written 
  4245.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4246.  
  4247.           DeviceHandle 
  4248.                     Returned by the ComOpen verb; identifies the device to 
  4249.                     ACDI. 
  4250.  
  4251.  Returned Parameters 
  4252.  
  4253.           ReturnCode 
  4254.                     Returns the completion status of the verb. 
  4255.  
  4256.                     The following values can be returned: 
  4257.  
  4258.              X'00'     Successful. 
  4259.  
  4260.              X'01'     Invalid device handle. 
  4261.  
  4262.              X'3B'     Undefined input buffer. 
  4263.  
  4264.              X'F1'     Base operating system error occurred during execution. 
  4265.  
  4266.              X'F4'     Invalid version of ACDI. 
  4267.  
  4268.              X'FF'     ACDI not started. 
  4269.  
  4270.           XOffBuffLevel 
  4271.                     The amount of free space in the application input buffer 
  4272.                     where the XOFF character is sent. It is an unsigned 
  4273.                     integer. 
  4274.  
  4275.           XOnBuffLevel 
  4276.                     The amount of free space in the application input buffer 
  4277.                     where the XON is sent. It is an unsigned integer. 
  4278.  
  4279.           For more information, see ACDI Return Codes. 
  4280.  
  4281.  Comments 
  4282.  
  4283.           See ComSetFlowThresh (X'0D') for a description of flow control 
  4284.           threshold levels. 
  4285.  
  4286.           If an application has not issued the ComSetFlowThresh verb, ACDI 
  4287.           returns the default threshold levels that were calculated when the 
  4288.           application defined its input buffer with the ComDefInput verb. 
  4289.  
  4290.           The default XON threshold level is calculated as 80% of the 
  4291.           application buffer size. The default XOFF buffer length is calculated 
  4292.           as 20% of the application buffer size. 
  4293.  
  4294.  
  4295. ΓòÉΓòÉΓòÉ 7.19. ComRetLineCtrl (X'07') ΓòÉΓòÉΓòÉ
  4296.  
  4297. ComRetLineCtrl (X'07') 
  4298.  
  4299.           This verb returns the current line control values for which the 
  4300.           asynchronous receiver/transmitter hardware is programmed. 
  4301.  
  4302.  Prerequisite Calls 
  4303.  
  4304.           ComOpen 
  4305.  
  4306.  Verb Control Block Format 
  4307.  
  4308.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4309.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4310.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4311.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4312.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4313.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4314.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4315.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4316.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4317.                     Γöé STOPBITS         Γöé       Γöé    X    Γöé      Word      Γöé
  4318.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4319.                     Γöé PARITY          Γöé       Γöé    X    Γöé      Word      Γöé
  4320.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4321.                     Γöé DATABITS         Γöé       Γöé    X    Γöé      Word      Γöé
  4322.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4323.  
  4324.  Supplied Parameters 
  4325.  
  4326.           FunctionCode 
  4327.                     Defines the function to be performed. Must be X'07'. 
  4328.  
  4329.           Version 
  4330.                     Identifies the version of ACDI your application is written 
  4331.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4332.  
  4333.           DeviceHandle 
  4334.                     Returned by the ComOpen verb; identifies the device to 
  4335.                     ACDI. 
  4336.  
  4337.  Returned Parameters 
  4338.  
  4339.           ReturnCode 
  4340.                     Returns the completion status of the verb. 
  4341.  
  4342.                     The following values can be returned: 
  4343.  
  4344.              X'00'     Successful. 
  4345.  
  4346.              X'01'     Invalid device handle. 
  4347.  
  4348.              X'F1'     Base operating system error occurred during execution. 
  4349.  
  4350.              X'F4'     Invalid version of ACDI. 
  4351.  
  4352.              X'FF'     ACDI not started. 
  4353.  
  4354.           StopBits 
  4355.                     Indicates the number of stop bits used by the asynchronous 
  4356.                     communications hardware for transmitting and receiving 
  4357.                     data. 
  4358.  
  4359.           Parity 
  4360.                     Indicates the parity used by the asynchronous 
  4361.                     communications hardware for transmitting and receiving 
  4362.                     data. 
  4363.  
  4364.           DataBits 
  4365.                     Indicates the number of data bits used by the asynchronous 
  4366.                     communications hardware for transmitting and receiving 
  4367.                     data. 
  4368.  
  4369.           For more information, see ACDI Return Codes. 
  4370.  
  4371.  Comments 
  4372.  
  4373.           See ComSetLineCtrl (X'05') for a description of the values that are 
  4374.           returned for stop bits, parity, and data bits. 
  4375.  
  4376.           If the application has not issued the ComSetLineCtrl verb, this verb 
  4377.           returns the default line control parameters (1 stop bit, even parity, 
  4378.           and 7 data bits). 
  4379.  
  4380.  
  4381. ΓòÉΓòÉΓòÉ 7.20. ComRetTimeout (X'1E') ΓòÉΓòÉΓòÉ
  4382.  
  4383. ComRetTimeout (X'1E') 
  4384.  
  4385.           This verb returns time-out values for the ComReadCharString, 
  4386.           ComReadBlock, and ComWriteCharString verbs. 
  4387.  
  4388.  Prerequisite Calls 
  4389.  
  4390.           ComOpen 
  4391.  
  4392.  Verb Control Block Format 
  4393.  
  4394.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4395.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4396.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4397.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4398.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4399.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4400.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4401.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4402.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4403.                     Γöé READTIMEOUTBLOCK     Γöé       Γöé    X    Γöé      Word      Γöé
  4404.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4405.                     Γöé READTIMEOUTCHAR     Γöé       Γöé    X    Γöé      Word      Γöé
  4406.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4407.                     Γöé WRITETIMEOUT       Γöé       Γöé    X    Γöé      Word      Γöé
  4408.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4409.  
  4410.  Supplied Parameters 
  4411.  
  4412.           FunctionCode 
  4413.                     Defines the function to be performed. 
  4414.  
  4415.           Version 
  4416.                     Identifies the version of ACDI your application is written 
  4417.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4418.  
  4419.           DeviceHandle 
  4420.                     Returned by the ComOpen verb; identifies the device to 
  4421.                     ACDI. 
  4422.  
  4423.  Returned Parameters 
  4424.  
  4425.           ReturnCode 
  4426.                     Returns the completion status of the verb. 
  4427.  
  4428.                     The following values can be returned: 
  4429.  
  4430.              X'00'     Successful. 
  4431.  
  4432.              X'01'     Invalid device handle. 
  4433.  
  4434.              X'F1'     Base operating system error occurred during execution. 
  4435.  
  4436.              X'F4'     Invalid version of ACDI. 
  4437.  
  4438.              X'FF'     ACDI not started. 
  4439.  
  4440.           ReadTimeoutBlock 
  4441.                     Time-out value used for timing the ComReadBlock verb. 
  4442.  
  4443.           ReadTimeoutChar 
  4444.                     Time-out value used for timing the ComReadCharString verb. 
  4445.  
  4446.           WriteTimeout 
  4447.                     Time-out value used for timing the ComWriteCharString verb. 
  4448.  
  4449.           For more information, see ACDI Return Codes. 
  4450.  
  4451.  Comments 
  4452.  
  4453.           This call can be made regardless of whether a data connection exists. 
  4454.           See ComSetTimeout (X'1D') for a description of the time-out 
  4455.           parameters and additional information. 
  4456.  
  4457.  
  4458. ΓòÉΓòÉΓòÉ 7.21. ComSendBreak (X'11') ΓòÉΓòÉΓòÉ
  4459.  
  4460. ComSendBreak (X'11') 
  4461.  
  4462.           This verb sends a break signal for the user-specified duration. 
  4463.  
  4464.  Prerequisite Calls 
  4465.  
  4466.           ComOpen 
  4467.           ComConnect (must be connected) 
  4468.  
  4469.  Verb Control Block Format 
  4470.  
  4471.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4472.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4473.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4474.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4475.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4476.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4477.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4478.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4479.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4480.                     Γöé MINDURATION       Γöé    X    Γöé       Γöé      Word      Γöé
  4481.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4482.  
  4483.  Supplied Parameters 
  4484.  
  4485.           FunctionCode 
  4486.                     Defines the function to be performed. Must be X'11'. 
  4487.  
  4488.           Version 
  4489.                     Identifies the version of ACDI your application is written 
  4490.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4491.  
  4492.           DeviceHandle 
  4493.                     Returned by the ComOpen verb; identifies the device to 
  4494.                     ACDI. 
  4495.  
  4496.           MinDuration 
  4497.                     Duration of break signal expressed as an integer specifying 
  4498.                     50-millisecond units. 
  4499.  
  4500.  Returned Parameters 
  4501.  
  4502.           ReturnCode 
  4503.                     Returns the completion status of the verb. 
  4504.  
  4505.                     The following values can be returned: 
  4506.  
  4507.              X'00'     Successful. 
  4508.  
  4509.              X'01'     Invalid device handle. 
  4510.  
  4511.              X'03'     No connection exists. 
  4512.  
  4513.              X'40'     Invalid duration. 
  4514.  
  4515.              X'F1'     Base operating system error occurred during execution. 
  4516.  
  4517.              X'F4'     Invalid version of ACDI. 
  4518.  
  4519.              X'FF'     ACDI not started. 
  4520.  
  4521.           For more information, see ACDI Return Codes. 
  4522.  
  4523.  Comments 
  4524.  
  4525.           This function should be issued only when a connection has been 
  4526.           established. This verb instructs ACDI to generate a break signal. The 
  4527.           break signal is issued for the duration specified and is generated 
  4528.           immediately, even if transmission is currently suspended because of 
  4529.           XOFF. 
  4530.  
  4531.           The minimum value is 1 (50 milliseconds) and the maximum value is 255 
  4532.           (in multiples of 50 milliseconds). This value is rounded up by ACDI 
  4533.           to the smallest integer multiple of the interrupt clock period (for 
  4534.           the particular machine that is running the program) that is larger 
  4535.           than the time indicated. 
  4536.  
  4537.  
  4538. ΓòÉΓòÉΓòÉ 7.22. ComSetBitRate (X'04') ΓòÉΓòÉΓòÉ
  4539.  
  4540. ComSetBitRate (X'04') 
  4541.  
  4542.           This verb sets the bit rate of the asynchronous receiver/transmitter 
  4543.           on the asynchronous communications hardware. 
  4544.  
  4545.  Prerequisite Calls 
  4546.  
  4547.           ComOpen 
  4548.  
  4549.  Verb Control Block Format 
  4550.  
  4551.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4552.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4553.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4554.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4555.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4556.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4557.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4558.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4559.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4560.                     Γöé BITRATERCV        Γöé    X    Γöé       Γöé      Word      Γöé
  4561.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4562.                     Γöé BITRATESEND       Γöé    X    Γöé       Γöé      Word      Γöé
  4563.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4564.  
  4565.  Supplied Parameters 
  4566.  
  4567.           FunctionCode 
  4568.                     Defines the function to be performed. Must be X'04'. 
  4569.  
  4570.           Version 
  4571.                     Identifies the version of ACDI your application is written 
  4572.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4573.  
  4574.           DeviceHandle 
  4575.                     Returned by the ComOpen verb; identifies the device to 
  4576.                     ACDI. 
  4577.  
  4578.           BitRateRcv 
  4579.                     The receive bits per second (bps) value at which the 
  4580.                     asynchronous receiver operates. 
  4581.  
  4582.           BitRateSend 
  4583.                     The transmit bits per second (bps) value at which the 
  4584.                     asynchronous transmitter operates. 
  4585.  
  4586.                     The following values for bit rate correspond to the maximum 
  4587.                     bit rates that ACDI will program on the asynchronous 
  4588.                     receiver/transmitter or the asynchronous adapter hardware: 
  4589.  
  4590.              X'0001'   50 bps 
  4591.  
  4592.              X'0002'   75 bps 
  4593.  
  4594.              X'0003'   110 bps 
  4595.  
  4596.              X'0004'   134.5 bps 
  4597.  
  4598.              X'0005'   150 bps 
  4599.  
  4600.              X'0006'   200 bps 
  4601.  
  4602.              X'0007'   300 bps 
  4603.  
  4604.              X'0008'   600 bps 
  4605.  
  4606.              X'0009'   1200 bps 
  4607.  
  4608.              X'000A'   1800 bps 
  4609.  
  4610.              X'000B'   2000 bps 
  4611.  
  4612.              X'000C'   2400 bps 
  4613.  
  4614.              X'000D'   3600 bps 
  4615.  
  4616.              X'000E'   4800 bps 
  4617.  
  4618.              X'000F'   7200 bps 
  4619.  
  4620.              X'0010'   9600 bps 
  4621.  
  4622.              X'0011'   19200 bps 
  4623.  
  4624.              X'0012'   38400 bps 
  4625.  
  4626.              X'0013'   48000 bps 
  4627.  
  4628.              X'0014'   56000 bps 
  4629.  
  4630.              X'0015'   57600 bps 
  4631.  
  4632.              X'0016'   64000 bps 
  4633.  
  4634.  Returned Parameters 
  4635.  
  4636.           ReturnCode 
  4637.                     Returns the completion status of the verb. 
  4638.  
  4639.                     The following values can be returned: 
  4640.  
  4641.              X'00'     Successful. 
  4642.  
  4643.              X'01'     Invalid device handle. 
  4644.  
  4645.              X'14'     Bit rate not supported. 
  4646.  
  4647.              X'17'     Undefined bit rate. 
  4648.  
  4649.              X'2A'     Transmit and receive speeds must be identical. 
  4650.  
  4651.              X'F1'     Base operating system error occurred during execution. 
  4652.  
  4653.              X'F4'     Invalid version of ACDI. 
  4654.  
  4655.              X'FF'     ACDI not started. 
  4656.  
  4657.           For more information, see ACDI Return Codes. 
  4658.  
  4659.  Comments 
  4660.  
  4661.           Speeds other than those shown for ComSetBitRate are unsupported, and 
  4662.           you receive a return code X'17' (undefined bit rate). The 
  4663.           ComSetBitRate verb supports line speeds up to 64K bps. Dissimilar 
  4664.           transmit and receive speeds are supported only if one speed is 
  4665.           exactly 16 times faster than the other speed. If a device cannot 
  4666.           support dissimilar transmit and receive speeds, a return code 
  4667.           (transmit and receive speed must be the same for this device) is 
  4668.           returned. 
  4669.  
  4670.           A default bit rate or line speed of 1200 bps is set when a 
  4671.           communication port is opened. If a device cannot support the rate 
  4672.           requested, ACDI does not default to another rate. An error condition 
  4673.           is returned by ACDI. 
  4674.  
  4675.           Setting the bit rate is a function different from the other line 
  4676.           characteristics since most devices cannot change this rate once a 
  4677.           data connection is established. This command is generally issued 
  4678.           prior to establishing data connection. The device driver issues an 
  4679.           error if it cannot change the bit rate when the call is issued. 
  4680.  
  4681.           Support of a specific line speed is dependent on the device driver 
  4682.           that is installed at the time. If the installed device driver does 
  4683.           not support a speed previously listed, a return code (undefined bit 
  4684.           rate) is returned. 
  4685.  
  4686.           If you specify X'00' or X'01' in the Version parameter, all bit rates 
  4687.           up to and including 9600 bps are valid. If you specify X'02' or X'03' 
  4688.           in the Version parameter, all bit rates up to and including 19200 bps 
  4689.           are valid. If you specify X'04' in the Version parameter, all bit 
  4690.           rates up to and including 64000 bps are valid. 
  4691.  
  4692.           Note:  To obtain line speeds unavailable on versions X'00', X'01', 
  4693.                  X'02', or X'03', ComSetBitRate must use version X'04'. 
  4694.  
  4695.           Use this verb to set the communications bit rate before establishing 
  4696.           a connection. If the BitRateRcv and BitRateSend parameters are the 
  4697.           same for particular hardware, the return code X'2A' is returned. 
  4698.  
  4699.           When you use adapters containing UARTs with FIFO buffers (16550A), 
  4700.           take care when changing line speeds or line control values. For 
  4701.           example, use of the ComDrainOutput verb prior to these types of 
  4702.           changes alleviates a potential overflow problem. 
  4703.  
  4704.           Note:  If you use a modem to establish a connection, see Bit Rate and 
  4705.                  Line Control Parameters for information.
  4706.  
  4707.  
  4708. ΓòÉΓòÉΓòÉ 7.23. ComSetErrorCharSub (X'1F') ΓòÉΓòÉΓòÉ
  4709.  
  4710. ComSetErrorCharSub (X'1F') 
  4711.  
  4712.           This verb sets the error-character substitution mode and error 
  4713.           substitution character. 
  4714.  
  4715.  Prerequisite Calls 
  4716.  
  4717.           ComOpen 
  4718.  
  4719.  Verb Control Block Format 
  4720.  
  4721.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4722.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4723.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4724.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4725.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4726.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4727.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4728.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4729.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4730.                     Γöé ERRORCHAR        Γöé    X    Γöé       Γöé      Byte      Γöé
  4731.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4732.                     Γöé MODE           Γöé    X    Γöé       Γöé      Byte      Γöé
  4733.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4734.  
  4735.  Supplied Parameters 
  4736.  
  4737.           FunctionCode 
  4738.                     Defines the function to be performed. Must be X'1F'. 
  4739.  
  4740.           Version 
  4741.                     Identifies the version of ACDI your application is written 
  4742.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4743.  
  4744.           DeviceHandle 
  4745.                     Returned by the ComOpen verb; identifies the device to 
  4746.                     ACDI. 
  4747.  
  4748.           ErrorChar 
  4749.                     The character to be substituted for error data when parity, 
  4750.                     framing, hardware overrun, or application buffer overflow 
  4751.                     errors occur. 
  4752.  
  4753.           Mode 
  4754.                     An integer that specifies whether error-character 
  4755.                     substitution is enabled or disabled. A value of 0 enables 
  4756.                     substitution. Any other value disables error-character 
  4757.                     substitution. 
  4758.  
  4759.  Returned Parameters 
  4760.  
  4761.           ReturnCode 
  4762.                     Returns the completion status of the verb. 
  4763.  
  4764.                     The following values can be returned: 
  4765.  
  4766.              X'00'     Successful. 
  4767.  
  4768.              X'01'     Invalid device handle. 
  4769.  
  4770.              X'F1'     Base operating system error occurred during execution. 
  4771.  
  4772.              X'F4'     Invalid version of ACDI. 
  4773.  
  4774.              X'FF'     ACDI not started. 
  4775.  
  4776.           For more information, see ACDI Return Codes. 
  4777.  
  4778.  Comments 
  4779.  
  4780.           When error-character substitution is enabled, ACDI replaces an 
  4781.           incoming character that has a parity or framing error with the error 
  4782.           substitution character. 
  4783.  
  4784.           Also, when a hardware overrun error occurs, ACDI inserts the error 
  4785.           substitution character in the input buffer to mark the spot where a 
  4786.           character or characters were lost. 
  4787.  
  4788.           If the application input buffer overflows, ACDI replaces the last 
  4789.           character received in the buffer with the error substitution 
  4790.           character. 
  4791.  
  4792.           If ComSetErrorCharSub has never been called, error-character 
  4793.           substitution is disabled. 
  4794.  
  4795.  
  4796. ΓòÉΓòÉΓòÉ 7.24. ComSetFlowChar (X'0B') ΓòÉΓòÉΓòÉ
  4797.  
  4798. ComSetFlowChar (X'0B') 
  4799.  
  4800.           This verb sets flow control (XON and XOFF) characters. 
  4801.  
  4802.  Prerequisite Calls 
  4803.  
  4804.           ComOpen 
  4805.  
  4806.  Verb Control Block Format 
  4807.  
  4808.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4809.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4810.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4811.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4812.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4813.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4814.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4815.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4816.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4817.                     Γöé XONCHAR         Γöé    X    Γöé       Γöé      Byte      Γöé
  4818.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4819.                     Γöé RESERVED         Γöé    X    Γöé       Γöé      Byte      Γöé
  4820.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4821.                     Γöé XOFFCHAR         Γöé    X    Γöé       Γöé      Byte      Γöé
  4822.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4823.                     Γöé RESERVED         Γöé    X    Γöé       Γöé      Byte      Γöé
  4824.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4825.  
  4826.  Supplied Parameters 
  4827.  
  4828.           FunctionCode 
  4829.                     Defines the function to be performed. Must be X'0B'. 
  4830.  
  4831.           Version 
  4832.                     Identifies the version of ACDI your application is written 
  4833.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4834.  
  4835.           DeviceHandle 
  4836.                     Returned by the ComOpen verb; identifies the device to 
  4837.                     ACDI. 
  4838.  
  4839.           XOnChar 
  4840.                     The XON character. 
  4841.  
  4842.           XOffChar 
  4843.                     The XOFF character. 
  4844.  
  4845.  Returned Parameters 
  4846.  
  4847.           ReturnCode 
  4848.                     Returns the completion status of the verb. 
  4849.  
  4850.                     The following values can be returned: 
  4851.  
  4852.              X'00'     Successful. 
  4853.  
  4854.              X'01'     Invalid device handle. 
  4855.  
  4856.              X'F1'     Base operating system error occurred during execution. 
  4857.  
  4858.              X'F4'     Invalid version of ACDI. 
  4859.  
  4860.              X'FF'     ACDI not started. 
  4861.  
  4862.           For more information, see ACDI Return Codes. 
  4863.  
  4864.  Comments 
  4865.  
  4866.           This verb can be issued to change the XON and XOFF characters that 
  4867.           ACDI uses for automatic flow control. See Flow Control for a 
  4868.           description of how ACDI manages flow control for an application. 
  4869.  
  4870.           The current line control parameters set on the asynchronous 
  4871.           communications hardware affect both the XON and XOFF characters. 
  4872.  
  4873.           For example, if you have programmed the asynchronous communications 
  4874.           hardware for 7 data bits, only the lower 7 data bits of your XOFF 
  4875.           character are sent when ACDI recognizes that an XOFF needs to be 
  4876.           sent. 
  4877.  
  4878.           The default values for the flow control characters are: 
  4879.  
  4880.  
  4881. ΓòÉΓòÉΓòÉ 7.25. ComSetFlowMode (X'0C') ΓòÉΓòÉΓòÉ
  4882.  
  4883. ComSetFlowMode (X'0C') 
  4884.  
  4885.           This verb sets the flow control (XON and XOFF) mode. 
  4886.  
  4887.  Prerequisite Calls 
  4888.  
  4889.           ComOpen 
  4890.  
  4891.  Verb Control Block Format 
  4892.  
  4893.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4894.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4895.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4896.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4897.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4898.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4899.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4900.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  4901.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4902.                     Γöé FLOWMODE         Γöé    X    Γöé       Γöé      Word      Γöé
  4903.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4904.  
  4905.  Supplied Parameters 
  4906.  
  4907.           FunctionCode 
  4908.                     Defines the function to be performed. Must be X'0C'. 
  4909.  
  4910.           Version 
  4911.                     Identifies the version of ACDI your application is written 
  4912.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  4913.  
  4914.           DeviceHandle 
  4915.                     Returned by the ComOpen verb; identifies the device to 
  4916.                     ACDI. 
  4917.  
  4918.           FlowMode 
  4919.                     Enables/disables automatic flow control. 
  4920.  
  4921.                                         -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4922.                                         Γöé MODE        Γöé FLOW CONTROL    Γöé DELETE XON     Γöé DELETE XOFF    Γöé
  4923.                                         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4924.                                         Γöé 0         Γöé Disables      Γöé No         Γöé No        Γöé
  4925.                                         Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4926.                                         Γöé 7         Γöé Enables      Γöé Yes        Γöé Yes        Γöé
  4927.                                         ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4928.  
  4929.  Returned Parameters 
  4930.  
  4931.           ReturnCode 
  4932.                     Returns the completion status of the verb. 
  4933.  
  4934.                     The following values can be returned: 
  4935.  
  4936.              X'00'     Successful. 
  4937.  
  4938.              X'01'     Invalid device handle. 
  4939.  
  4940.              X'49'     FlowMode invalid. 
  4941.  
  4942.              X'F1'     Base operating system error occurred during execution. 
  4943.  
  4944.              X'F4'     Invalid version of ACDI. 
  4945.  
  4946.              X'FF'     ACDI not started. 
  4947.  
  4948.           For more information, see ACDI Return Codes. 
  4949.  
  4950.  Comments 
  4951.  
  4952.           FlowMode=0 is the default (automatic flow control is off), and both 
  4953.           the XON and XOFF characters are left in the data stream when 
  4954.           received. 
  4955.  
  4956.           Note:  For this default choice, there is no requirement that buffer 
  4957.                  levels must be previously specified, since none are used. See 
  4958.                  ComSetFlowThresh (X'0D') for additional information.
  4959.  
  4960.           When automatic flow control is enabled, XON and XOFF characters are 
  4961.           consumed by ACDI. and are not placed into the application input 
  4962.           buffer. 
  4963.  
  4964.           Applications that choose not to turn on automatic flow control often 
  4965.           implement their own flow control at the application level (for 
  4966.           example, implementations of frame-level protocols). 
  4967.  
  4968.           Note:  Frame-level protocols may use flow control packets instead of 
  4969.                  flow control characters.
  4970.  
  4971.           Warning: The application writer should be careful enabling this 
  4972.           feature when the input mode is block mode. XON and XOFF characters 
  4973.           can exist in the block mode I/O data stream used by frame-level 
  4974.           protocols. Also, detection of those characters in the data stream 
  4975.           with automatic flow control enabled can put the data flow into a 
  4976.           deadlocked state. 
  4977.  
  4978.  
  4979. ΓòÉΓòÉΓòÉ 7.26. ComSetFlowThresh (X'0D') ΓòÉΓòÉΓòÉ
  4980.  
  4981. ComSetFlowThresh (X'0D') 
  4982.  
  4983.           This verb sets the flow control threshold levels for the application 
  4984.           input buffer. 
  4985.  
  4986.  Prerequisite Calls 
  4987.  
  4988.           ComOpen 
  4989.           ComDefInput 
  4990.  
  4991.  Verb Control Block Format 
  4992.  
  4993.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  4994.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  4995.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4996.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  4997.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4998.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  4999.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5000.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5001.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5002.                     Γöé XOFFBUFFLEVEL      Γöé    X    Γöé       Γöé      Word      Γöé
  5003.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5004.                     Γöé XONBUFFLEVEL       Γöé    X    Γöé       Γöé      Word      Γöé
  5005.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5006.  
  5007.  Supplied Parameters 
  5008.  
  5009.           FunctionCode 
  5010.                     Defines the function to be performed. Must be X'0D'. 
  5011.  
  5012.           Version 
  5013.                     Identifies the version of ACDI your application is written 
  5014.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5015.  
  5016.           DeviceHandle 
  5017.                     Returned by the ComOpen verb; identifies the device to 
  5018.                     ACDI. 
  5019.  
  5020.           XOffBuffLevel 
  5021.                     The amount of free space in the application input buffer 
  5022.                     where the XOFF character is sent. It is an unsigned 
  5023.                     integer. 
  5024.  
  5025.           XOnBuffLevel 
  5026.                     The amount of free space in the application input buffer 
  5027.                     where the XON is sent. It is an unsigned integer. 
  5028.  
  5029.  Returned Parameters 
  5030.  
  5031.           ReturnCode 
  5032.                     Returns the completion status of the verb. 
  5033.  
  5034.                     The following values can be returned: 
  5035.  
  5036.              X'00'     Successful. 
  5037.  
  5038.              X'01'     Invalid device handle. 
  5039.  
  5040.              X'39'     Specified XOFF buffer level is greater than or equal to 
  5041.                        the XON buffer level. 
  5042.  
  5043.              X'3B'     Undefined application input buffer. 
  5044.  
  5045.              X'3D'     Invalid buffer level. This error can be caused by 
  5046.                        setting the XON buffer to a greater value than the 
  5047.                        application input buffer. 
  5048.  
  5049.              X'F1'     Base operating system error occurred during execution. 
  5050.  
  5051.              X'F4'     Invalid version of ACDI. 
  5052.  
  5053.              X'FF'     ACDI not started. 
  5054.  
  5055.           For more information, see ACDI Return Codes. 
  5056.  
  5057.  Comments 
  5058.  
  5059.           Buffer levels are expressed as the number of free bytes in the 
  5060.           application input buffer. When the number of free characters (free 
  5061.           space) in the application input buffer becomes less than the 
  5062.           specified XOFF level, ACDI sends the XOFF character. When the number 
  5063.           of free characters (free space) becomes larger than the specified XON 
  5064.           level, ACDI sends an XON character to the remote sender. 
  5065.  
  5066.           The XOFF level must be set to less than the XON level. Setting the 
  5067.           XOFF level equal to or greater than XON returns an error condition. 
  5068.  
  5069.           The application must use the ComSetFlowMode verb to enable automatic 
  5070.           flow control and activate these flow control threshold levels. 
  5071.  
  5072.           Note:  The XON and XOFF thresholds should be far enough apart to 
  5073.                  avoid unnecessary oscillation between the XON state and the 
  5074.                  XOFF state.
  5075.  
  5076.  
  5077. ΓòÉΓòÉΓòÉ 7.27. ComSetLineCtrl (X'05') ΓòÉΓòÉΓòÉ
  5078.  
  5079. ComSetLineCtrl (X'05') 
  5080.  
  5081.           This verb sets the line control values for the asynchronous 
  5082.           receiver/transmitter on the asynchronous communications hardware. 
  5083.  
  5084.  Prerequisite Calls 
  5085.  
  5086.           ComOpen 
  5087.  
  5088.  Verb Control Block Format 
  5089.  
  5090.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5091.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5092.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5093.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5094.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5095.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5096.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5097.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5098.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5099.                     Γöé STOPBITS         Γöé    X    Γöé       Γöé      Word      Γöé
  5100.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5101.                     Γöé RESERVED         Γöé    X    Γöé       Γöé      Word      Γöé
  5102.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5103.                     Γöé PARITY          Γöé    X    Γöé       Γöé      Word      Γöé
  5104.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5105.                     Γöé RESERVED         Γöé    X    Γöé       Γöé      Word      Γöé
  5106.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5107.                     Γöé DATABITS         Γöé    X    Γöé       Γöé      Word      Γöé
  5108.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5109.  
  5110.  Supplied Parameters 
  5111.  
  5112.           FunctionCode 
  5113.                     Defines the function to be performed. Must be X'05'. 
  5114.  
  5115.           Version 
  5116.                     Identifies the version of ACDI your application is written 
  5117.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5118.  
  5119.           DeviceHandle 
  5120.                     Returned by the ComOpen verb; identifies the device to 
  5121.                     ACDI. 
  5122.  
  5123.           StopBits 
  5124.                     Indicates the number of stop bits to be used by the 
  5125.                     asynchronous transmitter and receiver circuits for encoding 
  5126.                     the character. 
  5127.  
  5128.              X'01'     1 stop bit. 
  5129.  
  5130.              X'02'     1.5 stop bits (valid only with 5 data bits). 
  5131.  
  5132.              X'03'     2 stop bits (not valid with 5 data bits). 
  5133.  
  5134.           Parity 
  5135.                     Indicates the parity to be used for each character encoding 
  5136.                     on transmission and integrity testing on reception. 
  5137.  
  5138.              X'00'     No parity. 
  5139.  
  5140.              X'01'     Odd parity. 
  5141.  
  5142.              X'02'     Even parity. 
  5143.  
  5144.              X'03'     Mark parity. 
  5145.  
  5146.              X'04'     Space parity. 
  5147.  
  5148.           DataBits 
  5149.                     Indicates the number of data bits for each character 
  5150.                     encoding. 
  5151.  
  5152.              X'05'     5 data bits (not valid with 2 stop bits). 
  5153.  
  5154.              X'06'     6 data bits. 
  5155.  
  5156.              X'07'     7 data bits. 
  5157.  
  5158.              X'08'     8 data bits. 
  5159.  
  5160.  Returned Parameters 
  5161.  
  5162.           ReturnCode 
  5163.                     Returns the completion status of the verb. 
  5164.  
  5165.                     The following values can be returned: 
  5166.  
  5167.              X'00'     Successful. 
  5168.  
  5169.              X'01'     Invalid device handle. 
  5170.  
  5171.              X'2D'     Invalid number of stop bits. 
  5172.  
  5173.              X'2F'     Invalid parity. 
  5174.  
  5175.              X'31'     Invalid number of data bits. 
  5176.  
  5177.              X'32'     Line control settings not compatible. 
  5178.  
  5179.              X'F1'     Base operating system error occurred during execution. 
  5180.  
  5181.              X'F4'     Invalid version of ACDI. 
  5182.  
  5183.              X'FF'     ACDI not started. 
  5184.  
  5185.           For more information, see ACDI Return Codes. 
  5186.  
  5187.  Comments 
  5188.  
  5189.           The defaults set by the system when the device is obtained with the 
  5190.           ComOpen verb are 7 data bits, 1 stop bit, and even parity mode. 
  5191.  
  5192.           If you use a mode to establish a connection, see Bit Rate and Line 
  5193.           Control Parameters for additional information. 
  5194.  
  5195.           When you use adapters containing UARTs with FIFO buffers (16550A), 
  5196.           take care to change line speeds or line control values. Use of the 
  5197.           ComDrainOutput verb prior to these types of changes alleviates this 
  5198.           problem. 
  5199.  
  5200.           Warning: The 8250 and 8250-B UARTs might transmit bad data when 
  5201.           configured for 5 data bits and 1.5 stop bits. Although rarely used, 
  5202.           this combination is not prohibited and the data sent by these UARTs 
  5203.           might not be valid with this setting. 
  5204.  
  5205.  
  5206. ΓòÉΓòÉΓòÉ 7.28. ComSetTimeout (X'1D') ΓòÉΓòÉΓòÉ
  5207.  
  5208. ComSetTimeout (X'1D') 
  5209.  
  5210.           This verb sets time-out values for the ComReadCharString, 
  5211.           ComReadBlock, and ComWriteCharString verbs. 
  5212.  
  5213.  Prerequisite Calls 
  5214.  
  5215.           ComOpen 
  5216.  
  5217.  Verb Control Block Format 
  5218.  
  5219.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5220.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5221.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5222.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5223.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5224.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5225.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5226.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5227.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5228.                     Γöé READTIMEOUTBLOCK     Γöé    X    Γöé       Γöé      Word      Γöé
  5229.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5230.                     Γöé READTIMEOUTCHAR     Γöé    X    Γöé       Γöé      Word      Γöé
  5231.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5232.                     Γöé WRITETIMEOUT       Γöé    X    Γöé       Γöé      Word      Γöé
  5233.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5234.  
  5235.  Supplied Parameters 
  5236.  
  5237.           FunctionCode 
  5238.                     Defines the function to be performed. Must be X'1D'. 
  5239.  
  5240.           Version 
  5241.                     Identifies the version of ACDI your application is written 
  5242.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5243.  
  5244.           DeviceHandle 
  5245.                     Returned by the ComOpen verb; identifies the device to 
  5246.                     ACDI. 
  5247.  
  5248.           ReadTimeoutBlock 
  5249.                     Specifies the time in 10-millisecond units to complete the 
  5250.                     read operation of the ComReadBlock verb for the entire 
  5251.                     block prior to timing out. A value of 0 results in an 
  5252.                     infinite time-out. This value is rounded up by ACDI to the 
  5253.                     smallest integer multiple of the interrupt clock period 
  5254.                     (for the particular machine that is running the program) 
  5255.                     that is larger than the minimum time indicated. The range 
  5256.                     is 0 to 65535. The system may extend this time. 
  5257.  
  5258.           ReadTimeoutChar 
  5259.                     Specifies the maximum time requested by the application to 
  5260.                     be allowed between the characters being received in 
  5261.                     character mode, before a time-out is generated. Values from 
  5262.                     1 to 8192 indicate the maximum number of character times 
  5263.                     (at the current line speed and character specification) 
  5264.                     that can elapse (after the InitialWait time has expired) 
  5265.                     between received characters before a time-out error is 
  5266.                     returned on a ComReadCharString verb. A value of 0 results 
  5267.                     in an infinite time-out. Values greater than 8192 return an 
  5268.                     error. 
  5269.  
  5270.           WriteTimeout 
  5271.                     Specifies the time in 10-millisecond units to wait for 
  5272.                     WriteBytesNeeded to become available before a time-out is 
  5273.                     generated on a ComWriteCharString verb. 
  5274.  
  5275.  Returned Parameters 
  5276.  
  5277.           ReturnCode 
  5278.                     Returns the successful completion of the verb. 
  5279.  
  5280.                     The following values can be returned: 
  5281.  
  5282.              X'00'     Successful. 
  5283.  
  5284.              X'01'     Invalid device handle. 
  5285.  
  5286.              X'62'     Invalid time-out. 
  5287.  
  5288.              X'F1'     Base operating system error occurred during execution. 
  5289.  
  5290.              X'F4'     Invalid version of ACDI. 
  5291.  
  5292.              X'FF'     ACDI not started. 
  5293.  
  5294.           For more information, see ACDI Return Codes. 
  5295.  
  5296.  Comments 
  5297.  
  5298.           This call can be made regardless of whether a data connection exists. 
  5299.  
  5300.           The ReadTimeoutBlock, ReadTimeoutChar, and WriteTimeout timers are 
  5301.           activated when a read or write request is routed by ACDI to the 
  5302.           device driver. These timers are not suspended by flow control. For 
  5303.           example, the ComWriteCharString timer is not suspended when the 
  5304.           remote transmitter sends an XOFF. 
  5305.  
  5306.           Defaults are as follows: 
  5307.  
  5308.           o ReadTimeoutBlock = 5 (50 milliseconds) 
  5309.           o ReadTimeoutChar = 5 (5 character times) 
  5310.           o WriteTimeout = 5 (50 milliseconds) 
  5311.  
  5312.           The ReadTimeoutChar timer is reset and restarted each time a 
  5313.           character is received. 
  5314.  
  5315.  
  5316. ΓòÉΓòÉΓòÉ 7.29. ComStartTrans (X'0A') ΓòÉΓòÉΓòÉ
  5317.  
  5318. ComStartTrans (X'0A') 
  5319.  
  5320.           This verb instructs ACDI to start transmitting data in the 
  5321.           application output buffer. 
  5322.  
  5323.  Prerequisite Calls 
  5324.  
  5325.           ComOpen 
  5326.           ComConnect (must be connected) 
  5327.  
  5328.           Note:  Automatic flow control must not be enabled. 
  5329.  
  5330.  Verb Control Block Format 
  5331.  
  5332.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5333.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5334.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5335.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5336.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5337.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5338.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5339.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5340.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5341.  
  5342.  Supplied Parameters 
  5343.  
  5344.           FunctionCode 
  5345.                     Defines the function to be performed. Must be X'0A'. 
  5346.  
  5347.           Version 
  5348.                     Identifies the version of ACDI your application is written 
  5349.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5350.  
  5351.           DeviceHandle 
  5352.                     Returned by the ComOpen verb; identifies the device to 
  5353.                     ACDI. 
  5354.  
  5355.  Returned Parameters 
  5356.  
  5357.           ReturnCode 
  5358.                     Returns the completion status of the verb. 
  5359.  
  5360.                     The following values can be returned: 
  5361.  
  5362.              X'00'     Successful. 
  5363.  
  5364.              X'01'     Invalid device handle. 
  5365.  
  5366.              X'03'     No connection exists. 
  5367.  
  5368.              X'35'     Automatic flow control in progress. 
  5369.  
  5370.              X'F1'     Base operating system error occurred during execution. 
  5371.  
  5372.              X'F4'     Invalid version of ACDI. 
  5373.  
  5374.              X'FF'     ACDI not started. 
  5375.  
  5376.           For more information, see ACDI Return Codes. 
  5377.  
  5378.  Comments 
  5379.  
  5380.           This verb can only be used while a connection exists, and it 
  5381.           instructs ACDI to resume data transmission. It has no effect if data 
  5382.           transmission is not suspended. 
  5383.  
  5384.           This verb cannot be used while automatic flow control is enabled. 
  5385.  
  5386.           Note:  It is not necessary to issue this verb to start data 
  5387.                  transmission in general. This verb is only used if an 
  5388.                  application has previously issued a ComStopTrans verb.
  5389.  
  5390.  
  5391. ΓòÉΓòÉΓòÉ 7.30. ComStopTrans (X'09') ΓòÉΓòÉΓòÉ
  5392.  
  5393. ComStopTrans (X'09') 
  5394.  
  5395.           This verbs instructs ACDI to stop transmitting data in the 
  5396.           application buffer. 
  5397.  
  5398.  Prerequisite Calls 
  5399.  
  5400.           ComOpen 
  5401.           ComConnect (must be connected) 
  5402.  
  5403.           Note:  Automatic flow control must not be enabled. 
  5404.  
  5405.  Verb Control Block Format 
  5406.  
  5407.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5408.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5409.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5410.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5411.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5412.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5413.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5414.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5415.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5416.  
  5417.  Supplied Parameters 
  5418.  
  5419.           FunctionCode 
  5420.                     Defines the function to be performed. Must be X'09'. 
  5421.  
  5422.           Version 
  5423.                     Identifies the version of ACDI your application is written 
  5424.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5425.  
  5426.           DeviceHandle 
  5427.                     Returned by the ComOpen verb; identifies the device to 
  5428.                     ACDI. 
  5429.  
  5430.  Returned Parameters 
  5431.  
  5432.           ReturnCode 
  5433.                     Returns the completion status of the verb. 
  5434.  
  5435.                     The following values can be returned: 
  5436.  
  5437.              X'00'     Successful. 
  5438.  
  5439.              X'01'     Invalid device handle. 
  5440.  
  5441.              X'03'     No connection exists. 
  5442.  
  5443.              X'35'     Automatic flow control in progress. 
  5444.  
  5445.              X'F1'     Base operating system error occurred during execution. 
  5446.  
  5447.              X'F4'     Invalid version of ACDI. 
  5448.  
  5449.              X'FF'     ACDI not started. 
  5450.  
  5451.           For more information, see ACDI Return Codes. 
  5452.  
  5453.  Comments 
  5454.  
  5455.           This verb can only be used while a connection exists. 
  5456.  
  5457.           Characters transmitted with the ComTransImm verb and transmission of 
  5458.           a break signal with the ComSendBreak verb are not prohibited by this 
  5459.           verb. 
  5460.  
  5461.           This verb cannot be used while automatic flow control is enabled. 
  5462.  
  5463.  
  5464. ΓòÉΓòÉΓòÉ 7.31. ComTransImm (X'08') ΓòÉΓòÉΓòÉ
  5465.  
  5466. ComTransImm (X'08') 
  5467.  
  5468.           This verb sends the specified character immediately. 
  5469.  
  5470.  Prerequisite Calls 
  5471.  
  5472.           ComOpen 
  5473.           ComConnect (must be connected) 
  5474.  
  5475.  Verb Control Block Format 
  5476.  
  5477.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5478.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5479.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5480.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5481.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5482.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5483.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5484.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5485.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5486.                     Γöé TRANSCHAR        Γöé    X    Γöé       Γöé      Byte      Γöé
  5487.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5488.  
  5489.  Supplied Parameters 
  5490.  
  5491.           FunctionCode 
  5492.                     Defines the function to be performed. Must be X'08'. 
  5493.  
  5494.           Version 
  5495.                     Identifies the version of ACDI your application is written 
  5496.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5497.  
  5498.           DeviceHandle 
  5499.                     Returned by the ComOpen verb; identifies the device to 
  5500.                     ACDI. 
  5501.  
  5502.           TransChar 
  5503.                     Contains 1 byte to be transmitted immediately. 
  5504.  
  5505.  Returned Parameters 
  5506.  
  5507.           ReturnCode 
  5508.                     Returns the completion status of the verb. 
  5509.  
  5510.                     The following values can be returned: 
  5511.  
  5512.              X'00'     Successful. 
  5513.  
  5514.              X'01'     Invalid device handle. 
  5515.  
  5516.              X'03'     No connection exists. 
  5517.  
  5518.              X'3C'     Previous ComTransImm verb still in progress. 
  5519.  
  5520.              X'F1'     Base operating system error occurred during execution. 
  5521.  
  5522.              X'F4'     Invalid version of ACDI. 
  5523.  
  5524.              X'FF'     ACDI not started. 
  5525.  
  5526.           For more information, see ACDI Return Codes. 
  5527.  
  5528.  Comments 
  5529.  
  5530.           This verb can only be used while a connection exists. 
  5531.  
  5532.           When this verb is issued, ACDI transmits the TransChar byte of data 
  5533.           immediately if a connection is established and if ACDI is not 
  5534.           currently sending a break signal. 
  5535.  
  5536.           The verb is typically used to send an XON and XOFF character for 
  5537.           application control of data flow. 
  5538.  
  5539.           The character is transmitted with the current line control setting 
  5540.           for data bits. For example, if the current data bit setting is 7, 
  5541.           only the lower 7 bits of the character are sent out over the line. 
  5542.  
  5543.           Note:  ACDI does not monitor the values of the TransChar parameter 
  5544.                  when the ComTransImm function is issued. If the port has 
  5545.                  automatic flow control enabled, this function should not be 
  5546.                  used to send XON and XOFF characters. Doing so may cause ACDI 
  5547.                  to get out of sync with the remote sender's transmission 
  5548.                  state. 
  5549.  
  5550.  
  5551. ΓòÉΓòÉΓòÉ 7.32. ComUnblockThread (X'26') ΓòÉΓòÉΓòÉ
  5552.  
  5553. ComUnblockThread (X'26') 
  5554.  
  5555.           This verb unblocks the specified thread if it is currently blocked. 
  5556.  
  5557.  Prerequisite Calls 
  5558.  
  5559.           ComOpen 
  5560.  
  5561.  Verb Control Block Format 
  5562.  
  5563.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5564.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5565.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5566.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5567.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5568.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5569.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5570.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5571.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5572.                     Γöé UNBLOCKMASK       Γöé    X    Γöé       Γöé     Bits (32)    Γöé
  5573.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5574.  
  5575.  Supplied Parameters 
  5576.  
  5577.           FunctionCode 
  5578.                     Defines the function to be performed. Must be X'26'. 
  5579.  
  5580.           Version 
  5581.                     Identifies the version of ACDI your application is written 
  5582.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5583.  
  5584.           DeviceHandle 
  5585.                     Returned by the ComOpen verb; identifies the device to 
  5586.                     ACDI. 
  5587.  
  5588.           UnblockMask 
  5589.                     Specifies the thread or threads to be unblocked. 
  5590.  
  5591.  Returned Parameters 
  5592.  
  5593.           ReturnCode 
  5594.                     Returns the completion status of the verb. 
  5595.  
  5596.                     The following values can be returned: 
  5597.  
  5598.              X'00'     Successful. 
  5599.  
  5600.              X'01'     Invalid device handle. 
  5601.  
  5602.              X'38'     One of the specified threads was not blocked. 
  5603.  
  5604.              X'F1'     Base operating system error occurred during execution. 
  5605.  
  5606.              X'F4'     Invalid version of ACDI. 
  5607.  
  5608.              X'FF'     ACDI not started. 
  5609.  
  5610.           For more information, see ACDI Return Codes. 
  5611.  
  5612.  Comments 
  5613.  
  5614.           If bit 0 of the unblock mask is set, ACDI unblocks any thread that 
  5615.           has issued a ComReadCharString verb (if one is blocked). 
  5616.  
  5617.           If bit 1 is set, ACDI unblocks any thread that has issued a 
  5618.           ComReadBlock verb (if one is blocked). 
  5619.  
  5620.           Note:  When the blocked read request returns, it returns a 0 in the 
  5621.                  data length field and the error mask field. The return code 
  5622.                  indicates the request was canceled by a ComUnblockThread verb.
  5623.  
  5624.  
  5625. ΓòÉΓòÉΓòÉ 7.33. ComWriteCharString (X'17') ΓòÉΓòÉΓòÉ
  5626.  
  5627. ComWriteCharString (X'17') 
  5628.  
  5629.           This verb writes new data in the application output buffer and 
  5630.           returns updated free space in the buffer. 
  5631.  
  5632.  Prerequisite Calls 
  5633.  
  5634.           ComOpen 
  5635.           ComConnect (must be connected) 
  5636.           ComDefOutputBuff 
  5637.  
  5638.  Verb Control Block Format 
  5639.  
  5640.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5641.                     Γöé FUNCTIONCODE       Γöé    X    Γöé       Γöé      Byte      Γöé
  5642.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5643.                     Γöé VERSION         Γöé    X    Γöé       Γöé      Byte      Γöé
  5644.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5645.                     Γöé RETURNCODE        Γöé       Γöé    X    Γöé      Word      Γöé
  5646.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5647.                     Γöé DEVICEHANDLE       Γöé    X    Γöé       Γöé      Word      Γöé
  5648.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5649.                     Γöé BYTESWRITTEN       Γöé    X    Γöé       Γöé      Word      Γöé
  5650.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5651.                     Γöé WRITEBYTESNEEDED     Γöé    X    Γöé       Γöé      Word      Γöé
  5652.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5653.                     Γöé NEXTAVAILWRITEPTR    Γöé       Γöé    X    Γöé  Doubleword Address  Γöé
  5654.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5655.                     Γöé NEXTAVAILWRITELGTH    Γöé       Γöé    X    Γöé      Word      Γöé
  5656.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5657.  
  5658.  Supplied Parameters 
  5659.  
  5660.           FunctionCode 
  5661.                     Defines the function to be performed. Must be X'17'. 
  5662.  
  5663.           Version 
  5664.                     Identifies the version of ACDI your application is written 
  5665.                     for. Must be X'00', X'01', X'02', X'03', or X'04'. 
  5666.  
  5667.           DeviceHandle 
  5668.                     Returned by the ComOpen verb; identifies the device to 
  5669.                     ACDI. 
  5670.  
  5671.           BytesWritten 
  5672.                     Is the number of characters put into the application output 
  5673.                     buffer by the application. ACDI writes these to the device. 
  5674.  
  5675.           WriteBytesNeeded 
  5676.                     Is the number of bytes that should be available in the 
  5677.                     application output buffer before ACDI returns control to 
  5678.                     the application. 
  5679.  
  5680.  Returned Parameters 
  5681.  
  5682.           ReturnCode 
  5683.                     Returns the completion status of the verb. 
  5684.  
  5685.                     The following values can be returned: 
  5686.  
  5687.              X'00'     Successful. 
  5688.  
  5689.              X'01'     Invalid device handle. 
  5690.  
  5691.              X'03'     No connection exists. 
  5692.  
  5693.              X'37'     Verb canceled by ComFlushOutput verb. 
  5694.  
  5695.              X'3B'     Undefined output buffer. 
  5696.  
  5697.              X'3C'     A ComWriteCharString verb is already in progress. 
  5698.  
  5699.              X'51'     The number specified in the BytesWritten parameter is 
  5700.                        larger than the available space in the output buffer. 
  5701.  
  5702.              X'52'     The number of bytes needed is larger than the output 
  5703.                        buffer's usable space. 
  5704.  
  5705.              X'53'     Time-out exceeded while in XOFF state. 
  5706.  
  5707.              X'54'     Time-out exceeded while in XON state. 
  5708.  
  5709.              X'F1'     Base operating system error occurred during execution. 
  5710.  
  5711.              X'F4'     Invalid version of ACDI. 
  5712.  
  5713.              X'FF'     ACDI not started. 
  5714.  
  5715.           NextAvailWritePtr 
  5716.                     Is returned to the application and is the address of the 
  5717.                     next available byte of free space in the application output 
  5718.                     buffer. 
  5719.  
  5720.           NextAvailWriteLgth 
  5721.                     Is the length of the free space area in the application 
  5722.                     output buffer. 
  5723.  
  5724.           For more information, see ACDI Return Codes. 
  5725.  
  5726.  Comments 
  5727.  
  5728.           This verb can only be used while a connection exists. 
  5729.  
  5730.           An application issues a ComWriteCharString verb to inform ACDI that 
  5731.           BytesWritten characters have been added to the application output 
  5732.           buffer for ACDI to transmit. The application makes a request for free 
  5733.           space in the output buffer.  ACDI blocks the application's thread 
  5734.           until the free space is available in the buffer or until the request 
  5735.           times out (as with the WriteTimeout parameter set by the 
  5736.           ComSetTimeout verb). 
  5737.  
  5738.           The first time an application copies data, it should copy the data 
  5739.           into the buffer starting at the beginning of the buffer. 
  5740.           Subsequently, the application can copy data into the buffer beginning 
  5741.           at the pointer. This frees space returned to the application by ACDI 
  5742.           on the previous ComWriteCharString verb. 
  5743.  
  5744.           If a connection drops while a ComWriteCharString verb is outstanding, 
  5745.           ACDI unblocks the request and returns it to the application. 
  5746.  
  5747.           If the application issues the ComWriteCharString verb with a 
  5748.           BytesWritten value that is larger than or equal to the output buffer 
  5749.           size, ACDI returns an error code of X'51'. ACDI then flushes the 
  5750.           output buffer. After receiving the X'51' return code, the application 
  5751.           should copy subsequent data for ACDI to transmit at the beginning of 
  5752.           the output buffer. 
  5753.  
  5754.           If the ComWriteCharString verb times out (enough free space does not 
  5755.           become available in the time specified by the WriteTimeout parameter) 
  5756.           and ACDI has received an XOFF character from the remote receiver or 
  5757.           the application has issued the ComStopTrans verb, ACDI returns the 
  5758.           verb with the X'53' return code. Otherwise, the X'54' return code is 
  5759.           returned by ACDI when the request times out. 
  5760.  
  5761.           Note:  When a request times out, ACDI continues to transmit the data 
  5762.                  in the application output buffer. 
  5763.  
  5764.  
  5765. ΓòÉΓòÉΓòÉ 8. Using the ACDI Redirection API ΓòÉΓòÉΓòÉ
  5766.  
  5767. ACDI Redirection allows you to redirect ACDI using an application program. 
  5768. Using ACDI Redirection, you can set and query ACDI by interfaces other than a 
  5769. command line. For example, an ACDI application program can determine if a port 
  5770. is currently redirected. 
  5771.  
  5772. This chapter describes how to use the ACDI Redirection application programming 
  5773. interface (API) and provides a detailed description of the six ACDI Redirection 
  5774. API functions. 
  5775.  
  5776.  
  5777. ΓòÉΓòÉΓòÉ 8.1. ACDI Redirection API Functions ΓòÉΓòÉΓòÉ
  5778.  
  5779. The ACDI Redirection API consists of the following six functions: 
  5780.  
  5781.  o ArfCreate 
  5782.  o ArfQuery 
  5783.  o ArfRedirect 
  5784.  o ArfRestore 
  5785.  o ArfSave 
  5786.  o ArfUnRedirect 
  5787.  
  5788.  These functions are discussed in detail in this chapter. For a detailed 
  5789.  explanation of the return codes for these functions, see ACDI Redirection API 
  5790.  Return Codes. 
  5791.  
  5792.  
  5793. ΓòÉΓòÉΓòÉ 8.2. ArfCreate  ArfCreate function ΓòÉΓòÉΓòÉ
  5794.  
  5795. ArfCreate 
  5796.  
  5797.           This function creates a redirection configuration data file named 
  5798.           ACSARF.DAT. 
  5799.  
  5800.                     ArfCreate()
  5801.  
  5802.  Supplied Parameters 
  5803.  
  5804.           None. 
  5805.  
  5806.  Returned Parameters 
  5807.  
  5808.           None. 
  5809.  
  5810.  Return Codes 
  5811.  
  5812.           The following codes are valid for ArfCreate: 
  5813.  
  5814.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5815.                     Γöé RETURN Γöé                                   Γöé
  5816.                     Γöé CODE  Γöé EXPLANATION                             Γöé
  5817.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5818.                     Γöé 0    Γöé Requested function successfully completed              Γöé
  5819.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5820.                     Γöé 7    Γöé Communications Manager not started                  Γöé
  5821.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5822.                     Γöé 9    Γöé Error accessing file ACSARF.DAT                   Γöé
  5823.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5824.                     Γöé 10   Γöé File ACSARF.DAT already exists                    Γöé
  5825.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5826.  
  5827.           Note:  If ACSARF.DAT is accidentally erased, this function can be 
  5828.                  used to create a new one. ArfCreate creates a redirection 
  5829.                  configuration data file with some but not all ports 
  5830.                  redirected. 
  5831.  
  5832.  
  5833. ΓòÉΓòÉΓòÉ 8.3. ArfQuery  ArfQuery function ΓòÉΓòÉΓòÉ
  5834.  
  5835. ArfQuery 
  5836.  
  5837.           This function queries the redirection status of a serial port. 
  5838.  
  5839.                     ArfQuery(PortNumber, Status, DestString, LANANumber)
  5840.  
  5841.  Supplied Parameters 
  5842.  
  5843.           PortNumber 
  5844.                     A word that specifies the serial port to be queried. The 
  5845.                     port number must be 1, 2, or 3. 
  5846.  
  5847.  Returned Parameters 
  5848.  
  5849.           Status 
  5850.                     Doubleword address of a byte variable.  The redirection 
  5851.                     status of the specified serial port is returned to this 
  5852.                     byte variable.  If Status=0, the serial port is not 
  5853.                     redirected.  If Status=1, the serial port is redirected to 
  5854.                     a remote serial port.  If Status=3, the serial port is 
  5855.                     redirected to another local serial port. 
  5856.  
  5857.           DestString 
  5858.                     Doubleword address of a character buffer.  A null 
  5859.                     terminated ASCII string will be returned in this buffer. 
  5860.                     If the serial port is redirected to a remote serial port, 
  5861.                     the string contains the NETBIOS name associated with the 
  5862.                     remote serial port.  If the serial port is redirected to a 
  5863.                     local serial port, the string contains the device name of 
  5864.                     the local serial port (COM1, COM2, or COM3).  If the serial 
  5865.                     port is not redirected, the string contains the device name 
  5866.                     of this serial port (COM1, COM2, or COM3). The maximum 
  5867.                     length of this string is 17 characters, including the 
  5868.                     terminating null byte. 
  5869.  
  5870.           LANANumber 
  5871.                     Doubleword address of a word variable.  If the serial port 
  5872.                     is redirected to a remote serial port, a value of 0 or 1 is 
  5873.                     returned in this word.  This word specifies which LAN 
  5874.                     adapter is used on this OS/2 workstation when connecting to 
  5875.                     a remote serial port. If the serial port is not redirected 
  5876.                     to a remote serial port, 0 is returned in this word. 
  5877.  
  5878.  Return Codes 
  5879.  
  5880.           The following codes are valid for ArfQuery: 
  5881.  
  5882.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5883.                     Γöé RETURN Γöé                                   Γöé
  5884.                     Γöé CODE  Γöé EXPLANATION                             Γöé
  5885.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5886.                     Γöé 0    Γöé Requested function successfully completed              Γöé
  5887.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5888.                     Γöé 1    Γöé Redirect directory does not exist                  Γöé
  5889.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5890.                     Γöé 2    Γöé Invalid port number                         Γöé
  5891.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5892.  
  5893.           Note:  If an unsuccessful return code is returned, the contents of 
  5894.                  the Status, DestString, and LANANumber variables are left 
  5895.                  unchanged. 
  5896.  
  5897.  
  5898. ΓòÉΓòÉΓòÉ 8.4. ArfRedirect ΓòÉΓòÉΓòÉ
  5899.  
  5900. ArfRedirect 
  5901.  
  5902.           This function redirects a serial port to a remote serial port or to 
  5903.           another local serial port. 
  5904.  
  5905.                     ArfRedirect(PortNumber, DestString, LANANumber)
  5906.  
  5907.  Supplied Parameters 
  5908.  
  5909.           PortNumber 
  5910.                     A word that specifies the serial port to be redirected. The 
  5911.                     port number must be 1, 2, or 3. 
  5912.  
  5913.           DestString 
  5914.                     Doubleword address of a null terminated ASCII string.  If 
  5915.                     the serial port is being redirected to a remote serial 
  5916.                     port, the string contains the NETBIOS name associated with 
  5917.                     the remote serial port. If the serial port is being 
  5918.                     redirected to another local serial port, the string 
  5919.                     contains the device name of a local serial port (COM1, 
  5920.                     COM2, or COM3).  The maximum length of this string is 17 
  5921.                     characters, including the terminating null byte. 
  5922.  
  5923.           LANANumber 
  5924.                     A word that specifies which LAN adapter to use on a 
  5925.                     specific OS/2 workstation when connecting to a remote 
  5926.                     serial port.  This parameter is used only if the DestString 
  5927.                     is not COM1, COM2, or COM3. The LAN adapter number must be 
  5928.                     0 or 1. 
  5929.  
  5930.  Returned Parameters 
  5931.  
  5932.           None. 
  5933.  
  5934.  Return Codes 
  5935.  
  5936.           The following codes are valid for ArfRedirect: 
  5937.  
  5938.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5939.                     Γöé RETURN Γöé                                   Γöé
  5940.                     Γöé CODE  Γöé EXPLANATION                             Γöé
  5941.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5942.                     Γöé 0    Γöé Requested function successfully completed              Γöé
  5943.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5944.                     Γöé 1    Γöé Redirect directory does not exist                  Γöé
  5945.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5946.                     Γöé 2    Γöé Invalid port number                         Γöé
  5947.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5948.                     Γöé 3    Γöé Invalid LAN adapter number                      Γöé
  5949.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5950.                     Γöé 4    Γöé Invalid destination string                      Γöé
  5951.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5952.                     Γöé 5    Γöé Redirect directory in use                      Γöé
  5953.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5954.                     Γöé 6    Γöé Port in use                             Γöé
  5955.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5956.  
  5957.           Note:  Redirecting a serial port to itself cancels the redirection of 
  5958.                  that serial port. This can also be accomplished with the 
  5959.                  ArfUnRedirect function. 
  5960.  
  5961.  
  5962. ΓòÉΓòÉΓòÉ 8.5. ArfRestore  ArfRestore function ΓòÉΓòÉΓòÉ
  5963.  
  5964. ArfRestore 
  5965.  
  5966.           This function restores the current redirection configuration to the 
  5967.           permanent redirection configuration. 
  5968.  
  5969.                     ArfRestore()
  5970.  
  5971.  Supplied Parameters 
  5972.  
  5973.           None. 
  5974.  
  5975.  Returned Parameters 
  5976.  
  5977.           None. 
  5978.  
  5979.  Return Codes 
  5980.  
  5981.           The following codes are valid for ArfRestore: 
  5982.  
  5983.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  5984.                     Γöé RETURN Γöé                                   Γöé
  5985.                     Γöé CODE  Γöé EXPLANATION                             Γöé
  5986.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5987.                     Γöé 0    Γöé Requested function successfully completed              Γöé
  5988.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5989.                     Γöé 1    Γöé Redirect directory does not exist                  Γöé
  5990.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5991.                     Γöé 5    Γöé Redirect directory in use                      Γöé
  5992.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5993.                     Γöé 6    Γöé Port in use                             Γöé
  5994.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5995.                     Γöé 7    Γöé Communications Manager not started                  Γöé
  5996.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5997.                     Γöé 8    Γöé File ACSARF.DAT not found                      Γöé
  5998.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5999.                     Γöé 9    Γöé Error accessing file ACSARF.DAT                   Γöé
  6000.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6001.  
  6002.           Note:  The contents of the redirection configuration data file, 
  6003.                  ACSARF.DAT, are copied to the redirect directory. 
  6004.  
  6005.  
  6006. ΓòÉΓòÉΓòÉ 8.6. ArfSave  ArfSave function ΓòÉΓòÉΓòÉ
  6007.  
  6008. ArfSave 
  6009.  
  6010.           This function changes the current redirection configuration to the 
  6011.           permanent redirection configuration. 
  6012.  
  6013.                     ArfSave()
  6014.  
  6015.  Supplied Parameters 
  6016.  
  6017.           None. 
  6018.  
  6019.  Returned Parameters 
  6020.  
  6021.           None. 
  6022.  
  6023.  Return Codes 
  6024.  
  6025.           The following codes are valid for ArfSave: 
  6026.  
  6027.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6028.                     Γöé RETURN Γöé                                   Γöé
  6029.                     Γöé CODE  Γöé EXPLANATION                             Γöé
  6030.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6031.                     Γöé 0    Γöé Requested function successfully completed              Γöé
  6032.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6033.                     Γöé 1    Γöé Redirect directory does not exist                  Γöé
  6034.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6035.                     Γöé 7    Γöé Communications Manager not started                  Γöé
  6036.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6037.                     Γöé 8    Γöé File ACSARF.DAT not found                      Γöé
  6038.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6039.                     Γöé 9    Γöé Error accessing file ACSARF.DAT                   Γöé
  6040.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6041.  
  6042.           Note:  The contents of the redirect directory are copied to the 
  6043.                  redirection configuration data file, ACSARF.DAT. 
  6044.  
  6045.  
  6046. ΓòÉΓòÉΓòÉ 8.7. ArfUnRedirect ΓòÉΓòÉΓòÉ
  6047.  
  6048. ArfUnRedirect 
  6049.  
  6050.           This function cancels the redirection of a serial port. 
  6051.  
  6052.                     ArfUnRedirect(PortNumber)
  6053.  
  6054.  Supplied Parameters 
  6055.  
  6056.           PortNumber 
  6057.                     A word that specifies the redirected serial port to be 
  6058.                     canceled. The port number must be 1, 2, or 3. 
  6059.  
  6060.  Returned Parameters 
  6061.  
  6062.           None. 
  6063.  
  6064.  Return Codes 
  6065.  
  6066.           The following codes are valid for ArfUnRedirect: 
  6067.  
  6068.                     -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6069.                     Γöé RETURN Γöé                                   Γöé
  6070.                     Γöé CODE  Γöé EXPLANATION                             Γöé
  6071.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6072.                     Γöé 0    Γöé Requested function successfully completed              Γöé
  6073.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6074.                     Γöé 1    Γöé Redirect directory does not exist                  Γöé
  6075.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6076.                     Γöé 2    Γöé Invalid port number                         Γöé
  6077.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6078.                     Γöé 5    Γöé Redirect directory in use                      Γöé
  6079.                     Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6080.                     Γöé 6    Γöé Port in use                             Γöé
  6081.                     ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6082.  
  6083.  
  6084. ΓòÉΓòÉΓòÉ 9. ACDI Return Codes ΓòÉΓòÉΓòÉ
  6085.  
  6086. ACDI returns an indication of the success of the requested operation in the 
  6087. ReturnCode parameter. The only exception is when the verb control block address 
  6088. is not valid. When that occurs, ACDI sets the AX register as follows: 
  6089. AX = X'02'. 
  6090.  
  6091. ACDI Return Codes lists the hexadecimal codes, mnemonics, and descriptions of 
  6092. ACDI return codes. 
  6093.  
  6094.  
  6095. ΓòÉΓòÉΓòÉ 9.1. X'00' to X'09' ΓòÉΓòÉΓòÉ
  6096.  
  6097. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6098. Γöé      ACDI Return Codes                          Γöé
  6099. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6100. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6101. Γöé  CODE Γöé               Γöé                     Γöé
  6102. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6103. Γöé X'00' Γöé "AA_SUCCESSFUL"       Γöé The requested function was successful. Γöé
  6104. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6105. Γöé X'01' Γöé "AA_INVALID_HANDLE"     Γöé Invalid device handle.         Γöé
  6106. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6107. Γöé X'02' Γöé "AA_INVALID_PARM"      Γöé Invalid parameter address.       Γöé
  6108. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6109. Γöé X'03' Γöé "AA_NO_CONNECTION"      Γöé No connection exists.          Γöé
  6110. Γöé    Γöé               Γöé                     Γöé
  6111. Γöé    Γöé               Γöé This return code specifies that the   Γöé
  6112. Γöé    Γöé               Γöé data communication link is not opera-  Γöé
  6113. Γöé    Γöé               Γöé tional at the time the verb is     Γöé
  6114. Γöé    Γöé               Γöé returned.  This return code might be  Γöé
  6115. Γöé    Γöé               Γöé the result of any of the following   Γöé
  6116. Γöé    Γöé               Γöé situations:               Γöé
  6117. Γöé    Γöé               Γöé                     Γöé
  6118. Γöé    Γöé               Γöé o  No connection existed when the   Γöé
  6119. Γöé    Γöé               Γöé   verb was issued.          Γöé
  6120. Γöé    Γöé               Γöé                     Γöé
  6121. Γöé    Γöé               Γöé o  Connection dropped before the    Γöé
  6122. Γöé    Γöé               Γöé   operation on the verb was com-   Γöé
  6123. Γöé    Γöé               Γöé   pleted.               Γöé
  6124. Γöé    Γöé               Γöé                     Γöé
  6125. Γöé    Γöé               Γöé o  A COMDISCONNECT verb was issued by Γöé
  6126. Γöé    Γöé               Γöé   the application before this verb  Γöé
  6127. Γöé    Γöé               Γöé   was returned.            Γöé
  6128. Γöé    Γöé               Γöé                     Γöé
  6129. Γöé    Γöé               Γöé This error is returned on a       Γöé
  6130. Γöé    Γöé               Γöé COMREADCHARSTRING or a COMREADBLOCK   Γöé
  6131. Γöé    Γöé               Γöé verb if a COMCONNECT verb is in     Γöé
  6132. Γöé    Γöé               Γöé progress and the CONNECTTYPE is not 2  Γöé
  6133. Γöé    Γöé               Γöé (auto-dial).  The application is    Γöé
  6134. Γöé    Γöé               Γöé allowed to retrieve call-progress mes- Γöé
  6135. Γöé    Γöé               Γöé sages from the DCE during auto-dialing Γöé
  6136. Γöé    Γöé               Γöé only.                  Γöé
  6137. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6138. Γöé X'04' Γöé "AA_BIT_NOT_ZERO"      Γöé Reserved bits not OFF.         Γöé
  6139. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6140. Γöé X'05' Γöé "AA_NO_V24_CMDS"       Γöé No command string for V.24.       Γöé
  6141. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6142. Γöé X'06' Γöé "AA_CE_TIME_ZERO"      Γöé Carrier exchange time-out must not be  Γöé
  6143. Γöé    Γöé               Γöé 0.                   Γöé
  6144. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6145. Γöé X'07' Γöé "AA_NO_USER_CMDS"      Γöé User-supplied command strings are not  Γöé
  6146. Γöé    Γöé               Γöé allowed.                Γöé
  6147. Γöé    Γöé               Γöé                     Γöé
  6148. Γöé    Γöé               Γöé The network requirements for the spec- Γöé
  6149. Γöé    Γöé               Γöé ified telephone network ID do not    Γöé
  6150. Γöé    Γöé               Γöé allow user-supplied command strings.  Γöé
  6151. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6152. Γöé X'08' Γöé "AA_INVALID_DEV_TYPE"    Γöé Device type is not valid.        Γöé
  6153. Γöé    Γöé               Γöé                     Γöé
  6154. Γöé    Γöé               Γöé The specified device type is not a   Γöé
  6155. Γöé    Γöé               Γöé valid value or the network require-   Γöé
  6156. Γöé    Γöé               Γöé ments for the specified telephone    Γöé
  6157. Γöé    Γöé               Γöé network ID do not allow this device to Γöé
  6158. Γöé    Γöé               Γöé be specified.              Γöé
  6159. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6160. Γöé X'09' Γöé "AA_NO_COUNTRY_ENTRY"    Γöé Could not find telephone network ID in Γöé
  6161. Γöé    Γöé               Γöé telephony homologation file.      Γöé
  6162. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6163.  
  6164.  
  6165. ΓòÉΓòÉΓòÉ 9.2. X'0B' to X'0C' ΓòÉΓòÉΓòÉ
  6166.  
  6167. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6168. Γöé      ACDI Return Codes                          Γöé
  6169. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6170. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6171. Γöé  CODE Γöé               Γöé                     Γöé
  6172. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6173. Γöé X'0B' Γöé "AA_INVALID_DEVICE"     Γöé Invalid device name.          Γöé
  6174. Γöé    Γöé               Γöé                     Γöé
  6175. Γöé    Γöé               Γöé If you redirected your port using ACDI Γöé
  6176. Γöé    Γöé               Γöé Redirection, one of the following sit- Γöé
  6177. Γöé    Γöé               Γöé uations may have occurred:       Γöé
  6178. Γöé    Γöé               Γöé                     Γöé
  6179. Γöé    Γöé               Γöé o  If returned by COMOPEN verb of a  Γöé
  6180. Γöé    Γöé               Γöé   non-redirected port:        Γöé
  6181. Γöé    Γöé               Γöé                     Γöé
  6182. Γöé    Γöé               Γöé   The device name specified is not  Γöé
  6183. Γöé    Γöé               Γöé   COM1, COM2, or COM3.        Γöé
  6184. Γöé    Γöé               Γöé                     Γöé
  6185. Γöé    Γöé               Γöé o  If returned by COMOPEN verb of a  Γöé
  6186. Γöé    Γöé               Γöé   redirected port:          Γöé
  6187. Γöé    Γöé               Γöé                     Γöé
  6188. Γöé    Γöé               Γöé   If the device name is correct    Γöé
  6189. Γöé    Γöé               Γöé   (COM1, COM2, or COM3) and the    Γöé
  6190. Γöé    Γöé               Γöé   device is redirected, this return  Γöé
  6191. Γöé    Γöé               Γöé   code indicates that ACDI was not  Γöé
  6192. Γöé    Γöé               Γöé   able to add the ACDI Redirection  Γöé
  6193. Γöé    Γöé               Γöé   local NETBIOS name to the LAN.   Γöé
  6194. Γöé    Γöé               Γöé   The ACDI Redirection local NETBIOS Γöé
  6195. Γöé    Γöé               Γöé   name is specified in the      Γöé
  6196. Γöé    Γöé               Γöé   CONFIG.SYS file at the end of the  Γöé
  6197. Γöé    Γöé               Γöé   DEVICE=C:\CMLIB\ASYNCDDE.SYS    Γöé
  6198. Γöé    Γöé               Γöé   statement.  The most likely cause  Γöé
  6199. Γöé    Γöé               Γöé   of this error is that the ACDI   Γöé
  6200. Γöé    Γöé               Γöé   Redirection local NETBIOS name   Γöé
  6201. Γöé    Γöé               Γöé   already exists on the LAN.  Ensure Γöé
  6202. Γöé    Γöé               Γöé   that the ACDI Redirection local   Γöé
  6203. Γöé    Γöé               Γöé   NETBIOS name is not being used by  Γöé
  6204. Γöé    Γöé               Γöé   another workstation on the LAN,   Γöé
  6205. Γöé    Γöé               Γöé   and ensure that the ACDI Redi-   Γöé
  6206. Γöé    Γöé               Γöé   rection local NETBIOS name is not  Γöé
  6207. Γöé    Γöé               Γöé   being used by another LAN applica- Γöé
  6208. Γöé    Γöé               Γöé   tion on this workstation.      Γöé
  6209. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6210. Γöé X'0C' Γöé "AA_DOSOPEN_ERROR"      Γöé Device cannot be opened.        Γöé
  6211. Γöé    Γöé               Γöé                     Γöé
  6212. Γöé    Γöé               Γöé If you redirected your port using ACDI Γöé
  6213. Γöé    Γöé               Γöé Redirection, one of the following sit- Γöé
  6214. Γöé    Γöé               Γöé uations may have occurred:       Γöé
  6215. Γöé    Γöé               Γöé                     Γöé
  6216. Γöé    Γöé               Γöé o  If returned by COMOPEN verb of a  Γöé
  6217. Γöé    Γöé               Γöé   non-redirected port:        Γöé
  6218. Γöé    Γöé               Γöé                     Γöé
  6219. Γöé    Γöé               Γöé   ACDI was not able to open the    Γöé
  6220. Γöé    Γöé               Γöé   standard ACDI device driver     Γöé
  6221. Γöé    Γöé               Γöé   (ASYNCDDA.SYS or ASYNCDDB.SYS).   Γöé
  6222. Γöé    Γöé               Γöé                     Γöé
  6223. Γöé    Γöé               Γöé o  If returned by COMOPEN verb of a  Γöé
  6224. Γöé    Γöé               Γöé   redirected port:          Γöé
  6225. Γöé    Γöé               Γöé                     Γöé
  6226. Γöé    Γöé               Γöé   ACDI was not able to open the ACDI Γöé
  6227. Γöé    Γöé               Γöé   Redirection device driver      Γöé
  6228. Γöé    Γöé               Γöé   (ASYNCDDE.SYS).  This error can be Γöé
  6229. Γöé    Γöé               Γöé   caused by NETBIOS not being loaded Γöé
  6230. Γöé    Γöé               Γöé   on the workstation.  This error   Γöé
  6231. Γöé    Γöé               Γöé   also can be caused if ACDI is    Γöé
  6232. Γöé    Γöé               Γöé   redirected to a NETBIOS name that  Γöé
  6233. Γöé    Γöé               Γöé   does not exist on the LAN.  Ensure Γöé
  6234. Γöé    Γöé               Γöé   that the NETBIOS name, to which   Γöé
  6235. Γöé    Γöé               Γöé   ACDI has been redirected, is the  Γöé
  6236. Γöé    Γöé               Γöé   correct name and that it is     Γöé
  6237. Γöé    Γöé               Γöé   entered correctly on the REDIRECT  Γöé
  6238. Γöé    Γöé               Γöé   command.  You may also want to   Γöé
  6239. Γöé    Γöé               Γöé   ensure that the LANACS, to which  Γöé
  6240. Γöé    Γöé               Γöé   the NETBIOS name belongs, is    Γöé
  6241. Γöé    Γöé               Γöé   running.              Γöé
  6242. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6243.  
  6244.  
  6245. ΓòÉΓòÉΓòÉ 9.3. X'0D' to X'35' ΓòÉΓòÉΓòÉ
  6246.  
  6247. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6248. Γöé      ACDI Return Codes                          Γöé
  6249. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6250. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6251. Γöé  CODE Γöé               Γöé                     Γöé
  6252. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6253. Γöé X'0D' Γöé "AA_INCOMPAT_DEVICE"     Γöé The device driver installed is not   Γöé
  6254. Γöé    Γöé               Γöé compatible with the hardware on this  Γöé
  6255. Γöé    Γöé               Γöé machine.  Ensure ASYNCDDA.SYS is    Γöé
  6256. Γöé    Γöé               Γöé installed if you are using an IBM PC  Γöé
  6257. Γöé    Γöé               Γöé AT or equivalent or ASYNCDDB.SYS is   Γöé
  6258. Γöé    Γöé               Γöé installed if you are using an IBM    Γöé
  6259. Γöé    Γöé               Γöé PS/2.  If you are using an IBM PS/2 or Γöé
  6260. Γöé    Γöé               Γöé equivalent that has hardware to     Γöé
  6261. Γöé    Γöé               Γöé support Direct Memory Access (DMA)   Γöé
  6262. Γöé    Γöé               Γöé Asynchronous Communications, you may  Γöé
  6263. Γöé    Γöé               Γöé use either ASYNCDDB.SYS or       Γöé
  6264. Γöé    Γöé               Γöé ASYNCDDC.SYS.              Γöé
  6265. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6266. Γöé X'0E' Γöé "AA_NO_HOMOL_FILE"      Γöé Could not find the telephony      Γöé
  6267. Γöé    Γöé               Γöé homologation file.           Γöé
  6268. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6269. Γöé X'0F' Γöé "AA_NO_REQUIRED_FILE"    Γöé Could not find a required ACDI config- Γöé
  6270. Γöé    Γöé               Γöé uration file.              Γöé
  6271. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6272. Γöé X'10' Γöé "AA_CFI_FLAG_CONFLICT"    Γöé The call failure response flags con-  Γöé
  6273. Γöé    Γöé               Γöé flict for one or more call failure   Γöé
  6274. Γöé    Γöé               Γöé response strings.            Γöé
  6275. Γöé    Γöé               Γöé                     Γöé
  6276. Γöé    Γöé               Γöé For example, at least 2 bits are ON   Γöé
  6277. Γöé    Γöé               Γöé for a single string or no bits are ON  Γöé
  6278. Γöé    Γöé               Γöé for a string that has a length greater Γöé
  6279. Γöé    Γöé               Γöé than 0.                 Γöé
  6280. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6281. Γöé X'11' Γöé "AA_OTHER_REQ"        Γöé Cannot close device.          Γöé
  6282. Γöé    Γöé               Γöé                     Γöé
  6283. Γöé    Γöé               Γöé There are requests in progress and a  Γöé
  6284. Γöé    Γöé               Γöé connection may still exist for this   Γöé
  6285. Γöé    Γöé               Γöé device.  Terminate the outstanding   Γöé
  6286. Γöé    Γöé               Γöé requests and disconnect, if necessary. Γöé
  6287. Γöé    Γöé               Γöé Then reissue the COMCLOSE verb.     Γöé
  6288. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6289. Γöé X'14' Γöé "AA_BPS_INVALID"       Γöé One or both of the specified line    Γöé
  6290. Γöé    Γöé               Γöé speeds (bps) are not supported.     Γöé
  6291. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6292. Γöé X'17' Γöé "AA_BPS_UNDEFINED"      Γöé One or both of the specified line    Γöé
  6293. Γöé    Γöé               Γöé speeds (bps) are not defined.      Γöé
  6294. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6295. Γöé X'2A' Γöé "AA_BPS_DIFFER"       Γöé Transmit and receive bps rates must be Γöé
  6296. Γöé    Γöé               Γöé the same for this device.        Γöé
  6297. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6298. Γöé X'2D' Γöé "AA_STOP_BIT_INVALID"    Γöé Invalid (or unsupported) number of   Γöé
  6299. Γöé    Γöé               Γöé stop bits has been specified.      Γöé
  6300. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6301. Γöé X'2F' Γöé "AA_PARITY_INVALID"     Γöé Invalid (or unsupported) parity has   Γöé
  6302. Γöé    Γöé               Γöé been specified.             Γöé
  6303. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6304. Γöé X'31' Γöé "AA_BIT_INVALID"       Γöé Invalid (or unsupported) number of   Γöé
  6305. Γöé    Γöé               Γöé data bits has been specified.      Γöé
  6306. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6307. Γöé X'32' Γöé "AA_LINE_CTRL_INCOMPAT"   Γöé Incompatible line control settings.   Γöé
  6308. Γöé    Γöé               Γöé                     Γöé
  6309. Γöé    Γöé               Γöé For example, setting 2 stop bits with  Γöé
  6310. Γöé    Γöé               Γöé 5 data bits.  See ComSetLineCtrl    Γöé
  6311. Γöé    Γöé               Γöé (X'05') for valid combinations.     Γöé
  6312. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6313. Γöé X'33' Γöé "AA_UNBLOCKTHREAD_ISSUED"  Γöé Verb was unblocked prematurely because Γöé
  6314. Γöé    Γöé               Γöé a COMUNBLOCKTHREAD verb was received.  Γöé
  6315. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6316. Γöé X'34' Γöé "AA_INVALID_FUNC_CODE"    Γöé Function code of the verb is invalid.  Γöé
  6317. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6318. Γöé X'35' Γöé "AA_AUTO_FLOW_ACTIVE"    Γöé Automatic flow control in progress.   Γöé
  6319. Γöé    Γöé               Γöé 0row.                  Γöé
  6320. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6321.  
  6322.  
  6323. ΓòÉΓòÉΓòÉ 9.4. X'36' to X'3B' ΓòÉΓòÉΓòÉ
  6324.  
  6325. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6326. Γöé      ACDI Return Codes                          Γöé
  6327. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6328. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6329. Γöé  CODE Γöé               Γöé                     Γöé
  6330. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6331. Γöé X'36' Γöé "AA_DEV_OPEN_EXHAUSTED"   Γöé Device already opened by this process  Γöé
  6332. Γöé    Γöé               Γöé or by other processes.         Γöé
  6333. Γöé    Γöé               Γöé                     Γöé
  6334. Γöé    Γöé               Γöé NOTE:  If the device has already been  Γöé
  6335. Γöé    Γöé               Γöé     opened by other processes, this Γöé
  6336. Γöé    Γöé               Γöé     return code is returned if the  Γöé
  6337. Γöé    Γöé               Γöé     port cannot be shared, if it   Γöé
  6338. Γöé    Γöé               Γöé     has been opened by the maximum  Γöé
  6339. Γöé    Γöé               Γöé     number of allowed processes, or Γöé
  6340. Γöé    Γöé               Γöé     if it is owned by another    Γöé
  6341. Γöé    Γöé               Γöé     device driver at this time.   Γöé
  6342. Γöé    Γöé               Γöé                     Γöé
  6343. Γöé    Γöé               Γöé If you redirected your port using ACDI Γöé
  6344. Γöé    Γöé               Γöé Redirection, one of the following sit- Γöé
  6345. Γöé    Γöé               Γöé uations may have occurred:       Γöé
  6346. Γöé    Γöé               Γöé                     Γöé
  6347. Γöé    Γöé               Γöé o  If returned by COMOPEN verb of a  Γöé
  6348. Γöé    Γöé               Γöé   non-redirected port:        Γöé
  6349. Γöé    Γöé               Γöé                     Γöé
  6350. Γöé    Γöé               Γöé   ACDI is not able to open the    Γöé
  6351. Γöé    Γöé               Γöé   serial port because the port is   Γöé
  6352. Γöé    Γöé               Γöé   temporarily being used by another  Γöé
  6353. Γöé    Γöé               Γöé   device driver (such as COM01.SYS  Γöé
  6354. Γöé    Γöé               Γöé   or COM02.SYS).  Try again later.  Γöé
  6355. Γöé    Γöé               Γöé                     Γöé
  6356. Γöé    Γöé               Γöé o  If returned by COMOPEN verb of a  Γöé
  6357. Γöé    Γöé               Γöé   redirected port:          Γöé
  6358. Γöé    Γöé               Γöé                     Γöé
  6359. Γöé    Γöé               Γöé   ACDI is not able to open a remote  Γöé
  6360. Γöé    Γöé               Γöé   serial port because the remote   Γöé
  6361. Γöé    Γöé               Γöé   serial port is temporarily being  Γöé
  6362. Γöé    Γöé               Γöé   used by another workstation.  Try  Γöé
  6363. Γöé    Γöé               Γöé   again later.            Γöé
  6364. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6365. Γöé X'37' Γöé "AA_OUT_CANCELLED"      Γöé Processing cancelled by the       Γöé
  6366. Γöé    Γöé               Γöé COMFLUSHOUTPUT verb.          Γöé
  6367. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6368. Γöé X'38' Γöé "AA_WRITE_OUTSTANDING"    Γöé An outstanding COMWRITECHARSTRING verb Γöé
  6369. Γöé    Γöé               Γöé exists for this process and handle.   Γöé
  6370. Γöé    Γöé               Γöé                     Γöé
  6371. Γöé    Γöé               Γöé This error is returned on the      Γöé
  6372. Γöé    Γöé               Γöé COMDEFOUTPUTBUFF verb to allow the   Γöé
  6373. Γöé    Γöé               Γöé application to flush or drain the    Γöé
  6374. Γöé    Γöé               Γöé output buffer, redefine the buffer,   Γöé
  6375. Γöé    Γöé               Γöé and reissue the write request.     Γöé
  6376. Γöé    Γöé               Γöé                     Γöé
  6377. Γöé    Γöé               Γöé This error is also returned on the   Γöé
  6378. Γöé    Γöé               Γöé COMDRAINOUTPUT verb.  The drain and   Γöé
  6379. Γöé    Γöé               Γöé the write functions are opposing func- Γöé
  6380. Γöé    Γöé               Γöé tions.                 Γöé
  6381. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6382. Γöé X'39' Γöé "AA_XON_GE_XOFF"       Γöé The specified XOFF buffer level is   Γöé
  6383. Γöé    Γöé               Γöé greater than or equal to the XON    Γöé
  6384. Γöé    Γöé               Γöé buffer level.              Γöé
  6385. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6386. Γöé X'3A' Γöé "AA_INPUT_CANCELLED"     Γöé Verb cancelled by a COMFLUSHINPUT    Γöé
  6387. Γöé    Γöé               Γöé verb.                  Γöé
  6388. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6389. Γöé X'3B' Γöé "AA_IO_BUFF_UNDEFINED"    Γöé The input buffer or the output buffer  Γöé
  6390. Γöé    Γöé               Γöé has not been defined.          Γöé
  6391. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6392.  
  6393.  
  6394. ΓòÉΓòÉΓòÉ 9.5. X'3C' to X'4E' ΓòÉΓòÉΓòÉ
  6395.  
  6396. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6397. Γöé      ACDI Return Codes                          Γöé
  6398. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6399. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6400. Γöé  CODE Γöé               Γöé                     Γöé
  6401. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6402. Γöé X'3C' Γöé "AA_IO_CMD_OUTSTANDING"   Γöé A previous I/O request is still in   Γöé
  6403. Γöé    Γöé               Γöé progress.                Γöé
  6404. Γöé    Γöé               Γöé                     Γöé
  6405. Γöé    Γöé               Γöé One of the following conditions is   Γöé
  6406. Γöé    Γöé               Γöé present:                Γöé
  6407. Γöé    Γöé               Γöé                     Γöé
  6408. Γöé    Γöé               Γöé o  A previous COMWRITECHARSTRING verb Γöé
  6409. Γöé    Γöé               Γöé   is still in progress if returned  Γöé
  6410. Γöé    Γöé               Γöé   on a COMWRITECHARSTRING verb.    Γöé
  6411. Γöé    Γöé               Γöé                     Γöé
  6412. Γöé    Γöé               Γöé o  A previous COMTRANSIMM verb is   Γöé
  6413. Γöé    Γöé               Γöé   still in progress if returned on a Γöé
  6414. Γöé    Γöé               Γöé   COMTRANSIMM verb.          Γöé
  6415. Γöé    Γöé               Γöé                     Γöé
  6416. Γöé    Γöé               Γöé o  A previous COMREADCHARSTRING verb  Γöé
  6417. Γöé    Γöé               Γöé   is still in progress if returned  Γöé
  6418. Γöé    Γöé               Γöé   on a COMREADCHARSTRING verb.    Γöé
  6419. Γöé    Γöé               Γöé                     Γöé
  6420. Γöé    Γöé               Γöé o  A previous COMREADBLOCK verb is   Γöé
  6421. Γöé    Γöé               Γöé   still in progress if returned on a Γöé
  6422. Γöé    Γöé               Γöé   COMREADBLOCK verb.         Γöé
  6423. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6424. Γöé X'3D' Γöé "AA_BUFF_LEVEL_INVALID"   Γöé Buffer level is invalid.  A buffer   Γöé
  6425. Γöé    Γöé               Γöé level is invalid if it is 0 or larger  Γöé
  6426. Γöé    Γöé               Γöé than the usable size of the applica-  Γöé
  6427. Γöé    Γöé               Γöé tion input data buffer.  See      Γöé
  6428. Γöé    Γöé               Γöé ComDefInput (X'14') for more informa-  Γöé
  6429. Γöé    Γöé               Γöé tion on the usable size of the buffer. Γöé
  6430. Γöé    Γöé               Γöé This error can be caused by setting   Γöé
  6431. Γöé    Γöé               Γöé the XON buffer to a greater value than Γöé
  6432. Γöé    Γöé               Γöé the application input buffer.      Γöé
  6433. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6434. Γöé X'3E' Γöé "AA_EXCESS_BLOCKS"      Γöé More than 128 blocks possible in    Γöé
  6435. Γöé    Γöé               Γöé buffer.  This is a warning that is   Γöé
  6436. Γöé    Γöé               Γöé returned for a fixed-length block    Γöé
  6437. Γöé    Γöé               Γöé input mode.  It is just a warning and  Γöé
  6438. Γöé    Γöé               Γöé the new input buffer and mode have   Γöé
  6439. Γöé    Γöé               Γöé been defined and are active.      Γöé
  6440. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6441. Γöé X'3F' Γöé "AA_READ_OUTSTANDING"    Γöé A COMREADCHARSTRING or COMREADBLOCK   Γöé
  6442. Γöé    Γöé               Γöé verb is outstanding for this process.  Γöé
  6443. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6444. Γöé X'40' Γöé "AA_DURATION_INVALID"    Γöé Specified duration is invalid.     Γöé
  6445. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6446. Γöé X'44' Γöé "AA_SEMAPHORE_INVALID"    Γöé Invalid semaphore handle.        Γöé
  6447. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6448. Γöé X'45' Γöé "AA_LOCK_FAILURE"      Γöé Data segment cannot be locked.  The   Γöé
  6449. Γöé    Γöé               Γöé previously defined input buffer has   Γöé
  6450. Γöé    Γöé               Γöé been unlocked if returned on a     Γöé
  6451. Γöé    Γöé               Γöé COMDEFINPUT verb, or the previously   Γöé
  6452. Γöé    Γöé               Γöé defined output buffer has been     Γöé
  6453. Γöé    Γöé               Γöé unlocked if returned on a        Γöé
  6454. Γöé    Γöé               Γöé COMDEFOUTPUTBUFF verb.         Γöé
  6455. Γöé    Γöé               Γöé                     Γöé
  6456. Γöé    Γöé               Γöé NOTE:  When this return code is     Γöé
  6457. Γöé    Γöé               Γöé     returned, ACDI assumes it has  Γöé
  6458. Γöé    Γöé               Γöé     no buffer defined (either input Γöé
  6459. Γöé    Γöé               Γöé     or output, depending on which  Γöé
  6460. Γöé    Γöé               Γöé     verb returned the error).    Γöé
  6461. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6462. Γöé X'49' Γöé "AA_MODE_REQ_INVALID"    Γöé The requested mode is invalid.     Γöé
  6463. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6464. Γöé X'4B' Γöé "AA_EOB_INVALID"       Γöé Invalid string length or number of   Γöé
  6465. Γöé    Γöé               Γöé strings.                Γöé
  6466. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6467. Γöé X'4E' Γöé "AA_BUFF_NOT_EMPTY"     Γöé Output buffer is not empty yet.     Γöé
  6468. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6469.  
  6470.  
  6471. ΓòÉΓòÉΓòÉ 9.6. X'51' to X'54' ΓòÉΓòÉΓòÉ
  6472.  
  6473. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6474. Γöé      ACDI Return Codes                          Γöé
  6475. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6476. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6477. Γöé  CODE Γöé               Γöé                     Γöé
  6478. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6479. Γöé X'51' Γöé "AA_BUFF_OVERRUN"      Γöé BYTESWRITTEN is larger than the avail- Γöé
  6480. Γöé    Γöé               Γöé able space in the application output  Γöé
  6481. Γöé    Γöé               Γöé buffer.                 Γöé
  6482. Γöé    Γöé               Γöé                     Γöé
  6483. Γöé    Γöé               Γöé This is considered a critical error.  Γöé
  6484. Γöé    Γöé               Γöé Before returning this error, ACDI sets Γöé
  6485. Γöé    Γöé               Γöé NEXTAVAILWRITEPTR to the beginning of  Γöé
  6486. Γöé    Γöé               Γöé the output buffer and          Γöé
  6487. Γöé    Γöé               Γöé NEXTAVAILWRITELGTH to the output    Γöé
  6488. Γöé    Γöé               Γöé buffer size.              Γöé
  6489. Γöé    Γöé               Γöé                     Γöé
  6490. Γöé    Γöé               Γöé Asynchronous I/O buffers should be   Γöé
  6491. Γöé    Γöé               Γöé defined such that the maximum number  Γöé
  6492. Γöé    Γöé               Γöé of characters (that a single view of  Γöé
  6493. Γöé    Γöé               Γöé the buffer would indicate) is one less Γöé
  6494. Γöé    Γöé               Γöé than the total size of the buffer; for Γöé
  6495. Γöé    Γöé               Γöé example, the maximum amount of data   Γöé
  6496. Γöé    Γöé               Γöé that can be in the buffer at any one  Γöé
  6497. Γöé    Γöé               Γöé time is the buffer size minus 1 byte.  Γöé
  6498. Γöé    Γöé               Γöé The output buffer size should be at   Γöé
  6499. Γöé    Γöé               Γöé least 1 byte larger than the maximum  Γöé
  6500. Γöé    Γöé               Γöé number of bytes written by a single   Γöé
  6501. Γöé    Γöé               Γöé COMWRITECHARSTRING verb.        Γöé
  6502. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6503. Γöé X'52' Γöé "AA_BYTE_NEED_OVERRUN"    Γöé The parameter for bytes needed is    Γöé
  6504. Γöé    Γöé               Γöé larger than the usable space of the   Γöé
  6505. Γöé    Γöé               Γöé process buffer.  ACDI returns without  Γöé
  6506. Γöé    Γöé               Γöé performing any read or write function. Γöé
  6507. Γöé    Γöé               Γöé                     Γöé
  6508. Γöé    Γöé               Γöé Asynchronous I/O buffers should be   Γöé
  6509. Γöé    Γöé               Γöé defined such that the maximum number  Γöé
  6510. Γöé    Γöé               Γöé of characters (that a single view of  Γöé
  6511. Γöé    Γöé               Γöé the buffer would indicate) is one byte Γöé
  6512. Γöé    Γöé               Γöé less than the total size of the     Γöé
  6513. Γöé    Γöé               Γöé buffer.  For example, the maximum    Γöé
  6514. Γöé    Γöé               Γöé amount of data that could be in the   Γöé
  6515. Γöé    Γöé               Γöé buffer at any one time is the buffer  Γöé
  6516. Γöé    Γöé               Γöé size minus 1 byte.           Γöé
  6517. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6518. Γöé X'53' Γöé "AA_TIMEOUT_XOFF"      Γöé Time-out exceeded while in XOFF state. Γöé
  6519. Γöé    Γöé               Γöé                     Γöé
  6520. Γöé    Γöé               Γöé For the COMREADCHARSTRING and      Γöé
  6521. Γöé    Γöé               Γöé COMREADBLOCK verbs, ACDI has put the  Γöé
  6522. Γöé    Γöé               Γöé characters received (if any) prior to  Γöé
  6523. Γöé    Γöé               Γöé the time-out in the input buffer and  Γöé
  6524. Γöé    Γöé               Γöé adjusted the returned buffer parame-  Γöé
  6525. Γöé    Γöé               Γöé ters (NEXTAVAILREADPTR and       Γöé
  6526. Γöé    Γöé               Γöé NEXTAVAILREADLGTH), accordingly.  This Γöé
  6527. Γöé    Γöé               Γöé is returned if an XOFF has been sent.  Γöé
  6528. Γöé    Γöé               Γöé                     Γöé
  6529. Γöé    Γöé               Γöé For the COMWRITECHARSTRING verb, ACDI  Γöé
  6530. Γöé    Γöé               Γöé has adjusted the returned parameters  Γöé
  6531. Γöé    Γöé               Γöé (NEXTAVAILWRITEPTR and         Γöé
  6532. Γöé    Γöé               Γöé NEXTAVAILWRITELGTH) to correctly    Γöé
  6533. Γöé    Γöé               Γöé reflect the actual free bytes avail-  Γöé
  6534. Γöé    Γöé               Γöé able in the output buffer.  This is   Γöé
  6535. Γöé    Γöé               Γöé returned if the application has issued Γöé
  6536. Γöé    Γöé               Γöé a COMSTOPTRANS or received an XOFF.   Γöé
  6537. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6538. Γöé X'54' Γöé "AA_TIMEOUT_XON"       Γöé Time-out occurred while not in XOFF   Γöé
  6539. Γöé    Γöé               Γöé state.                 Γöé
  6540. Γöé    Γöé               Γöé                     Γöé
  6541. Γöé    Γöé               Γöé For the COMREADCHARSTRING and      Γöé
  6542. Γöé    Γöé               Γöé COMREADBLOCK verbs, ACDI has put the  Γöé
  6543. Γöé    Γöé               Γöé characters received (if any) prior to  Γöé
  6544. Γöé    Γöé               Γöé the time-out in the input buffer and  Γöé
  6545. Γöé    Γöé               Γöé adjusted the returned buffer parame-  Γöé
  6546. Γöé    Γöé               Γöé ters (NEXTAVAILREADPTR and       Γöé
  6547. Γöé    Γöé               Γöé NEXTAVAILREADLGTH) accordingly.     Γöé
  6548. Γöé    Γöé               Γöé                     Γöé
  6549. Γöé    Γöé               Γöé For the COMWRITECHARSTRING verb, ACDI  Γöé
  6550. Γöé    Γöé               Γöé has adjusted the returned parameters  Γöé
  6551. Γöé    Γöé               Γöé (NEXTAVAILWRITEPTR and         Γöé
  6552. Γöé    Γöé               Γöé NEXTAVAILWRITELGTH) to correctly    Γöé
  6553. Γöé    Γöé               Γöé reflect the actual bytes available in  Γöé
  6554. Γöé    Γöé               Γöé the output buffer.           Γöé
  6555. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6556.  
  6557.  
  6558. ΓòÉΓòÉΓòÉ 9.7. X'55' to X'61' ΓòÉΓòÉΓòÉ
  6559.  
  6560. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6561. Γöé      ACDI Return Codes                          Γöé
  6562. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6563. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6564. Γöé  CODE Γöé               Γöé                     Γöé
  6565. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6566. Γöé X'55' Γöé "AA_DATA_ERR"        Γöé The data contains an error (parity or  Γöé
  6567. Γöé    Γöé               Γöé framing) or is incomplete (overflow or Γöé
  6568. Γöé    Γöé               Γöé overrun). The thread of execution is  Γöé
  6569. Γöé    Γöé               Γöé returned to prevent an infinite wait  Γöé
  6570. Γöé    Γöé               Γöé in case the end of the block string   Γöé
  6571. Γöé    Γöé               Γöé was corrupted or lost by the errors in Γöé
  6572. Γöé    Γöé               Γöé the data.  The data has been placed   Γöé
  6573. Γöé    Γöé               Γöé into the input buffer, and the     Γöé
  6574. Γöé    Γöé               Γöé pointers have been adjusted accord-   Γöé
  6575. Γöé    Γöé               Γöé ingly.  The READERRORMASK parameter is Γöé
  6576. Γöé    Γöé               Γöé updated to reflect the error.      Γöé
  6577. Γöé    Γöé               Γöé                     Γöé
  6578. Γöé    Γöé               Γöé NOTE:  This return code is returned   Γöé
  6579. Γöé    Γöé               Γöé     only in variable-length block  Γöé
  6580. Γöé    Γöé               Γöé     mode.              Γöé
  6581. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6582. Γöé X'57' Γöé "AA_BLOCK_MODE"       Γöé This verb is not valid in the current  Γöé
  6583. Γöé    Γöé               Γöé input mode. For example, COMREADBLOCK  Γöé
  6584. Γöé    Γöé               Γöé is not valid in character input mode.  Γöé
  6585. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6586. Γöé X'59' Γöé "AA_BYTES_FREE_OVERRUN"   Γöé BYTEFREED is larger than the number of Γöé
  6587. Γöé    Γöé               Γöé available characters returned in    Γöé
  6588. Γöé    Γöé               Γöé NEXTAVAILREADLGTH on the previous    Γöé
  6589. Γöé    Γöé               Γöé COMREADCHARSTRING verb.  This is con-  Γöé
  6590. Γöé    Γöé               Γöé sidered a critical error.        Γöé
  6591. Γöé    Γöé               Γöé NEXTAVAILREADLGTH is set to 0, and   Γöé
  6592. Γöé    Γöé               Γöé NEXTAVAILREADPTR is set to the start  Γöé
  6593. Γöé    Γöé               Γöé of the input buffer.  Subsequent input Γöé
  6594. Γöé    Γöé               Γöé data begins from that point.      Γöé
  6595. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6596. Γöé X'5C' Γöé "AA_BLOCK_SIZE_INVALID"   Γöé Invalid block or buffer size.  You   Γöé
  6597. Γöé    Γöé               Γöé have attempted to define a block (in  Γöé
  6598. Γöé    Γöé               Γöé fixed-length block mode) or a buffer  Γöé
  6599. Γöé    Γöé               Γöé (either input or output) that is not  Γöé
  6600. Γöé    Γöé               Γöé valid.  See the description of the   Γöé
  6601. Γöé    Γöé               Γöé appropriate verb for valid sizes.    Γöé
  6602. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6603. Γöé X'5D' Γöé "AA_BUFF_SIZE_INVALID"    Γöé The input buffer is smaller than the  Γöé
  6604. Γöé    Γöé               Γöé block size.  This error is only issued Γöé
  6605. Γöé    Γöé               Γöé when the input mode is fixed-length   Γöé
  6606. Γöé    Γöé               Γöé block.                 Γöé
  6607. Γöé    Γöé               Γöé                     Γöé
  6608. Γöé    Γöé               Γöé Asynchronous I/O buffers should be   Γöé
  6609. Γöé    Γöé               Γöé defined such that the maximum number  Γöé
  6610. Γöé    Γöé               Γöé of characters (that a single view of  Γöé
  6611. Γöé    Γöé               Γöé the buffer would indicate) is one less Γöé
  6612. Γöé    Γöé               Γöé than the total size of the buffer; for Γöé
  6613. Γöé    Γöé               Γöé example, the maximum amount of data   Γöé
  6614. Γöé    Γöé               Γöé that can be in the buffer at any one  Γöé
  6615. Γöé    Γöé               Γöé time is the buffer size minus 1 byte.  Γöé
  6616. Γöé    Γöé               Γöé The input buffer size should be at   Γöé
  6617. Γöé    Γöé               Γöé least 1 byte larger than the fixed-   Γöé
  6618. Γöé    Γöé               Γöé length block size.           Γöé
  6619. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6620. Γöé X'5E' Γöé "AA_REC_SIZE_OVERRUN"    Γöé The input buffer is full, but the    Γöé
  6621. Γöé    Γöé               Γöé specified end-of-block strings have   Γöé
  6622. Γöé    Γöé               Γöé not been received yet.         Γöé
  6623. Γöé    Γöé               Γöé NEXTAVAILBLKPTR is set to the start of Γöé
  6624. Γöé    Γöé               Γöé data and NEXTAVAILREADLGTH is set to  Γöé
  6625. Γöé    Γöé               Γöé the input buffer size.         Γöé
  6626. Γöé    Γöé               Γöé                     Γöé
  6627. Γöé    Γöé               Γöé The application should process the   Γöé
  6628. Γöé    Γöé               Γöé input buffer and issue the       Γöé
  6629. Γöé    Γöé               Γöé COMREADBLOCK verb again if an end-of-  Γöé
  6630. Γöé    Γöé               Γöé block string is not found (the block  Γöé
  6631. Γöé    Γöé               Γöé may be very large and the end may not  Γöé
  6632. Γöé    Γöé               Γöé have been received yet).        Γöé
  6633. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6634. Γöé X'61' Γöé "AA_NO_DCE_RESPONSE"     Γöé The DCE hardware is not responding.   Γöé
  6635. Γöé    Γöé               Γöé The CTS signal was not asserted within Γöé
  6636. Γöé    Γöé               Γöé 10 seconds of ACDI asserting RTS.  No  Γöé
  6637. Γöé    Γöé               Γöé connection was made.          Γöé
  6638. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6639.  
  6640.  
  6641. ΓòÉΓòÉΓòÉ 9.8. X'62' to X'7B' ΓòÉΓòÉΓòÉ
  6642.  
  6643. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6644. Γöé      ACDI Return Codes                          Γöé
  6645. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6646. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6647. Γöé  CODE Γöé               Γöé                     Γöé
  6648. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6649. Γöé X'62' Γöé "AA_TIMEOUT_INVALID"     Γöé Invalid time-out.  The requested    Γöé
  6650. Γöé    Γöé               Γöé INITIALWAIT time is invalid if     Γöé
  6651. Γöé    Γöé               Γöé returned on a COMREADCHARSTRING verb.  Γöé
  6652. Γöé    Γöé               Γöé Any of the time-outs specified on the  Γöé
  6653. Γöé    Γöé               Γöé COMSETTIMEOUT verb are also invalid.  Γöé
  6654. Γöé    Γöé               Γöé The requested READTIMEOUTCHAR time is  Γöé
  6655. Γöé    Γöé               Γöé invalid if returned on a        Γöé
  6656. Γöé    Γöé               Γöé COMREADCHARSTRING verb or the      Γöé
  6657. Γöé    Γöé               Γöé requested CONNECTTIMEOUT time is    Γöé
  6658. Γöé    Γöé               Γöé invalid if returned on a COMCONNECT   Γöé
  6659. Γöé    Γöé               Γöé verb.  See the appropriate parameter  Γöé
  6660. Γöé    Γöé               Γöé description for valid values.      Γöé
  6661. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6662. Γöé X'63' Γöé "AA_NEGATED_DSR_VIOLATION"  Γöé The DSR signal was not negated for at  Γöé
  6663. Γöé    Γöé               Γöé least 100 milliseconds prior to     Γöé
  6664. Γöé    Γöé               Γöé attempting a call connection with the  Γöé
  6665. Γöé    Γöé               Γöé attached V.25bis or V.24 DCE.  No con- Γöé
  6666. Γöé    Γöé               Γöé nection was made.            Γöé
  6667. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6668. Γöé X'65' Γöé "AA_CALL_VIOLATION"     Γöé Call attempt violates regulations of  Γöé
  6669. Γöé    Γöé               Γöé the attached network.  No call is    Γöé
  6670. Γöé    Γöé               Γöé made.                  Γöé
  6671. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6672. Γöé X'66' Γöé "AA_CALL_COUNT_EXCEEDED"   Γöé Call attempt cannot be made because   Γöé
  6673. Γöé    Γöé               Γöé system resources are exhausted.     Γöé
  6674. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6675. Γöé X'67' Γöé "AA_TIMEOUT"         Γöé Time-out occurred on a COMCONNECT    Γöé
  6676. Γöé    Γöé               Γöé verb.                  Γöé
  6677. Γöé    Γöé               Γöé                     Γöé
  6678. Γöé    Γöé               Γöé The call is attempted by ACDI.  If the Γöé
  6679. Γöé    Γöé               Γöé attempt is unsuccessful, call attempt  Γöé
  6680. Γöé    Γöé               Γöé failed (X'67') is returned.  The pos-  Γöé
  6681. Γöé    Γöé               Γöé sible reasons for failure are:     Γöé
  6682. Γöé    Γöé               Γöé                     Γöé
  6683. Γöé    Γöé               Γöé o  The DCE rejected one or more of   Γöé
  6684. Γöé    Γöé               Γöé   the commands in the command     Γöé
  6685. Γöé    Γöé               Γöé   string.               Γöé
  6686. Γöé    Γöé               Γöé                     Γöé
  6687. Γöé    Γöé               Γöé o  A call collision occurred.     Γöé
  6688. Γöé    Γöé               Γöé                     Γöé
  6689. Γöé    Γöé               Γöé o  No call failure indication or con- Γöé
  6690. Γöé    Γöé               Γöé   nection indication was detected   Γöé
  6691. Γöé    Γöé               Γöé   prior to the expiration of the   Γöé
  6692. Γöé    Γöé               Γöé   time-out timer.           Γöé
  6693. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6694. Γöé X'69' Γöé "AA_PORT_IN_USE"       Γöé The physical port is being used for a  Γöé
  6695. Γöé    Γöé               Γöé connection at this time.  The applica- Γöé
  6696. Γöé    Γöé               Γöé tion must either wait to issue the   Γöé
  6697. Γöé    Γöé               Γöé verb later or use another device.    Γöé
  6698. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6699. Γöé X'6C' Γöé "AA_NETWORK_REQ_ERROR"    Γöé The requested connection time-out    Γöé
  6700. Γöé    Γöé               Γöé value violates the network require-   Γöé
  6701. Γöé    Γöé               Γöé ments.                 Γöé
  6702. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6703. Γöé X'6D' Γöé "AA_CONNECT_SWITCHED"    Γöé Successful switched connection.  This  Γöé
  6704. Γöé    Γöé               Γöé return code returns only when      Γöé
  6705. Γöé    Γöé               Γöé CONNECTTYPE=4.             Γöé
  6706. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6707. Γöé X'6E' Γöé "AA_CONNECT_NONSWITCHED"   Γöé Successful non-switched connection.   Γöé
  6708. Γöé    Γöé               Γöé This return code returns only when   Γöé
  6709. Γöé    Γöé               Γöé CONNECTTYPE=4.             Γöé
  6710. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6711. Γöé X'71' Γöé "AA_FUNC_INVALID_FOR_DEVICE"Γöé The connect type is not supported for  Γöé
  6712. Γöé    Γöé               Γöé this device.  This error is returned  Γöé
  6713. Γöé    Γöé               Γöé when a requested function cannot be   Γöé
  6714. Γöé    Γöé               Γöé accommodated by the target device.   Γöé
  6715. Γöé    Γöé               Γöé For example, some devices do not    Γöé
  6716. Γöé    Γöé               Γöé support auto-dialing or auto-      Γöé
  6717. Γöé    Γöé               Γöé answering.  Another example would be a Γöé
  6718. Γöé    Γöé               Γöé manual call request for non-switched  Γöé
  6719. Γöé    Γöé               Γöé data connection such as issuing a con- Γöé
  6720. Γöé    Γöé               Γöé nection with CONNECTTYPE=1.       Γöé
  6721. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6722. Γöé X'7B' Γöé "AA_CALL_COLLISION"     Γöé Call collision occurred.  A call col-  Γöé
  6723. Γöé    Γöé               Γöé lision occurs only when an incoming   Γöé
  6724. Γöé    Γöé               Γöé call is detected while an outgoing   Γöé
  6725. Γöé    Γöé               Γöé call (either manual dialing or auto-  Γöé
  6726. Γöé    Γöé               Γöé dialing) is being tried.  No con-    Γöé
  6727. Γöé    Γöé               Γöé nection is made.            Γöé
  6728. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6729.  
  6730.  
  6731. ΓòÉΓòÉΓòÉ 9.9. X'80' to X'FF' ΓòÉΓòÉΓòÉ
  6732.  
  6733. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6734. Γöé      ACDI Return Codes                          Γöé
  6735. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6736. Γöé  HEX  Γöé MNEMONIC           Γöé DESCRIPTION               Γöé
  6737. Γöé  CODE Γöé               Γöé                     Γöé
  6738. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6739. Γöé X'80' Γöé "AA_DEST_NO_HANGUP"     Γöé Time-out occurred on disconnect.  The  Γöé
  6740. Γöé    Γöé               Γöé line was not freed after on-hook    Γöé
  6741. Γöé    Γöé               Γöé placement.  The user should manually  Γöé
  6742. Γöé    Γöé               Γöé verify on-hook condition.        Γöé
  6743. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6744. Γöé X'F0' Γöé "AA_RESERVED_BYTE"      Γöé The reserved byte is not 0.       Γöé
  6745. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6746. Γöé X'F1' Γöé "AA_OS2_ERROR"        Γöé An OS/2 error occurred during exe-   Γöé
  6747. Γöé    Γöé               Γöé cution.                 Γöé
  6748. Γöé    Γöé               Γöé                     Γöé
  6749. Γöé    Γöé               Γöé If you redirected your port using ACDI Γöé
  6750. Γöé    Γöé               Γöé Redirection, one of the following sit- Γöé
  6751. Γöé    Γöé               Γöé uations may have occurred:       Γöé
  6752. Γöé    Γöé               Γöé                     Γöé
  6753. Γöé    Γöé               Γöé o  If returned by an ACDI verb of a  Γöé
  6754. Γöé    Γöé               Γöé   non-redirected port:        Γöé
  6755. Γöé    Γöé               Γöé                     Γöé
  6756. Γöé    Γöé               Γöé   ACDI received an error return code Γöé
  6757. Γöé    Γöé               Γöé   from an operating system call.   Γöé
  6758. Γöé    Γöé               Γöé                     Γöé
  6759. Γöé    Γöé               Γöé o  If returned by an ACDI verb of a  Γöé
  6760. Γöé    Γöé               Γöé   redirected port:          Γöé
  6761. Γöé    Γöé               Γöé                     Γöé
  6762. Γöé    Γöé               Γöé   ACDI received an error return code Γöé
  6763. Γöé    Γöé               Γöé   from an operating system call, or  Γöé
  6764. Γöé    Γöé               Γöé   the NETBIOS session to the remote  Γöé
  6765. Γöé    Γöé               Γöé   serial port has been lost.  This  Γöé
  6766. Γöé    Γöé               Γöé   error may occur if the LAN commu-  Γöé
  6767. Γöé    Γöé               Γöé   nication ends or if the LANACS   Γöé
  6768. Γöé    Γöé               Γöé   communication ends while ACDI is  Γöé
  6769. Γöé    Γöé               Γöé   using a redirected port.      Γöé
  6770. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6771. Γöé X'F4' Γöé "AA_BAD_VERSION"       Γöé Invalid version of ACDI.        Γöé
  6772. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6773. Γöé X'FF' Γöé "AA_STOPPED_OR_NOT_STARTED" Γöé ACDI has been started or stopped.  If  Γöé
  6774. Γöé    Γöé               Γöé ACDI has been stopped by an abnormal  Γöé
  6775. Γöé    Γöé               Γöé stop, then your application must end  Γöé
  6776. Γöé    Γöé               Γöé before ACDI can be restarted.      Γöé
  6777. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6778.  
  6779.  
  6780. ΓòÉΓòÉΓòÉ 10. ACDI Redirection API Return Codes ΓòÉΓòÉΓòÉ
  6781.  
  6782. ACDI Redirection displays an indication of the success of the requested 
  6783. operation in the ReturnCode parameter. 
  6784.  
  6785. API Return Codes lists the ACDI Redirection return codes and mnemonics. 
  6786.  
  6787. -ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ+
  6788. Γöé      API Return Codes                           Γöé
  6789. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6790. Γöé RETURN Γöé                  Γöé                 Γöé
  6791. Γöé  CODE  Γöé MNEMONIC              Γöé DESCRIPTION           Γöé
  6792. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6793. Γöé   0  Γöé "AR_SUCCESSFUL"          Γöé Requested function successfully Γöé
  6794. Γöé     Γöé                  Γöé completed.            Γöé
  6795. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6796. Γöé   1  Γöé "AR_ACDI_NOT_STARTED"       Γöé Redirect directory does not   Γöé
  6797. Γöé     Γöé                  Γöé exist.  Either ACDI has not   Γöé
  6798. Γöé     Γöé                  Γöé been started, or the redi-    Γöé
  6799. Γöé     Γöé                  Γöé rection configuration data    Γöé
  6800. Γöé     Γöé                  Γöé file, ACSARF.DAT, is missing   Γöé
  6801. Γöé     Γöé                  Γöé from the \CMLIB directory.  The Γöé
  6802. Γöé     Γöé                  Γöé redirect directory is a shared  Γöé
  6803. Γöé     Γöé                  Γöé memory segment owned by ACDI.  Γöé
  6804. Γöé     Γöé                  Γöé When ACDI starts, it creates   Γöé
  6805. Γöé     Γöé                  Γöé the redirect directory and    Γöé
  6806. Γöé     Γöé                  Γöé copies the contents of the    Γöé
  6807. Γöé     Γöé                  Γöé redirection configuration data  Γöé
  6808. Γöé     Γöé                  Γöé file, ACSARF.DAT, into the    Γöé
  6809. Γöé     Γöé                  Γöé redirect directory.  If the   Γöé
  6810. Γöé     Γöé                  Γöé redirection configuration file  Γöé
  6811. Γöé     Γöé                  Γöé is missing, ACDI does not    Γöé
  6812. Γöé     Γöé                  Γöé create the redirect directory.  Γöé
  6813. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6814. Γöé   2  Γöé "AR_INVALID_PORT_NUM"       Γöé Invalid port number.  The spec- Γöé
  6815. Γöé     Γöé                  Γöé ified port number is not 1, 2,  Γöé
  6816. Γöé     Γöé                  Γöé or 3.              Γöé
  6817. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6818. Γöé   3  Γöé "AR_INVALID_LAN_NUM"        Γöé Invalid LAN adapter number.   Γöé
  6819. Γöé     Γöé                  Γöé The specified LAN adapter    Γöé
  6820. Γöé     Γöé                  Γöé number is not 0 or 1.      Γöé
  6821. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6822. Γöé   4  Γöé "AR_INVALID_DEST_STR"       Γöé Invalid destination string.   Γöé
  6823. Γöé     Γöé                  Γöé The specified destination    Γöé
  6824. Γöé     Γöé                  Γöé string is longer than 17 char-  Γöé
  6825. Γöé     Γöé                  Γöé acters.             Γöé
  6826. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6827. Γöé   5  Γöé "AR_DIRECTORY_IN_USE"       Γöé Redirect directory in use.    Γöé
  6828. Γöé     Γöé                  Γöé ACDI or another application is  Γöé
  6829. Γöé     Γöé                  Γöé currently modifying the redi-  Γöé
  6830. Γöé     Γöé                  Γöé rect directory.  Only one    Γöé
  6831. Γöé     Γöé                  Γöé application is allowed to    Γöé
  6832. Γöé     Γöé                  Γöé modify the redirect directory  Γöé
  6833. Γöé     Γöé                  Γöé at a time.  Try again later.   Γöé
  6834. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6835. Γöé   6  Γöé "AR_PORT_IN_USE"          Γöé Port in use.  The specified   Γöé
  6836. Γöé     Γöé                  Γöé serial port is currently in   Γöé
  6837. Γöé     Γöé                  Γöé use.  The redirection config-  Γöé
  6838. Γöé     Γöé                  Γöé uration of a serial port cannot Γöé
  6839. Γöé     Γöé                  Γöé be changed while the serial   Γöé
  6840. Γöé     Γöé                  Γöé port is being used.  Wait until Γöé
  6841. Γöé     Γöé                  Γöé the serial port is closed and  Γöé
  6842. Γöé     Γöé                  Γöé then change its redirection   Γöé
  6843. Γöé     Γöé                  Γöé configuration.          Γöé
  6844. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6845. Γöé   7  Γöé "AR_CM_NOT_STARTED"        Γöé Communications Manager not    Γöé
  6846. Γöé     Γöé                  Γöé started.  Unless Communications Γöé
  6847. Γöé     Γöé                  Γöé Manager is started, the ACDI   Γöé
  6848. Γöé     Γöé                  Γöé Redirection API cannot deter-  Γöé
  6849. Γöé     Γöé                  Γöé mine on which volume and direc- Γöé
  6850. Γöé     Γöé                  Γöé tory to save, restore, or    Γöé
  6851. Γöé     Γöé                  Γöé create the redirection config-  Γöé
  6852. Γöé     Γöé                  Γöé uration data file, ACSARF.DAT.  Γöé
  6853. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6854. Γöé   8  Γöé "AR_DATA_FILE_NOT_FOUND"      Γöé File ACSARF.DAT not found.    Γöé
  6855. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6856. Γöé   9  Γöé "AR_BAD_DATA_FILE"         Γöé Error accessing file       Γöé
  6857. Γöé     Γöé                  Γöé ACSARF.DAT.           Γöé
  6858. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6859. Γöé  10  Γöé "AR_DATA_FILE_ALREADY_EXISTS"   Γöé File ACSARF.DAT already exists. Γöé
  6860. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6861.