home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / REXHLAPI.ZIP / REXHLAPI.INF (.txt) < prev    next >
OS/2 Help File  |  1991-08-12  |  57KB  |  2,493 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. OS/2 REXHLAPI Dynamic Link Library Reference 
  5. Version 1.00
  6. (c) Copyright W. David Ashley and Pedagogic Software 1991. All rights reserved.
  7. Licensed to AMR, Inc. and all subsidiaries (no fee required).
  8. Program and Documentation by 
  9. W. David Ashley 
  10.  
  11. No warranties, guarantees, etc. are implied, and no liability is assumed for 
  12. the code, examples, DLLs, or documentation. 
  13.  
  14. This software is user-supported software and may be freely copied and used by 
  15. anyone who wishes to do so as long as the following conditions are met: 
  16.  
  17.   1. These functions may not be used by any program for which a fee is charged 
  18.      unless the owner of the program has paid the registration fee. 
  19.  
  20.   2. If you transmit a copy of this software to another party you must give 
  21.      them the complete unaltered contents of the REXHLAPI.ZIP file. 
  22.  
  23.   3. If you make any modifications to these functions you must change the name 
  24.      of the dynamic link library file REXHLAPI.DLL to some other name. 
  25.  
  26.  If you feel that this program has benefited you, please register it by sending 
  27.  $25.00 (no fee required by AMR, Inc. and all subsidiaries) to: 
  28.  
  29.  Pedagogic Software 
  30.  W. David Ashley 
  31.  5 Timberline Dr. 
  32.  Trophy Club, Tx 76262 
  33.  
  34.  The source code for REXHLAPI can be obtained by sending $75.00 ($25.00 
  35.  registration + $50.00 source code) to the same address (no fee required by 
  36.  AMR, Inc. and all subsidiaries). 
  37.  
  38.  If you have questions, comments or suggestions please contact me through the 
  39.  OS/2 Shareware BBS or at the address above (AMR employees may contact me 
  40.  through PROFS, my user ID is Z2277). 
  41.  
  42.  DESCRIPTION 
  43.  
  44.  This document is intended for application developers who wish to use EHLLAPI 
  45.  services from OS/2 REXX cmds. The EHLLAPI services are available in REXX as an 
  46.  external function package, and are loaded only when used. 
  47.  
  48.  A general understanding of the available EHLLAPI services to Communications 
  49.  Manager by the reader is assumed by the author. For more information on the 
  50.  specific services available in EHLLAPI refer to the IBM Operating System/2 
  51.  Extended Edition Version 1.2 EHLLAPI Programming Reference manual. 
  52.  
  53.  BEFORE YOU BEGIN 
  54.  
  55.  Before you begin to use this reference, it would be helpful to understand how 
  56.  you can: 
  57.  
  58.  o Expand the Contents window to see all available topics 
  59.  o Obtain additional information for a highlighted word or phrase 
  60.  o Use action bar choices. 
  61.  
  62.  HOW TO USE THE CONTENTS 
  63.  
  64.  When the Contents window is first displayed, some topics have a plus (+) sign 
  65.  beside them.  The plus sign indicates that additional topics are available. 
  66.  
  67.  To expand the Contents window if you are using a mouse, click on the plus 
  68.  sign. If you are using the keyboard, use the Up Arrow  () or Down Arrow () 
  69.  key to highlight the topic and press the Plus (+) key.  For example, 
  70.  Introduction has a plus sign beside it. To see the complete list of topics, 
  71.  click on the plus sign or highlight that topic and press the Plus key. 
  72.  
  73.  To view a topic, double-click on the topic (or press the Up Arrow or Down 
  74.  Arrow key to highlight the topic and then press the Enter key). 
  75.  
  76.  HOW TO OBTAIN ADDITIONAL INFORMATION 
  77.  
  78.  After you select a topic, the information for that topic is displayed in a 
  79.  window.  Highlighted words or phrases indicate that additional information is 
  80.  available. You will notice that certain words in the following section are 
  81.  highlighted. If you are using a mouse, double-click on the highlighted word. 
  82.  If you are using a keyboard, press the Tab key to move to the highlighted word 
  83.  and then press the Enter key. Additional information will be displayed in a 
  84.  pop-up window. 
  85.  
  86.  HOW TO USE ACTION BAR CHOICES 
  87.  
  88.  A number of choices are available for managing information presented in the 
  89.  OS/2 LAN Command Reference. If you want to see more information about these 
  90.  choices, double-click on the name of the choice (or press the Tab key to move 
  91.  to the choice and press the Enter key). 
  92.  
  93.  Bookmark    Allows you to set a placeholder so you can retrieve information of 
  94.              interest to you. (This choice is available from the Services 
  95.              pull-down.) 
  96.  
  97.  Search      Allows you to find occurrences of a word or phrase in the current 
  98.              topic, selected topics, or all topics.  (This choice is available 
  99.              from the Services pull-down.) 
  100.  
  101.  Print       Allows you to print one or more topics. (This choice is available 
  102.              from the Services pull-down.) 
  103.  
  104.  Copy        Allows you to copy a topic you are viewing to a file you can edit. 
  105.              (This choice is available from the Services pull-down.) 
  106.  
  107.  Options     Allows you to change the way your Contents window is displayed. 
  108.  
  109.  TRADEMARKS 
  110.  
  111.  The following trademarks apply to this reference: 
  112.  
  113.  o IBM is a registered trademark of International Business Machines 
  114.    Corporation. 
  115.  
  116.  o Operating System/2 and OS/2 are trademarks of International Business 
  117.    Machines Corporation. 
  118.  
  119.  o Personal System/2 and PS/2 are trademarks of International Business Machines 
  120.    Corporation. 
  121.  
  122.  o REXX/2 is a trademark of International Business Machines Corporation. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 1.1. Requirements ΓòÉΓòÉΓòÉ
  126.  
  127. REXHALPI requires the following environment 
  128.  
  129.  o OS.2 1.2 Extended Edition or later 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 1.2. Installation ΓòÉΓòÉΓòÉ
  133.  
  134. Copy REXHLAPI.DLL to a directory specified in your LIBPATH. 
  135.  
  136. Note:  If you have a previous copy of REXHLAPI loaded and OS/2 cannot 
  137. open/replace the file then a copy of the DLL currently resides in memory. 
  138. Reboot and before executing any REXX cmds that reference REXHLAPI copy the file 
  139. to your LIBPATH destination. 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 1.3. Usage ΓòÉΓòÉΓòÉ
  143.  
  144. Add the following lines to all application cmds to insure the function is 
  145. registered: 
  146.  
  147. if RxFuncQuery('rexhllapi') then ,
  148.  call RxFuncAdd 'rexhllapi', 'rexhlapi', 'rexhllapi'
  149.  
  150. The above example would add the REXHLLAPI function so that it can be used. The 
  151. first argument specifies how you wish to refer to the function in your program 
  152. (its name in the program). The second argument references the name of the 
  153. REXHLAPI.DLL library (always 'REXHLAPI'). And the third argument references the 
  154. name of the entry point in the library which contains the code for the function 
  155. referenced in the first argument (always 'REXHLLAPI'). 
  156.  
  157. To drop the function when the application is done execute the following: 
  158.  
  159. call RxFuncDrop 'rexhllapi'
  160.  
  161. The function name now becomes unknown to the interpreter and will generate a 
  162. runtime error if used after this point in the program. 
  163.  
  164. Refer to IBM Operating System/2 Procedures Language 2/REXX Reference manual for 
  165. more information on the RxFuncAdd and RxFuncDrop statements. 
  166.  
  167. Note:  The case of the strings passed to RxFuncAdd and RxFuncDrop is not 
  168. important. The string will be converted to all upper case by the REXX 
  169. interpreter automatically. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 2. How to Read the Syntax Diagrams ΓòÉΓòÉΓòÉ
  173.  
  174. The syntax diagram shows you how to specify a function so that REXX/2 can 
  175. correctly interpret what you type. Read the syntax diagram from left to right 
  176. and from top to bottom, starting at the ΓöÇ symbol, following the horizontal 
  177. line (the main path). A line ending with an ΓöÇ means that the command syntax is 
  178. continued.  A line starting with an ΓöÇ means that the syntax is continued from 
  179. the previous line. The ΓöÇ symbol marks the end of the function syntax. 
  180. Required parameters are displayed on the main path; optional parameters are 
  181. displayed below it. 
  182.  
  183. Parameters are classified as constants or variables. String constants must be 
  184. delimited by the standard REXX/2 quotation marks. A function name is a keyword. 
  185. REXX/2 functions may be either CALLed or referenced as a function entry. Some 
  186. of the external functions presented here do not return any values. 
  187.  
  188. Variables appear in lowercase letters and represet names or values you supply. 
  189. Include all punctuation shown in the diagram, such as colons, semicolons, 
  190. commas, quotation marks, and equal signs. 
  191.  
  192. Example: 
  193.  
  194.  
  195.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Change_Window_Name', nameparmΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  196.  
  197.  
  198. ΓòÉΓòÉΓòÉ 3. Functions Overview ΓòÉΓòÉΓòÉ
  199.  
  200. The EHLLAPI function package provides a single function name to be used with a 
  201. set of parameters. 
  202.  
  203. The general format of the EHLLAPI function invocation is: 
  204.  
  205. retval = REXHLLAPI(function-string [, parameters]);
  206.                       or
  207. call REXHLLAPI function-string [, parameters];
  208.  
  209. The function-string determines the EHLLAPI function to be invoked. The case of 
  210. the function-string is not significant but the case of all other parameters are 
  211. used by the function package as they are passed to it. The number of parameters 
  212. is dependent on the EHLLAPI function to be invoked. 
  213.  
  214. Generally the data returned by a function is the return code generated by the 
  215. coresponding EHLLAPI function of the same name or a data string returned by the 
  216. specified function. In all cases if the function package determines an error in 
  217. the number of parameters or some other general error then the specified 
  218. function is not performed and the null string ('') is returned. 
  219.  
  220. In addition, the REXX variable HLLAPIRETC is also set by the REXHLAPI function 
  221. package. The combination of the returned data string and the contents of the 
  222. REXX variable HLLAPIRETC provide a clear mechanism in determining the results 
  223. of the execution of any of the EHLLAPI functions. The following outlines all 
  224. the possible combinations and their meaning: 
  225.  
  226.  o If both the returned data and the HLLAPIRETC variable are the null string 
  227.    ('') then there was an error detected in the number of input argument(s) to 
  228.    the function or their contents. 
  229.  
  230.  o If the HLLAPIRETC is the null string and the returned data is not the null 
  231.    string then the returned data should be ignored because the specified 
  232.    EHLLAPI function was not performed. The only exception to this rule is the 
  233.    Get_RexHLLAPI_Ver service because it does not execute an EHLLAPI function. 
  234.  
  235.  o If the returned data is not the null string and it is equal to the 
  236.    HLLAPIRETC variable then the specified EHLLAPI function was executed and the 
  237.    return code from that function has been returned in the returned data. 
  238.  
  239.  o In all other cases the specified EHLLAPI function will have been executed 
  240.    and data from that function is returned. The return code from the function 
  241.    will be set in the HLLAPIRETC variable. 
  242.  
  243.  The function-strings, parameters and returned data follow in alphabetical 
  244.  order. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 3.1. Change_Window_Name (Service 106) ΓòÉΓòÉΓòÉ
  248.  
  249. Syntax: 
  250.  
  251.  
  252.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Change_Window_Name', nameparmΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  253.  
  254.       or
  255.  
  256.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 106, nameparmΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  257.  
  258. Purpose: 
  259.  
  260. Changes the presentation space window name to the specified new name. The old 
  261. name is saved by the system and is restored on a call to the Disconnect_PS 
  262. service or changed on a subsequent call to the Change_Window_Name service. 
  263.  
  264. Prerequisite Calls: Connect_PM_Srvcs 
  265.  
  266. Arguments: 
  267.  
  268.  argument 1     The string constant or a variable whose contents are 
  269.                 'Change_Window_Name' or '106'. 
  270.  
  271.  nameparm       A string of the form: 
  272.  
  273.     o 1 byte short session name 
  274.     o 1 byte change option 
  275.  
  276.        - A x'01' for changing the presentation space name 
  277.        - A x'02' for resetting the presentation space name 
  278.  
  279.     o 1-60 bytes containing the new presentation space name. If byte 2 is x'02' 
  280.       then this field is optional. The maximum length of the new name is 60 
  281.       characters. 
  282.  
  283.  Returns: 
  284.  
  285.  The return code from the Change_Window_Name EHLLAPI service is returned. 
  286.  
  287.  '0'       Ok 
  288.  
  289.  '1'       Byte 1 of nameparm is invalid 
  290.  
  291.  '2'       nameparm error 
  292.  
  293.  '9'       System error 
  294.  
  295.  '11'      Session is stopped 
  296.  
  297.  Example: 
  298.  
  299.  Change the 'A' session window name to "My Program". 
  300.  
  301.   call REXHLLAPI 'Connect_PM_Srvcs', 'A'
  302.   call REXHLLAPI 'Change_Window_Name', 'A' || c2x('01') || 'My Program'
  303.   call REXHLLAPI 'Disconnect_PM_Srvcs', 'A'
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 3.2. Change_Switch_Name (Service 105) ΓòÉΓòÉΓòÉ
  307.  
  308. Syntax: 
  309.  
  310.  
  311.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Change_Switch_Name', nameparmΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  312.  
  313.       or
  314.  
  315.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 105, nameparmΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  316.  
  317. Purpose: 
  318.  
  319. Changes the presentation space switchlist name to the specified new name. The 
  320. old name is saved by the system and is restored on a call to the Disconnect_PS 
  321. service or changed on a subsequent call to the Change_Switch_Name service. 
  322.  
  323. Prerequisite Calls: Connect_PM_Srvcs 
  324.  
  325. Arguments: 
  326.  
  327.  argument 1     The string constant or a variable whose contents are 
  328.                 'Change_Switch_Name' or '105'. 
  329.  
  330.  nameparm       A string of maximum length layed out as follows: 
  331.  
  332.     o 1 byte short session name 
  333.     o 1 byte change option 
  334.  
  335.        - A x'01' for changing the switch list name of the PS 
  336.        - A x'02' for resetting the switch list name of the PS 
  337.  
  338.     o 1-60 bytes containing the new switch list name. If byte 2 is x'02' then 
  339.       this field is optional. The maximum length of the new name is 60 
  340.       characters. 
  341.  
  342.  Returns: 
  343.  
  344.  The return code from the Change_Switch_Name EHLLAPI service is returned. 
  345.  
  346.  '0'       Ok 
  347.  
  348.  '1'       Byte 1 of nameparm is invalid 
  349.  
  350.  '2'       nameparm error 
  351.  
  352.  '9'       System error 
  353.  
  354.  '11'      Session is stopped 
  355.  
  356.  Example: 
  357.  
  358.  Change the 'A' session switch list name to "My Program". 
  359.  
  360.   call REXHLLAPI 'Connect_PM_Srvcs', 'A'
  361.   call REXHLLAPI 'Change_Switch_Name', 'A' || c2x('01') || 'My Program'
  362.   call REXHLLAPI 'Disconnect_PM_Srvcs', 'A'
  363.  
  364.  
  365. ΓòÉΓòÉΓòÉ 3.3. Connect_PM_Srvcs (Service 101) ΓòÉΓòÉΓòÉ
  366.  
  367. Syntax: 
  368.  
  369.  
  370.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Connect_PM_Srvcs', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  371.  
  372.       or
  373.  
  374.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 101, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  375.  
  376. Purpose: 
  377.  
  378. Connects the application to a presentation space for only the EHLLAPI 
  379. Presentation Manager services. 
  380.  
  381. Prerequisite Calls: None 
  382.  
  383. Arguments: 
  384.  
  385.  argument 1     The string constant or a variable whose contents are 
  386.                 'Connect_PM_Srvcs' or '101'. 
  387.  
  388.  session_id     The short session name of the presentation space in which PM 
  389.                 services are to be performed. 
  390.  
  391.  Returns: 
  392.  
  393.  The return code from the Connect_PM_Srvcs EHLLAPI service is returned. 
  394.  
  395.  '0'       Ok 
  396.  
  397.  '1'       session_id was invalid 
  398.  
  399.  '9'       System error 
  400.  
  401.  '10'      Function not supported 
  402.  
  403.  '11'      System resource unavailable. Presentation space already in use. 
  404.  
  405.  Example: 
  406.  
  407.   retc = REXHLLAPI('Connect_PM_Srvcs', 'A')
  408.  
  409.  
  410. ΓòÉΓòÉΓòÉ 3.4. Connect_PS (Service 1) ΓòÉΓòÉΓòÉ
  411.  
  412. Syntax: 
  413.  
  414.  
  415.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Connect_PS', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  416.  
  417.       or
  418.  
  419.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 1, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  420.  
  421. Purpose: 
  422.  
  423. Connects the program to a logical Communications Manager session specified by 
  424. the presentation space short name session_id. See the Communications Manager 
  425. Configuration services to determine the names of the sessions configured on 
  426. your system or use the service Query_sessions to obtain the session information 
  427. dynamically. 
  428.  
  429. Prerequisite Calls: None 
  430.  
  431. Arguments: 
  432.  
  433.  argument 1     The string constant or a variable whose contents are 
  434.                 'Connect_PS' or '1'. 
  435.  
  436.  session_id     The short session name (1 character) of the session you wish to 
  437.                 be connected to. The case of this character is not important. 
  438.  
  439.  Returns: 
  440.  
  441.  The return code from the Connect_PS EHLLAPI service is returned. 
  442.  
  443.  '0'       Connected ok 
  444.  
  445.  '1'       Invalid session_id 
  446.  
  447.  '4'       Connect, session busy 
  448.  
  449.  '5'       Connect, session locked 
  450.  
  451.  '9'       System error 
  452.  
  453.  '11'      Session already connected to another application 
  454.  
  455.  Note:  Other return codes are possible from this service. 
  456.  
  457.  Example: 
  458.  
  459.   retc = REXHLLAPI('Connect_PS', 'A')
  460.  
  461.  
  462. ΓòÉΓòÉΓòÉ 3.5. Convert_Position (Service 99) ΓòÉΓòÉΓòÉ
  463.  
  464. Syntax: 
  465.  
  466.  
  467.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇrow = RexHLLAPI('Convert_Position', session_id, position)ΓöÇΓöÇΓöÇ
  468.  
  469.       or
  470.  
  471.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇrow = RexHLLAPI(99, session_id, position)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  472.  
  473. Purpose: 
  474.  
  475. Converts position to row/column. 
  476.  
  477. Prerequisite Calls: None 
  478.  
  479. Arguments: 
  480.  
  481.  argument 1     The string constant or a variable whose contents are 
  482.                 'Convert_Position' or '99'. 
  483.  
  484.  session_id     The short session name (1 character) identifying the session 
  485.                 from which the conversion info is to be taken. 
  486.  
  487.  position       The position to be converted to row/column format. Valid 
  488.                 argument values for a 24 by 80 presentation space would be 1 to 
  489.                 1920. 
  490.  
  491.  Returns: 
  492.  
  493.  The return code from the Convert_Position EHLLAPI service is returned. 
  494.  
  495.  '0'              Position specified is outside the presentation space 
  496.  
  497.  > '0' < '9998'   The row number of the converted position 
  498.  
  499.  = '9998'         Invalid session_id 
  500.  
  501.  = '9998'         REXHLAPI internal error. Contact author. 
  502.  
  503.  Note:  If this function returns a value > '0' < '9998' then the REXX variable 
  504.  HLLAPIRETC contains the column number of the converted position. 
  505.  
  506.  Example: 
  507.  
  508.  The following example 
  509.  
  510.   row = REXHLLAPI('convert_pos', 'a', 170);
  511.   /* Now ROW = '3' and HLLAPIRETC = '10' */
  512.  
  513.  would return '3' and set HLLAPIRETC = '10' in a 24 by 80 presentation space. 
  514.  
  515.  
  516. ΓòÉΓòÉΓòÉ 3.6. Convert_RowCol (Service 99) ΓòÉΓòÉΓòÉ
  517.  
  518. Syntax: 
  519.  
  520.  
  521.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI('Convert_RowCol', session_id, column, row)ΓöÇΓöÇ
  522.  
  523.       or
  524.  
  525.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI(99, session_id, column, row)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  526.  
  527. Purpose: 
  528.  
  529. Converts row/column info in the session session_id, to presentation space 
  530. position. 
  531.  
  532. Prerequisite Calls: None 
  533.  
  534. Arguments: 
  535.  
  536.  argument 1     The string constant or a variable whose contents are 
  537.                 'Convert_RowCol' or '99'. 
  538.  
  539.  session_id     The short session name (1 character) identifying the session 
  540.                 from which the conversion info is to be taken. 
  541.  
  542.  col            The column component to be converted. Valid argument values for 
  543.                 a 24 by 80 presentation space would be 1 to 80. 
  544.  
  545.  row            The row component to be converted. Valid argument values for a 
  546.                 24 by 80 presentation space would be 1 to 24. 
  547.  
  548.  Returns: 
  549.  
  550.  The return code from the Convert_RowCol EHLLAPI service is returned. 
  551.  
  552.  '0'              Row or column specified is outside presentation space 
  553.  
  554.  > '0' < '9998'   The position (upper left is position 1) 
  555.  
  556.  = '9998'         Invalid session_id 
  557.  
  558.  = '9998'         REXHLAPI internal error. Contact author. 
  559.  
  560.  Example: 
  561.  
  562.  The following example 
  563.  
  564.   pos = REXHLLAPI('convert_rowcol', 'a', 10, 3);
  565.  
  566.  would return '170' in a 24 by 80 presentation space. 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 3.7. Copy_Field_To_Str (Service 34) ΓòÉΓòÉΓòÉ
  570.  
  571. Syntax: 
  572.  
  573.  
  574.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇfielddata = RexHLLAPI('Copy_Field_To_Str', pos, length)ΓöÇΓöÇΓöÇΓöÇΓöÇ
  575.  
  576.       or
  577.  
  578.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇfielddata = RexHLLAPI(34, pos, length)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  579.  
  580. Purpose: 
  581.  
  582. Copies the field data located at pos in the connected presentation space, for 
  583. length length. The pos and length values can be found by using the 
  584. Find_field_pos and Find_field_len services described elsewhere in this 
  585. reference. 
  586.  
  587. Prerequisite Calls: Connect_PS 
  588.  
  589. Arguments: 
  590.  
  591.  argument 1     The string constant or a variable whose contents are 
  592.                 'Copy_field_to_str' or '34'. 
  593.  
  594.  pos            The position of the field to be copied. 
  595.  
  596.  length         The number of character to be copied. 
  597.  
  598.  Returns: 
  599.  
  600.  The requested field data string is returned. 
  601.  
  602.  ''          No field data at pos, or invalid pos. Check the value of the REXX 
  603.              variable HLLAPIRETC. 
  604.  
  605.  fielddata   The data of length length or up to the end of the field at pos. 
  606.  
  607.  Example: 
  608.  
  609.  The following example 
  610.  
  611.   fielddata = REXHLLAPI('copy_field_to_str', 26, 10);
  612.  
  613.  would copy 10 characters at position 26 from the currently presentation space. 
  614.  
  615.  
  616. ΓòÉΓòÉΓòÉ 3.8. Copy_Oia (Service 13) ΓòÉΓòÉΓòÉ
  617.  
  618. Syntax: 
  619.  
  620.  
  621.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇoiadata = RexHLLAPI('Copy_Oia')ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  622.  
  623.       or
  624.  
  625.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇoiadata = RexHLLAPI(13)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  626.  
  627. Purpose: 
  628.  
  629. Returns the Operator Information Area from the connected session. Refer to the 
  630. IBM Operating System/2 Extended Edition Version 1.2 EHLLAPI Programming 
  631. Reference manual for more information on the contents of the Oia data. 
  632.  
  633. Prerequisite Calls: Connect_PS 
  634.  
  635. Arguments: 
  636.  
  637.  argument 1     The string constant or a variable whose contents are 'Copy_Oia' 
  638.                 or '13'. 
  639.  
  640.  Returns: 
  641.  
  642.  The Operator Information Area data string is returned. 
  643.  
  644.  ''          Not connected or other error. Check the value of the REXX variable 
  645.              HLLAPIRETC. 
  646.  
  647.  oiadata     A 103 byte copy of the OIA data consisting of 
  648.  
  649.     o A 1 byte format field  set to '1' 
  650.     o An 80 byte data field with the contents of the OIA line 
  651.     o A 22 byte OIA group field 
  652.  
  653.  
  654. ΓòÉΓòÉΓòÉ 3.9. Copy_PS (Service 5) ΓòÉΓòÉΓòÉ
  655.  
  656. Syntax: 
  657.  
  658.  
  659.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpsdata = RexHLLAPI('Copy_PS')ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  660.  
  661.       or
  662.  
  663.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpsdata = RexHLLAPI(5)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  664.  
  665. Purpose: 
  666.  
  667. Return the entire contents of the currently connected session or '' (null 
  668. string) if not connected to a session. The contents of the returned data is 
  669. dependant on the setting of the EAB (Extended Attribute Bytes) value in the 
  670. Set_session_parms service described elsewhere. Briefly, if EAB is OFF then only 
  671. the TEXT of the presentation space will be returned. If EAB is ON then 2 bytes 
  672. will be returned for each displayable byte on the screen. The first will 
  673. contain the EAB value, the second will contain the text data. 
  674.  
  675. Prerequisite Calls: Connect_PS 
  676.  
  677. Arguments: 
  678.  
  679.  argument 1     The string constant or a variable whose contents are 'Copy_PS' 
  680.                 or '5'. 
  681.  
  682.  Returns: 
  683.  
  684.  The entire contents of the currently connected presentation space are returned 
  685.  as a single string. 
  686.  
  687.  ''        Not connected or other error. Check the value of the REXX variable 
  688.            HLLAPIRETC. 
  689.  
  690.  psdata    1920 bytes of data if the presentation space is 24 x 80 and the EAB 
  691.            is OFF, 3840 bytes if the EAB is ON. 
  692.  
  693.  
  694. ΓòÉΓòÉΓòÉ 3.10. Copy_PS_To_Str (Service 8) ΓòÉΓòÉΓòÉ
  695.  
  696. Syntax: 
  697.  
  698.  
  699.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpsdata = RexHLLAPI('Copy_PS_To_Str', pos, length)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  700.  
  701.       or
  702.  
  703.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpsdata = RexHLLAPI(8, pos, length)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  704.  
  705. Purpose: 
  706.  
  707. Returns data from the curently connected session from position pos for length 
  708. length, or '' if not connect or an error. See the discussion of EAB setting in 
  709. the Copy_PS service. 
  710.  
  711. Prerequisite Calls: Connect_PS 
  712.  
  713. Arguments: 
  714.  
  715.  argument 1     The string constant or a variable whose contents are 
  716.                 'Copy_PS_to_str' or '8'. 
  717.  
  718.  pos            The start offset in the presentation space to begin the copy 
  719.                 operation. 
  720.  
  721.  length         The length of data from the presentation space to copy. 
  722.  
  723.  Returns: 
  724.  
  725.  The specified portion of the currently connected presentation space is 
  726.  returned as a string. 
  727.  
  728.  ''        Not connected or other error. Check the value of the REXX variable 
  729.            HLLAPIRETC. 
  730.  
  731.  psdata    length characters of data if the EAB is OFF or length x 2 if the EAB 
  732.            is ON. 
  733.  
  734.  Example: 
  735.  
  736.  The following example 
  737.  
  738.   psdata = REXHLLAPI('copy_ps_to_str', 26, 10);
  739.  
  740.  would copy 10 characters at position 26 from the currently presentation space. 
  741.  
  742.  
  743. ΓòÉΓòÉΓòÉ 3.11. Copy_Str_to_Field (Service 33) ΓòÉΓòÉΓòÉ
  744.  
  745. Syntax: 
  746.  
  747.  
  748.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Copy_str_to_field', string, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  749.  
  750.       or
  751.  
  752.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 33, string, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  753.  
  754. Purpose: 
  755.  
  756. Copies string to the field at pos position in the connected session. 
  757.  
  758. Prerequisite Calls: Connect_PS 
  759.  
  760. Arguments: 
  761.  
  762.  argument 1     The string constant or a variable whose contents are 
  763.                 'Copy_str_to_field'. 
  764.  
  765.  string         Data string to be copied. 
  766.  
  767.  pos            Position of the destination field in the presentation space. 
  768.  
  769.  Returns: 
  770.  
  771.  The return code from the Copy_str_to_field EHLLAPI service is returned. 
  772.  
  773.  '0'       Ok 
  774.  
  775.  '1'       Target not allowed 
  776.  
  777.  '2'       Zero length string 
  778.  
  779.  '5'       Protected field or bad string data (bad attribute) 
  780.  
  781.  '6'       Data copied, but truncated because string was longer than the field. 
  782.  
  783.  '7'       pos is invalid 
  784.  
  785.  '24'      The screen has no fields (unformatted) 
  786.  
  787.  Example: 
  788.  
  789.  The following example 
  790.  
  791.   call REXHLLAPI 'copy_str_to_field', 'logoff', 90
  792.  
  793.  would copy the string 'logoff' to the currently presentation space field at 
  794.  postion 90. 
  795.  
  796.  
  797. ΓòÉΓòÉΓòÉ 3.12. Copy_Str_to_PS (Service 15) ΓòÉΓòÉΓòÉ
  798.  
  799. Syntax: 
  800.  
  801.  
  802.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Copy_str_to_PS', string, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  803.  
  804.       or
  805.  
  806.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 15, string, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  807.  
  808. Purpose: 
  809.  
  810. Copies string to pos position in the connected session. 
  811.  
  812. Prerequisite Calls: Connect_PS 
  813.  
  814. Arguments: 
  815.  
  816.  argument 1     The string constant or a variable whose contents are 
  817.                 'Copy_str_to_PS' or '15'. 
  818.  
  819.  string         Data string to be copied. 
  820.  
  821.  pos            Position of the destination in the presentation space. 
  822.  
  823.  Returns: 
  824.  
  825.  The return code from the Copy_str_to_PS EHLLAPI service is returned. 
  826.  
  827.  '0'       Ok 
  828.  
  829.  '1'       Target not allowed 
  830.  
  831.  '2'       Zero length string 
  832.  
  833.  '5'       Protected field or bad string data (bad attribute) 
  834.  
  835.  '6'       Data copied, but truncated because string was longer than the field. 
  836.  
  837.  '7'       pos is invalid 
  838.  
  839.  Example: 
  840.  
  841.  The following example 
  842.  
  843.   call REXHLLAPI 'copy_str_to_ps', 'logoff', 90
  844.  
  845.  would copy the string 'logoff' to the currently presentation space at position 
  846.  90. 
  847.  
  848.  
  849. ΓòÉΓòÉΓòÉ 3.13. Disconnect_PM_Srvcs (Service 102) ΓòÉΓòÉΓòÉ
  850.  
  851. Syntax: 
  852.  
  853.  
  854.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Disconnect_PM_Srvcs', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  855.  
  856.       or
  857.  
  858.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 102, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  859.  
  860. Purpose: 
  861.  
  862. Disconnects the Presentation Manager window services connection. 
  863.  
  864. Prerequisite Calls: Connect_PM_Srvcs 
  865.  
  866. Arguments: 
  867.  
  868.  argument 1     The string constant or a variable whose contents are 
  869.                 'Disconnect_PM_Srvcs' or '102'. 
  870.  
  871.  Session_id     The short session presentation space name from which to 
  872.                 disconnect. 
  873.  
  874.  Returns: 
  875.  
  876.  The return code from the Disconnect_PM_Srvcs EHLLAPI service is returned. 
  877.  
  878.  '0'       Ok 
  879.  
  880.  '1'       Not connected 
  881.  
  882.  '9'       System error 
  883.  
  884.  Example: 
  885.  
  886.   call REXHLLAPI 'Disconnect_PM_Srvcs', 'A'
  887.  
  888.  
  889. ΓòÉΓòÉΓòÉ 3.14. Disconnect_PS (Service 2) ΓòÉΓòÉΓòÉ
  890.  
  891. Syntax: 
  892.  
  893.  
  894.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Disconnect_PS'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  895.  
  896.       or
  897.  
  898.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 2ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  899.  
  900. Purpose: 
  901.  
  902. Disconnects from the currently connected presentation space session. 
  903.  
  904. Prerequisite Calls: Connect_PS 
  905.  
  906. Arguments: 
  907.  
  908.  argument 1     The string constant or a variable whose contents are 
  909.                 'Disconnect_PS' or '2'. 
  910.  
  911.  Returns: 
  912.  
  913.  The return code from the Disconnect_PS EHLLAPI service is returned. 
  914.  
  915.  '0'       Ok 
  916.  
  917.  '1'       Not connected 
  918.  
  919.  Example: 
  920.  
  921.   call REXHLLAPI 'Disconnect_PS'
  922.  
  923.  
  924. ΓòÉΓòÉΓòÉ 3.15. Find_Field_Len (Service 32) ΓòÉΓòÉΓòÉ
  925.  
  926. Syntax: 
  927.  
  928.  
  929.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Find_Field_Len', search_option, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  930.  
  931.       or
  932.  
  933.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 32, search_option, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  934.  
  935. Purpose: 
  936.  
  937. Returns the length of the field with attributes search_option starting at 
  938. position pos within the current field or '0' if the specified field type could 
  939. not be found. 
  940.  
  941. Prerequisite Calls: Connect_PS 
  942.  
  943. Arguments: 
  944.  
  945.  argument 1          The string constant or a variable whose contents are 
  946.                      'Find_Field_Len' or '32'. 
  947.  
  948.  search_option        The values for search_option are: 
  949.  
  950.     ' ' or 'T '    The current field (the field that the cursor is in) 
  951.     'P '           Previous field, either protected or unprotected. 
  952.     'NP'           Next protected field 
  953.     'NU'           Next unprotected field 
  954.     'PP'           Previous protected field 
  955.     'PU'           Previous unprotected field 
  956.  
  957.  pos                 The starting position in the presentation space from which 
  958.                      the search is to begin. 
  959.  
  960.  Returns: 
  961.  
  962.  The length of the found specified field type is returned. 
  963.  
  964.  '0'       The specified field type could not be located 
  965.  
  966.  > '0'     The length of the found specified field type 
  967.  
  968.  
  969. ΓòÉΓòÉΓòÉ 3.16. Find_Field_Pos (Service 31) ΓòÉΓòÉΓòÉ
  970.  
  971. Syntax: 
  972.  
  973.  
  974.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Find_Field_Pos', search_option, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  975.  
  976.       or
  977.  
  978.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 31, search_option, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  979.  
  980. Purpose: 
  981.  
  982. Returns the position of the field with attributes search_option starting at 
  983. position pos within the presentation space or '0' if the specified field type 
  984. could not be found. 
  985.  
  986. Prerequisite Calls: Connect_PS 
  987.  
  988. Arguments: 
  989.  
  990.  argument 1          The string constant or a variable whose contents are 
  991.                      'Find_Field_Pos'. 
  992.  
  993.  search_option       The values for search_option are: 
  994.  
  995.     ' ' or 'T '    The current field (the field that the cursor is in) 
  996.     'P '           Previous field, either protected or unprotected. 
  997.     'NP'           Next protected field 
  998.     'NU'           Next unprotected field 
  999.     'PP'           Previous protected field 
  1000.     'PU'           Previous unprotected field 
  1001.  
  1002.  pos                 The starting position in the presentation space from which 
  1003.                      the search is to begin. 
  1004.  
  1005.  Returns: 
  1006.  
  1007.  The position of the found specified field type is returned. 
  1008.  
  1009.  '0'       The specified field type could not be located 
  1010.  
  1011.  > '0'     The position of the found specified field type 
  1012.  
  1013.  
  1014. ΓòÉΓòÉΓòÉ 3.17. Get_key (Service 51) ΓòÉΓòÉΓòÉ
  1015.  
  1016. Syntax: 
  1017.  
  1018.  
  1019.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇkeyval = RexHLLAPI('Get_key', session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1020.  
  1021.       or
  1022.  
  1023.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇkeyval = REXHLLAPI(51, session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1024.  
  1025. Purpose: 
  1026.  
  1027. Return the next intercepted keystroke from the session specified. The service 
  1028. Start_Key_Intercept enables the application to intercept keystrokes from the 
  1029. user. 
  1030.  
  1031. For more information on the returned data from this function refer to the IBM 
  1032. operating System/2 Extended Edition Version 1.2 EHLLAPI Programming Reference 
  1033. manual. 
  1034.  
  1035. Prerequisite Calls: Start_Key_Intercept 
  1036.  
  1037. Arguments: 
  1038.  
  1039.  argument 1     The string constant or a variable whose contents are 'Get_Key' 
  1040.                 or '51'. 
  1041.  
  1042.  session_id     The short session name of the presentation space from which to 
  1043.                 obtain the keystroke. 
  1044.  
  1045.  Returns: 
  1046.  
  1047.  The intercepted keystroke data string is returned. 
  1048.  
  1049.  ''        If an error, or not connected to session_id. Check the value of the 
  1050.            REXX variable HLLAPIRETC. 
  1051.  
  1052.  keyval    If no error, the contents of string depend on the keys pressed by 
  1053.            the 3270 session operator, for example: 
  1054.  
  1055.     Byte 1         The session_id 
  1056.     Byte 2         The ASCII code for the key 'a' 
  1057.     Bytes 3-4      A keystroke mnemonic, '@E' (enter) 
  1058.  
  1059.  Other lengths of keyval are possible (maximum length 8 characters) as well as 
  1060.  other combinations of data. 
  1061.  
  1062.  
  1063. ΓòÉΓòÉΓòÉ 3.18. Get_RexHLLAPI_Ver ΓòÉΓòÉΓòÉ
  1064.  
  1065. Syntax: 
  1066.  
  1067.  
  1068.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇver = RexHLLAPI('Get_RexHLLAPI_Ver')ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1069.  
  1070. Purpose: 
  1071.  
  1072. Returns the version of the REXHLAPI.DLL which is currently running. This 
  1073. function does not execute any EHLLAPI services. 
  1074.  
  1075. Prerequisite Calls: None 
  1076.  
  1077. Arguments: 
  1078.  
  1079. None. 
  1080.  
  1081. Returns: 
  1082.  
  1083. The version and compilation date data string is returned. 
  1084.  
  1085.  ''        Error, invalid number of arguments. 
  1086.  
  1087.  ver       String containing REXHLAPI version info in the form 'x.xx mmm 
  1088.            [d]d,yyyy' where 
  1089.  
  1090.     o x.xx is the version number 
  1091.     o mmm is the month of compliation 
  1092.     o dd is the day of compilation (1 or 2 characters) 
  1093.     o yyyy is the year of compliation 
  1094.  
  1095.  Example: 
  1096.  
  1097.   version = substr(REXHLLAPI('Get_RexHLLAPI_Ver'), 1, 4)
  1098.   compdate = substr(REXHLLAPI('Get_RexHLLAPI_Ver'), 6)
  1099.  
  1100.  
  1101. ΓòÉΓòÉΓòÉ 3.19. Pause (Service 18) ΓòÉΓòÉΓòÉ
  1102.  
  1103. Syntax: 
  1104.  
  1105.  
  1106.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Pause', nΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1107.  
  1108.       or
  1109.  
  1110.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 18, nΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1111.  
  1112. Purpose: 
  1113.  
  1114. Causes a timed pause of n 1/2 second intervals to occur. 
  1115.  
  1116. If the Set_session_Parms service set IPAUSE and you have done a 
  1117. Start_host_notify service, then the pause will also be ended by an update to 
  1118. the to the host screen. 
  1119.  
  1120. Prerequisite Calls: None 
  1121.  
  1122. Arguments: 
  1123.  
  1124.  argument 1     The string constant or a variable whose contents are 'Pause' or 
  1125.                 '18'. 
  1126.  
  1127.  n              The number of 1/2 seconds to pause. 
  1128.  
  1129.  Returns: 
  1130.  
  1131.  The return code from the Pause EHLLAPI service is returned. 
  1132.  
  1133.  '0'       Pause duration completed 
  1134.  
  1135.  '9'       System error 
  1136.  
  1137.  '26'      A host session has been updated, use Query_host_Update service for 
  1138.            more information 
  1139.  
  1140.  Example: 
  1141.  
  1142.  The following example 
  1143.  
  1144.   call REXHLLAPI 'Pause', 20
  1145.  
  1146.  will cause a 10 second, or if IPAUSE has been set will cause a pause until the 
  1147.  host presentation space has been updated or 10 second pause whichever is 
  1148.  shorter. 
  1149.  
  1150.  
  1151. ΓòÉΓòÉΓòÉ 3.20. PM_Window_Status (Service 104) ΓòÉΓòÉΓòÉ
  1152.  
  1153. Syntax: 
  1154.  
  1155.  
  1156.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇstatusdata = RexHLLAPI('PM_Window_Status', statusdata)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1157.  
  1158.       or
  1159.  
  1160.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇstatusdata = RexHLLAPI(104, statusdata)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1161.  
  1162. Purpose: 
  1163.  
  1164. Allows an application to query or change a PS window size, location, or visible 
  1165. state. 
  1166.  
  1167. Prerequisite Calls: Connect_PM_Srvcs 
  1168.  
  1169. Arguments: 
  1170.  
  1171.  argument 1     The string constant or a variable whose contents are 
  1172.                 'PM_Window_Status' or '104'. 
  1173.  
  1174.  statusdata     16 bytes of data specifying the status action to take. Refer to 
  1175.                 the IBM Operating System/2 Extended Edition Version 1.2 EHLLAPI 
  1176.                 Programming Reference manual for the layout of the data. 
  1177.  
  1178.  Returns: 
  1179.  
  1180.  The window status data string is returned. 
  1181.  
  1182.  ''             Error. Check the value of the REXX variable HLLAPIRETC. 
  1183.  
  1184.  statusdata     Function successful, status information returned 
  1185.  
  1186.  
  1187. ΓòÉΓòÉΓòÉ 3.21. Post_Intercept_Status (Service 52) ΓòÉΓòÉΓòÉ
  1188.  
  1189. Syntax: 
  1190.  
  1191.  
  1192.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Post_Intercept_Status', statusdataΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1193.  
  1194.       or
  1195.  
  1196.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 52, statusdataΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1197.  
  1198. Purpose: 
  1199.  
  1200. Informs EHLLAPI that a keystroke obtained through the Get_Key service was 
  1201. accepted or rejected. 
  1202.  
  1203. Prerequisite Calls: Start_Key_Intercept 
  1204.  
  1205. Arguments: 
  1206.  
  1207.  argument 1     The string constant or a variable whose contents are 
  1208.                 'Post_Intercept_Status' or '52'. 
  1209.  
  1210.  statusdata     2 bytes of data as follows: 
  1211.  
  1212.     o 1 byte indicating the session id or a blank specifying the current 
  1213.       connected session 
  1214.     o 1 byte option. 'A' for keystroke accepted or 'R' for keystroke rejected. 
  1215.  
  1216.  Returns: 
  1217.  
  1218.  The return code from the Post_Intercept_Status EHLLAPI service is returned. 
  1219.  
  1220.  '0'       Ok 
  1221.  
  1222.  '1'       Presentation space invalid 
  1223.  
  1224.  '2'       Invalid option specified 
  1225.  
  1226.  '8'       No prior Start_Key_Intercept service has been called 
  1227.  
  1228.  '9'       System error 
  1229.  
  1230.  Example: 
  1231.  
  1232.  The following example 
  1233.  
  1234.   keydata = REXHLLAPI('Get_key', 'A')
  1235.   call REXHLLAPI 'Post_intercept_status', 'AR'
  1236.  
  1237.  will reject the previous keystroke obtained by the Get_Key service. 
  1238.  
  1239.  
  1240. ΓòÉΓòÉΓòÉ 3.22. Query_Close_Intercept (Service 42) ΓòÉΓòÉΓòÉ
  1241.  
  1242. Syntax: 
  1243.  
  1244.  
  1245.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Query_Close_Intercept', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1246.  
  1247.       or
  1248.  
  1249.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 42, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1250.  
  1251. Purpose: 
  1252.  
  1253. Allows the application to determine if the CLOSE option on the pull-down menu 
  1254. was selected. 
  1255.  
  1256. Prerequisite Calls: Start_Close_Intercept 
  1257.  
  1258. Arguments: 
  1259.  
  1260.  argument 1     The string constant or a variable whose contents are 
  1261.                 'Query_Close_Intercept' or '42'. 
  1262.  
  1263.  session_id     The short session name of the presentation space to query 
  1264.  
  1265.  Returns: 
  1266.  
  1267.  The return code from the Query_Close_Intercept EHLLAPI service is returned. 
  1268.  
  1269.  '0'       Close intercept did not occur 
  1270.  
  1271.  '1'       Presentation space invalid 
  1272.  
  1273.  '2'       Invalid parameter specified 
  1274.  
  1275.  '8'       No prior Start_Close_Intercept service has been called 
  1276.  
  1277.  '9'       System error 
  1278.  
  1279.  '12'      The session is stopped 
  1280.  
  1281.  '26'      A close intercept occurred since the last Query_Close_Intercept 
  1282.            service call 
  1283.  
  1284.  
  1285. ΓòÉΓòÉΓòÉ 3.23. Query_Cursor_Loc (Service 7) ΓòÉΓòÉΓòÉ
  1286.  
  1287. Syntax: 
  1288.  
  1289.  
  1290.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI('Query_Cursor_Loc')ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1291.  
  1292.       or
  1293.  
  1294.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI(7)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1295.  
  1296. Purpose: 
  1297.  
  1298. Returns the cursor position in the currently connected session or '0' if not 
  1299. connected to a session. 
  1300.  
  1301. Prerequisite Calls: Connect_PS 
  1302.  
  1303. Arguments: 
  1304.  
  1305.  argument 1     The string constant or a variable whose contents are 
  1306.                 'Query_Cursor_Loc' or '7'. 
  1307.  
  1308.  Returns: 
  1309.  
  1310.  The position of the cursor is returned. 
  1311.  
  1312.  '0'       System error occured or not connected 
  1313.  
  1314.  > '0'     The cursor position within the connected presentation space 
  1315.  
  1316.  
  1317. ΓòÉΓòÉΓòÉ 3.24. Query_Field_Attr (Service 14) ΓòÉΓòÉΓòÉ
  1318.  
  1319. Syntax: 
  1320.  
  1321.  
  1322.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇattr = RexHLLAPI('Query_Field_Attr', pos)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1323.  
  1324.       or
  1325.  
  1326.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇattr = RexHLLAPI(14, pos)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1327.  
  1328. Purpose: 
  1329.  
  1330. Returns the text representation of the attribute of the field located at 
  1331. position pos in the currently connected session or '0' if not connected to a 
  1332. session or the session was currently an unformatted screen. The attribute bytes 
  1333. are greater than x'C0' and are returned as printable characters (x'C0' in this 
  1334. case). 
  1335.  
  1336. Prerequisite Calls: Connect_PS 
  1337.  
  1338. Arguments: 
  1339.  
  1340.  argument 1     The string constant or a variable whose contents are 
  1341.                 'Query_Field_Attr' or '14'. 
  1342.  
  1343.  pos            The position within the connected presentation space 
  1344.  
  1345.  Returns: 
  1346.  
  1347.  The field attribute byte is returned. 
  1348.  
  1349.  ''        System error occured, not connected or the screen was unformatted. 
  1350.            Check the value of the REXX variable HLLAPIRETC. 
  1351.  
  1352.  attr      One byte representation of the field attribute 
  1353.  
  1354.  
  1355. ΓòÉΓòÉΓòÉ 3.25. Query_Host_Update (Service 24) ΓòÉΓòÉΓòÉ
  1356.  
  1357. Syntax: 
  1358.  
  1359.  
  1360.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇretc = RexHLLAPI('Query_Host_Update', session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1361.  
  1362.       or
  1363.  
  1364.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇretc = RexHLLAPI(24, session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1365.  
  1366. Purpose: 
  1367.  
  1368. Determines if the host has updated the presentation space, OIA or both since: 
  1369.  
  1370.  o The Start_Host_Notify service was called. 
  1371.  o A previous call to the Query_Host_Update service. 
  1372.  
  1373.  Prerequisite Calls: Start_Host_Notify 
  1374.  
  1375.  Arguments: 
  1376.  
  1377.  argument 1     The string constant or a variable whose contents are 
  1378.                 'Query_Host_Update' or '24'.c 
  1379.  
  1380.  session_id     The short name for the presentation space to query 
  1381.  
  1382.  Returns: 
  1383.  
  1384.  The return code from the Query_Host_Update EHLLAPI service is returned. 
  1385.  
  1386.  '0'       No update since last call 
  1387.  
  1388.  '1'       Not connected to a session 
  1389.  
  1390.  '8'       Host notification has not been requested (see Start_Host_Notify). 
  1391.  
  1392.  '9'       System error 
  1393.  
  1394.  '21'      The OIA has been updated 
  1395.  
  1396.  '22'      The Presentation space has been updated 
  1397.  
  1398.  '23'      Both OIA and PS have been updated 
  1399.  
  1400.  
  1401. ΓòÉΓòÉΓòÉ 3.26. Query_Session_Status (Service 22) ΓòÉΓòÉΓòÉ
  1402.  
  1403. Syntax: 
  1404.  
  1405.  
  1406.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇstatus = RexHLLAPI('Query_Session_Status', session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1407.  
  1408.       or
  1409.  
  1410.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇstatus = RexHLLAPI(22, session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1411.  
  1412. Purpose: 
  1413.  
  1414. Returns 18 bytes of session status information if the call is successful or '' 
  1415. if not. The 18 bytes are layed out as follows: 
  1416.  
  1417. Prerequisite Calls: None 
  1418.  
  1419. Arguments: 
  1420.  
  1421.  argument 1     The string constant or a variable whose contents are 
  1422.                 'Query_Session_Status' or '22'. 
  1423.  
  1424.  session_id     The short name for the presentation space to query 
  1425.  
  1426.  Returns: 
  1427.  
  1428.  The session status data string is returned. 
  1429.  
  1430.  ''        Error. Check the value of the REXX variable HLLAPIRETC. 
  1431.  
  1432.  status    18 bytes layed out as follows: 
  1433.  
  1434.     o 1 byte session short name 
  1435.     o 8 byte session long name in ASCII 
  1436.     o 1 byte session type 
  1437.  
  1438.        'D'  DFT mode session 
  1439.        'C'  CUT mode session 
  1440.        'F'  5250 session 
  1441.  
  1442.     o 1 byte binary number containing Control Program features 
  1443.     o 2 byte binary number (stored in normal Intel reversed format) containing 
  1444.       the number of rows in the session 
  1445.     o 2 byte binary number (stored in normal Intel reversed format) containing 
  1446.       the number of columns in the session 
  1447.     o 2 byte binary number (stored in normal Intel reversed format) containing 
  1448.       the host code page value. 
  1449.  
  1450.  Note:  For the last three fields (row, col, codepage) use c2d(reverse(x)) 
  1451.  after parsing them out of the string to get their decimal values 
  1452.  
  1453.  
  1454. ΓòÉΓòÉΓòÉ 3.27. Query_sessions (Service 10) ΓòÉΓòÉΓòÉ
  1455.  
  1456. Syntax: 
  1457.  
  1458.  
  1459.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇsessiondata = RexHLLAPI('Query_sessions')ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1460.  
  1461.       or
  1462.  
  1463.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇsessiondata = RexHLLAPI(10)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1464.  
  1465. Purpose: 
  1466.  
  1467. Returns 12 bytes for each configured session or '' if an error occurred. 
  1468.  
  1469. Prerequisite Calls: None 
  1470.  
  1471. Arguments: 
  1472.  
  1473.  argument 1     The string constant or a variable whose contents are 
  1474.                 'Query_Sessions' or '10'. 
  1475.  
  1476.  Returns: 
  1477.  
  1478.  The session status data string is returned. 
  1479.  
  1480.  ''             Error. Check the value of the REXX variable HLLAPIRETC. 
  1481.  
  1482.  sessiondata    12 bytes for each session layed out as follows: 
  1483.  
  1484.     o 1 byte session short name 
  1485.     o 8 byte session long name in ASCII 
  1486.     o 1 byte session type 'H' 
  1487.     o 2 byte binary number (stored in standard Intel reversed format) 
  1488.       containing the presentation space size for that session. 
  1489.  
  1490.       Note:  For the last field (PSsize) use c2d(reverse(x)) after parsing it 
  1491.       out of the string to get the decimal value 
  1492.  
  1493.  Example: 
  1494.  
  1495.  The following example 
  1496.  
  1497.   session_info = REXHLLAPI('Query_sessions')
  1498.   if length(session_info) < 13 then do
  1499.     say 'No Comm. Mgr. sessions are active, canceling execution.'
  1500.     exit
  1501.     end
  1502.   j = 1
  1503.   session.0 = 0
  1504.   do i = 13 by 12 for (length(session_info) / 12) - 1
  1505.     if i > length(session_info) then leave
  1506.     session.j = substr(session_info, i, 1)
  1507.     j = j + 1
  1508.     session.0 = session.0 + 1
  1509.     end
  1510.  
  1511.  will obtain all the short session id's and assign them to the stem variable 
  1512.  session with session.0 containing the total number of available sessions. 
  1513.  
  1514.  
  1515. ΓòÉΓòÉΓòÉ 3.28. Query_system (Service 20) ΓòÉΓòÉΓòÉ
  1516.  
  1517. Syntax: 
  1518.  
  1519.  
  1520.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇsysdata = RexHLLAPI('Query_system')ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1521.  
  1522.       or
  1523.  
  1524.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇsysdata = RexHLLAPI(20)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1525.  
  1526. Purpose: 
  1527.  
  1528. Returns a 35 byte system configuration string or '' if an error occurred. The 
  1529.  
  1530. Prerequisite Calls: None 
  1531.  
  1532. Arguments: 
  1533.  
  1534.  argument 1     The string constant or a variable whose contents are 
  1535.                 'Query_System' or '20'. 
  1536.  
  1537.  Returns: 
  1538.  
  1539.  The system status data string is returned. 
  1540.  
  1541.  ''        Error. Check the value of the REXX variable HLLAPIRETC. 
  1542.  
  1543.  sysdata   35 bytes layed out as follows: 
  1544.  
  1545.     o 1 byte EHLLAPI version (ASCII) 
  1546.     o 2 byte EHLLAPI level (ASCII) 
  1547.     o 6 bytes MMDDYY EHLLAPI date (ASCII) 
  1548.     o 3 bytes of not used data 
  1549.     o 1 byte hardware base, 'Z' means look at system bytes later, 'U' means 
  1550.       unable to determine, system bytes not valid 
  1551.     o 1 byte of 'X' 
  1552.     o 2 byte binary (stored in normal Intel reverse order) sequence number 
  1553.     o 2 bytes (ASCII) of the control program number 
  1554.     o 1 byte of '1' 
  1555.     o 4 byte ASCII Extended Error code 1 
  1556.     o 4 byte ASCII Extended Error code 2 
  1557.     o 2 byte binary (stored in normal Intel reverse order) of the  hardware 
  1558.       base and sub-model types 
  1559.  
  1560.        x'FC00' 6 mhz AT 
  1561.        x'FC01' 8 mhz AT 
  1562.        x'FC02' XT 286 
  1563.        x'FC04' PS/2 Model 50 
  1564.        x'FC05' PS/2 Model 60 
  1565.        x'F800' PS/2 Model 80 
  1566.        x'F801' PS/2 Model 70 
  1567.  
  1568.     o 2 byte binary (stored in standard Intel reverse order) of the PC code 
  1569.       page being used 
  1570.     o 1 byte value identifying the display type being used 
  1571.  
  1572.        'C'  CGA 
  1573.        'E'  EGA 
  1574.        'V'  VGA 
  1575.        'H'  8514 
  1576.        'A'  8503 
  1577.        'U'  Unknown 
  1578.  
  1579.     o 3 bytes reserved and unused 
  1580.  
  1581.  
  1582. ΓòÉΓòÉΓòÉ 3.29. Query_Window_Coords (Service 103) ΓòÉΓòÉΓòÉ
  1583.  
  1584. Syntax: 
  1585.  
  1586.  
  1587.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇcoords = RexHLLAPI('Query_Window_Coords', session_id)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1588.  
  1589.       or
  1590.  
  1591.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇcoords = RexHLLAPI 103, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1592.  
  1593. Purpose: 
  1594.  
  1595. Returns the presentation space window coordinates. 
  1596.  
  1597. Prerequisite Calls: Connect_PM_Srvcs 
  1598.  
  1599. Arguments: 
  1600.  
  1601.  argument 1     The string constant or a variable whose contents are 
  1602.                 'Query_Window_Coords' or '103'. 
  1603.  
  1604.  session_id     The short name for the presentation space to query 
  1605.  
  1606.  Returns: 
  1607.  
  1608.  The window coordinates data string is returned. 
  1609.  
  1610.  ''        Not connected to a session. Check the value of the REXX variable 
  1611.            HLLAPIRETC. 
  1612.  
  1613.  coords    17 bytes data containing the window coordinates data. Refer to the 
  1614.            IBM Operation System/2 Extended Edition Version 1.2 EHLLAPI 
  1615.            Programming Reference for more information on the layout of this 
  1616.            data. 
  1617.  
  1618.  
  1619. ΓòÉΓòÉΓòÉ 3.30. Receive_File (Service 91) ΓòÉΓòÉΓòÉ
  1620.  
  1621. Syntax: 
  1622.  
  1623.  
  1624.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Receive_File', stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1625.  
  1626.       or
  1627.  
  1628.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 91, stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1629.  
  1630. Purpose: 
  1631.  
  1632. Executes the 'RECEIVE.EXE' program as if it had been entered at the command 
  1633. line. The contents of string must be an acceptable syntax for the receive 
  1634. command. 
  1635.  
  1636. Prerequisite Calls: None 
  1637.  
  1638. Arguments: 
  1639.  
  1640.  argument 1     The string constant or a variable whose contents are 
  1641.                 'Receive_File' or '91'. 
  1642.  
  1643.  string         Command line string per the syntax from the OS/2 Command 
  1644.                 Reference 
  1645.  
  1646.  Returns: 
  1647.  
  1648.  Returns the return code from the RECEIVE program. Refer to the IBM Operating 
  1649.  System/2 Extended Edition Version 1.2 User's Guide Volume 2: Communications 
  1650.  Manager and LAN Requester manual for more information on the possible return 
  1651.  codes from this service. 
  1652.  
  1653.  Example: 
  1654.  
  1655.   ret = REXHLLAPI('Receive_File', 'c:\temp.pli temp.pli(xx) ascii crlf');
  1656.  
  1657.  
  1658. ΓòÉΓòÉΓòÉ 3.31. Release (Service 12) ΓòÉΓòÉΓòÉ
  1659.  
  1660. Syntax: 
  1661.  
  1662.  
  1663.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Release'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1664.  
  1665.       or
  1666.  
  1667.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 12ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1668.  
  1669. Purpose: 
  1670.  
  1671. Unlock the connected display session keyboard for user use. 
  1672.  
  1673. Prerequisite Calls: Connect_PS 
  1674.  
  1675. Arguments: 
  1676.  
  1677.  argument 1     The string constant or a variable whose contents are 'Release' 
  1678.                 or '12'. 
  1679.  
  1680.  Returns: 
  1681.  
  1682.  The return code from the Release EHLLAPI service is returned. 
  1683.  
  1684.  '0'       Released 
  1685.  
  1686.  '1'       Not connected 
  1687.  
  1688.  '9'       System error occurred 
  1689.  
  1690.  Note:  If you disconnect while the keyboard is locked (via Reserve service) 
  1691.  then a release will be done automatically. 
  1692.  
  1693.  
  1694. ΓòÉΓòÉΓòÉ 3.32. Reserve (Service 11) ΓòÉΓòÉΓòÉ
  1695.  
  1696. Syntax: 
  1697.  
  1698.  
  1699.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Reserve'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1700.  
  1701.       or
  1702.  
  1703.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 11ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1704.  
  1705. Locks the keyboard of the currently connected session until either a Release or 
  1706. a Disconnect_PS is done. 
  1707.  
  1708. Prerequisite Calls: Connect_PS 
  1709.  
  1710. Arguments: 
  1711.  
  1712.  argument 1     The string constant or a variable whose contents are 'Reserve' 
  1713.                 or '11'. 
  1714.  
  1715.  Returns: 
  1716.  
  1717.  The return code from the Reserve EHLLAPI service is returned. 
  1718.  
  1719.  '0'       Keyboard now locked 
  1720.  
  1721.  '1'       Not connected to a session 
  1722.  
  1723.  '5'       Not locked, session in input inhibit state 
  1724.  
  1725.  '9'       System error 
  1726.  
  1727.  
  1728. ΓòÉΓòÉΓòÉ 3.33. Reset_System (Service 21) ΓòÉΓòÉΓòÉ
  1729.  
  1730. Syntax: 
  1731.  
  1732.  
  1733.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Reset_System'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1734.  
  1735.       or
  1736.  
  1737.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 21ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1738.  
  1739. Purpose: 
  1740.  
  1741. Resets the system parameters (set with Set_session_parms service) to their 
  1742. default state. 
  1743.  
  1744. Note:  Multiple processes may be using the same settings and ALL of them will 
  1745. be reset by this call. Use it with care. 
  1746.  
  1747. Prerequisite Calls: None 
  1748.  
  1749. Arguments: 
  1750.  
  1751.  argument 1     The string constant or a variable whose contents are 
  1752.                 'Reset_System' or '21'. 
  1753.  
  1754.  Returns: 
  1755.  
  1756.  The return code from the Reset_System EHLLAPI service is returned. 
  1757.  
  1758.  '0'       Ok 
  1759.  
  1760.  '9'       System error 
  1761.  
  1762.  
  1763. ΓòÉΓòÉΓòÉ 3.34. Search_Field (Service 30) ΓòÉΓòÉΓòÉ
  1764.  
  1765. Syntax: 
  1766.  
  1767.  
  1768.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI('Search_field', string, pos)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1769.  
  1770.       or
  1771.  
  1772.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI(30, string, pos)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1773.  
  1774. Purpose: 
  1775.  
  1776. Search the currently connected session's presentation space for a field 
  1777. containing the string string, starting at position pos. 
  1778.  
  1779. Prerequisite Calls: Connect_PS 
  1780.  
  1781. Arguments: 
  1782.  
  1783.  argument 1     The string constant or a variable whose contents are 
  1784.                 'Search_field' or '30'. 
  1785.  
  1786.  string         The string to be search for. 
  1787.  
  1788.  pos            The start position within the presentation space for the search 
  1789.                 to begin. 
  1790.  
  1791.  Returns: 
  1792.  
  1793.  The position of the specified string is returned. 
  1794.  
  1795.  '0'       String not found or error 
  1796.  
  1797.  > '0'     Position within the presentation of the first location of string 
  1798.  
  1799.  
  1800. ΓòÉΓòÉΓòÉ 3.35. Search_PS (Service 6) ΓòÉΓòÉΓòÉ
  1801.  
  1802. Syntax: 
  1803.  
  1804.  
  1805.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI('Search_PS', string, pos)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1806.  
  1807.       or
  1808.  
  1809.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇpos = RexHLLAPI(6, string, pos)ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1810.  
  1811. Purpose: 
  1812.  
  1813. Search the currently connect session's presentation space for the string string 
  1814. starting at position pos. If SRCHALL has been specified in the 
  1815. Set_Session_parms, then pos is not used. 
  1816.  
  1817. Prerequisite Calls: Connect_PS 
  1818.  
  1819. Arguments: 
  1820.  
  1821.  argument 1     The string constant or a variable whose contents are 
  1822.                 'Search_PS' or '6'. 
  1823.  
  1824.  string         The string to be search for. 
  1825.  
  1826.  pos            The start position within the presentation space for the search 
  1827.                 to begin. 
  1828.  
  1829.  Returns: 
  1830.  
  1831.  The position of the specified string is returned. 
  1832.  
  1833.  '0'       String not found or error 
  1834.  
  1835.  > '0'     Position within the presentation of the first location of string 
  1836.  
  1837.  
  1838. ΓòÉΓòÉΓòÉ 3.36. Send_File (Service 90) ΓòÉΓòÉΓòÉ
  1839.  
  1840. Syntax: 
  1841.  
  1842.  
  1843.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Send_File', stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1844.  
  1845.       or
  1846.  
  1847.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 90, stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1848.  
  1849. Executes the 'SEND.EXE' program as if it had been entered at the command line. 
  1850. The contents of string must be an acceptable syntax for the send command. 
  1851.  
  1852. Prerequisite Calls: None 
  1853.  
  1854. Arguments: 
  1855.  
  1856.  argument 1     The string constant or a variable whose contents are 
  1857.                 'Send_File' or '90'. 
  1858.  
  1859.  string         Command line string per the syntax from the OS/2 Command 
  1860.                 Reference. 
  1861.  
  1862.  Returns: 
  1863.  
  1864.  Returns the return code from the SEND program. Refer to the IBM Operating 
  1865.  System/2 Extended Edition Version 1.2 User's Guide Volume 2: Communications 
  1866.  Manager and LAN Requester manual for more information on the possible return 
  1867.  codes from this service. 
  1868.  
  1869.  Example: 
  1870.  
  1871.   ret = REXHLLAPI('Send_File', 'c:\temp.pli temp.pli(xx) ascii crlf');
  1872.  
  1873.  
  1874. ΓòÉΓòÉΓòÉ 3.37. Sendkey (Service 3) ΓòÉΓòÉΓòÉ
  1875.  
  1876. Syntax: 
  1877.  
  1878.  
  1879.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Sendkey', stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1880.  
  1881.       or
  1882.  
  1883.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 3, stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1884.  
  1885. Purpose: 
  1886.  
  1887. Send the keys as defined by the contents of string. Up to total of 255 keys may 
  1888. be sent at a single time. 
  1889.  
  1890. Prerequisite Calls: Connect_PS 
  1891.  
  1892. Arguments: 
  1893.  
  1894.  argument 1     The string constant or a variable whose contents are 'Sendkey' 
  1895.                 or '3'. 
  1896.  
  1897.  string         The string of characters to be sent to the currently connected 
  1898.                 presentation space. This string can include the AID key 
  1899.                 mnemonics. Some of the more common AID key mnemonics are: 
  1900.  
  1901.     '@E'    Enter 
  1902.     '@C'    Clear 
  1903.     '@n'    PF1 through PF9 where n are the characters '1' through '9'. For a 
  1904.             complete list of all AID key mnemonics refer to the IBM Operating 
  1905.             System/2 Extended Edition Version 1.2 EHLLAPI Programming Reference 
  1906.             manual. 
  1907.  
  1908.             AID key mnemonics are case sensitive. 
  1909.  
  1910.  Returns: 
  1911.  
  1912.  The return code from the Sendkey EHLLAPI service is returned. 
  1913.  
  1914.  '0'       Keystrokes sent 
  1915.  
  1916.  '1'       Not connected to a session 
  1917.  
  1918.  '2'       Incorrect parameter 
  1919.  
  1920.  '4'       Session busy, all keystrokes not sent 
  1921.  
  1922.  '5'       Session is in input inhibit state or invalid mnemonic sent 
  1923.  
  1924.  '9'       System error occurred 
  1925.  
  1926.  Example: 
  1927.  
  1928.  The following example 
  1929.  
  1930.   call REXHLLAPI 'Sendkey', '@E'
  1931.  
  1932.  will send the AID key Enter to the currently connected presentation space. 
  1933.  
  1934.  
  1935. ΓòÉΓòÉΓòÉ 3.38. Set_Cursor (Service 40) ΓòÉΓòÉΓòÉ
  1936.  
  1937. Syntax: 
  1938.  
  1939.  
  1940.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Set_Cursor', posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1941.  
  1942.       or
  1943.  
  1944.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 40, posΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1945.  
  1946. Purpose: 
  1947.  
  1948. Positions the cursor at position pos in the currently connected session. 
  1949.  
  1950. Prerequisite Calls: Connect_PS 
  1951.  
  1952. Arguments: 
  1953.  
  1954.  argument 1     The string constant or a variable whose contents are 
  1955.                 'Set_Cursor' or '40'. 
  1956.  
  1957.  pos            The position in the currently connected presentation space in 
  1958.                 which to place the cursor. 
  1959.  
  1960.  Returns: 
  1961.  
  1962.  The return code from the Set_Cursor EHLLAPI service is returned. 
  1963.  
  1964.  '0'       Ok 
  1965.  
  1966.  '1'       Not connected to a session 
  1967.  
  1968.  '4'       Session busy, all keystrokes not sent 
  1969.  
  1970.  '7'       pos in invalid for the current presentation space 
  1971.  
  1972.  '9'       System error occurred 
  1973.  
  1974.  
  1975. ΓòÉΓòÉΓòÉ 3.39. Set_Session_Parms (Service 9) ΓòÉΓòÉΓòÉ
  1976.  
  1977. Syntax: 
  1978.  
  1979.  
  1980.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Set_Session_parms', stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1981.  
  1982.       or
  1983.  
  1984.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 9, stringΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  1985.  
  1986. Purpose: 
  1987.  
  1988. Sets the current session parameters from string. 
  1989.  
  1990. Prerequisite Calls: None 
  1991.  
  1992. Arguments: 
  1993.  
  1994.  argument 1     The string constant or a variable whose contents are 
  1995.                 'Set_Session_parms' or '9'. 
  1996.  
  1997.  string         The session parameter string. The values of the session 
  1998.                 parameters are ASCII strings and are as follows: 
  1999.  
  2000.     'ATTRB'               on read_PS calls, pass back ONLY the attributes of 
  2001.                           the read string 
  2002.     'NOATTR'*             pass back only the ASCII text in the read string 
  2003.     'EAB'                 pass back extended attributes AND text in the read 
  2004.                           string 
  2005.     'NOEAB'*              pass back only text in the read string 
  2006.     'XLATE'               translate EABs to PC attribute values in the read 
  2007.                           string 
  2008.     'NOXLATE'*            do not translate EABs to PC attribute values in the 
  2009.                           read string 
  2010.     'CONPHYS'             connect to the physical session, and if required, 
  2011.                           jump to it. 
  2012.     'CONLOG'*             connect to the logical session requested, do not jump 
  2013.                           to it 
  2014.     'ESC=n'               set the keystroke mnemonic character to n, default 
  2015.                           '@' 
  2016.     'SRCHALL'*            Search the entire presentation space when doing 
  2017.                           searches 
  2018.     'SRCHFROM'            search ONLY from the specified position when doing 
  2019.                           searches 
  2020.     'SRCHFRWD'*           search from the beginning to the end of the PS 
  2021.                           (forward direction) 
  2022.     'SRCHBKWD'            search from the end of the PS to the beginning 
  2023.                           (backward direction) 
  2024.     'AUTORESET'*          will attempt to reset all inhibit conditions 
  2025.                           automatically on sendkey requests 
  2026.     'NORESET'             no reset will be attempted automatically 
  2027.     'TWAIT'*              WAIT will wait up to one minute for XCLOCK or XSYSTEM 
  2028.                           to clear before timing out 
  2029.     'LWAIT'               WAIT will wait until XCLOCK or XSYSTEM clear before 
  2030.                           returning 
  2031.  
  2032.                           Note:  This option should be used with EXTREME 
  2033.                           caution as control will NOT return until the host is 
  2034.                           available 
  2035.     'NWAIT'               no wait, return status on any WAIT calls 
  2036.     'FPAUSE'*             Full pause will take place regardless of any 
  2037.                           Start_host_notify in effect. 
  2038.     'IPAUSE'              Interruptible pause. If a pause is in progress, and a 
  2039.                           host event occurs while Start_host_notify is in 
  2040.                           effect, this pause will end. 
  2041.  
  2042.                           Note:  '*' denotes the default value for this 
  2043.                           setting. 
  2044.  
  2045.                           Please note that the session parameters STRLEN and 
  2046.                           STREOT are not included in the list above. These 
  2047.                           values cannot be changed through the REXHLAPI 
  2048.                           function package. 
  2049.  
  2050.                           More than one parameter may be set with a single 
  2051.                           service call. Seperate multiple parameters with one 
  2052.                           or more spaces. 
  2053.  
  2054.  Returns: 
  2055.  
  2056.  The return code from the Set_Session_parms EHLLAPI service is returned. 
  2057.  
  2058.  '0'       Session parameters set 
  2059.  
  2060.  '2'       Parameter string too long, or parameter error 
  2061.  
  2062.  '9'       System error 
  2063.  
  2064.  Example: 
  2065.  
  2066.  The following example 
  2067.  
  2068.   call REXHLLAPI 'SetSession_Parms', 'NORESET IPAUSE'
  2069.  
  2070.  will set the specified session parameters. 
  2071.  
  2072.  
  2073. ΓòÉΓòÉΓòÉ 3.40. Start_Close_Intercept (Service 41) ΓòÉΓòÉΓòÉ
  2074.  
  2075. Syntax: 
  2076.  
  2077.  
  2078.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Set_Close_Intercept', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2079.  
  2080.       or
  2081.  
  2082.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 41, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2083.  
  2084. Purpose: 
  2085.  
  2086. Allows the application to intercept close requests when the user selects the 
  2087. close option from the presentation space's window. 
  2088.  
  2089. Prerequisite Calls: None 
  2090.  
  2091. Arguments: 
  2092.  
  2093.  argument 1     The string constant or a variable whose contents are 
  2094.                 'Start_Close_Intercept' or '41'. 
  2095.  
  2096.  session_id     The short session name for the presentation space to begin 
  2097.                 trapping close requests. 
  2098.  
  2099.  Returns: 
  2100.  
  2101.  The return code from the Start_Close_Intercept EHLLAPI service is returned. 
  2102.  
  2103.  '0'       Ok 
  2104.  
  2105.  '1'       Invalid session_id 
  2106.  
  2107.  '2'       Parameter string error 
  2108.  
  2109.  '9'       System error 
  2110.  
  2111.  '10'      Function not supported 
  2112.  
  2113.  
  2114. ΓòÉΓòÉΓòÉ 3.41. Start_Host_Notify (Service 23) ΓòÉΓòÉΓòÉ
  2115.  
  2116. Syntax: 
  2117.  
  2118.  
  2119.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Start_Host_Notify', session_id, optionΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2120.  
  2121.       or
  2122.  
  2123.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 23, session_id, optionΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2124.  
  2125. Purpose: 
  2126.  
  2127. Starts trapping of host session screen update events. The session specified by 
  2128. session_id will be monitored for changes as requested by option. 
  2129.  
  2130. Prerequisite Calls: None 
  2131.  
  2132. Arguments: 
  2133.  
  2134.  argument 1     The string constant or a variable whose contents are 
  2135.                 'Start_Host_Notify' or '23'. 
  2136.  
  2137.  session_id     The short session name for the presentation space to begin 
  2138.                 trapping screen update events. 
  2139.  
  2140.  option         Type of event trapping to begin. The valid values for option 
  2141.                 are as follows: 
  2142.  
  2143.     'P'  Screen changes only 
  2144.  
  2145.     'O'  OIA changes only 
  2146.  
  2147.     'B'  Both OIA and screen changes 
  2148.  
  2149.  Returns: 
  2150.  
  2151.  The return code from the Start_Host_Notify EHLLAPI service is returned. 
  2152.  
  2153.  '0'       Ok 
  2154.  
  2155.  '1'       Invalid session_id 
  2156.  
  2157.  '2'       Parameter string error 
  2158.  
  2159.  '9'       System error 
  2160.  
  2161.  
  2162. ΓòÉΓòÉΓòÉ 3.42. Start_Key_Intercept (Service 50) ΓòÉΓòÉΓòÉ
  2163.  
  2164. Syntax: 
  2165.  
  2166.  
  2167.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Start_Key_Intercept', session_id, optionΓöÇΓöÇΓöÇΓöÇ
  2168.  
  2169.       or
  2170.  
  2171.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 50, session_id, optionΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2172.  
  2173. Purpose: 
  2174.  
  2175. All keystrokes to the session specified by session_id will be buffered for 
  2176. processing by the Get_key service. 
  2177.  
  2178. Prerequisite Calls: None 
  2179.  
  2180. Arguments: 
  2181.  
  2182.  argument 1     The string constant or a variable whose contents are 
  2183.                 'Start_Key_Intercept' or '50'. 
  2184.  
  2185.  session_id     The short session name for the presentation space to begin 
  2186.                 trapping keystrokes. 
  2187.  
  2188.  option         option can be either of the following 
  2189.  
  2190.     'D'  AID keys only 
  2191.     'L'  All keystroke 
  2192.  
  2193.  Returns: 
  2194.  
  2195.  The return code from the Start_Key_Intercept EHLLAPI service is returned. 
  2196.  
  2197.  '0'       Ok, monitoring started 
  2198.  
  2199.  '1'       Not connected to a session 
  2200.  
  2201.  '2'       Option was not correct 
  2202.  
  2203.  '4'       Session busy and cannot be connected 
  2204.  
  2205.  '9'       System error 
  2206.  
  2207.  
  2208. ΓòÉΓòÉΓòÉ 3.43. Stop_Close_Intercept (Service 43) ΓòÉΓòÉΓòÉ
  2209.  
  2210. Syntax: 
  2211.  
  2212.  
  2213.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Stop_Close_Intercept', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2214.  
  2215.       or
  2216.  
  2217.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 43, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2218.  
  2219. Purpose: 
  2220.  
  2221. Ends trapping of host session session_id close requests. 
  2222.  
  2223. Prerequisite Calls: Start_Close_Intercept 
  2224.  
  2225. Arguments: 
  2226.  
  2227.  argument 1     The string constant or a variable whose contents are 
  2228.                 'Stop_Close_Intercept' or '43'. 
  2229.  
  2230.  session_id     The short session name for the presentation space to stop 
  2231.                 trapping close requests. 
  2232.  
  2233.  Returns: 
  2234.  
  2235.  The return code from the Stop_Close_Intercept EHLLAPI service is returned. 
  2236.  
  2237.  '0'       Ok, monitoring ended 
  2238.  
  2239.  '1'       Not connected to a session 
  2240.  
  2241.  '2'       Parameter error 
  2242.  
  2243.  '8'       No prior Start_Close_Intercept was done 
  2244.  
  2245.  '9'       System error 
  2246.  
  2247.  '12'      Session stopped 
  2248.  
  2249.  
  2250. ΓòÉΓòÉΓòÉ 3.44. Stop_Host_Notify (Service 25) ΓòÉΓòÉΓòÉ
  2251.  
  2252. Syntax: 
  2253.  
  2254.  
  2255.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Stop_Host_Notify', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2256.  
  2257.       or
  2258.  
  2259.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 25, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2260.  
  2261. Purpose: 
  2262.  
  2263. Ends trapping of host session session_id screen update events started by a 
  2264. preceding Start_Host_Notify service. 
  2265.  
  2266. Prerequisite Calls: Start_Host_Notify 
  2267.  
  2268. Arguments: 
  2269.  
  2270.  argument 1     The string constant or a variable whose contents are 
  2271.                 'Stop_Host_Notify' or '25'. 
  2272.  
  2273.  session_id     The short session name for the presentation space to stop 
  2274.                 trapping screen and OIA updates. 
  2275.  
  2276.  Returns: 
  2277.  
  2278.  The return code from the Stop_Host_Notify EHLLAPI service is returned. 
  2279.  
  2280.  '0'       Ok, monitoring ended 
  2281.  
  2282.  '1'       Not connected to a session 
  2283.  
  2284.  '8'       No prior Start_Host_Notify was done 
  2285.  
  2286.  '9'       System error 
  2287.  
  2288.  
  2289. ΓòÉΓòÉΓòÉ 3.45. Stop_Key_Intercept (Service 53) ΓòÉΓòÉΓòÉ
  2290.  
  2291. Syntax: 
  2292.  
  2293.  
  2294.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Stop_Key_Intercept', session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2295.  
  2296.       or
  2297.  
  2298.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 53, session_idΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2299.  
  2300. Purpose: 
  2301.  
  2302. Ends trapping of keystrokes for session_id started by a preceding 
  2303. Start_Key_Interecpt service. 
  2304.  
  2305. Prerequisite Calls: Start_Key_Intercept 
  2306.  
  2307. Arguments: 
  2308.  
  2309.  argument 1     The string constant or a variable whose contents are 
  2310.                 'Stop_Key_intercept' or '53'. 
  2311.  
  2312.  session_id     The short session name for the presentation space to stop 
  2313.                 trapping keystrokes. 
  2314.  
  2315.  Returns: 
  2316.  
  2317.  The return code from the Stop_Key_Intercept EHLLAPI service is returned. 
  2318.  
  2319.  '0'       Ok, intercept ended 
  2320.  
  2321.  '1'       Not connected to a session 
  2322.  
  2323.  '8'       No prior Start_Key_Interecpt was done 
  2324.  
  2325.  '9'       System error 
  2326.  
  2327.  
  2328. ΓòÉΓòÉΓòÉ 3.46. Wait (Service 4) ΓòÉΓòÉΓòÉ
  2329.  
  2330. Syntax: 
  2331.  
  2332.  
  2333.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 'Wait'ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2334.  
  2335.       or
  2336.  
  2337.  ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇCALL RexHLLAPI 4ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
  2338.  
  2339. Purpose: 
  2340.  
  2341. Will check the status of the currently connected session. The setting (set by 
  2342. the Set_session_parms service) of TWAIT, NWAIT ot LWAIT affects how long this 
  2343. function will wait. 
  2344.  
  2345. Prerequisite Calls: Connect_PS 
  2346.  
  2347. Arguments: 
  2348.  
  2349.  argument 1     The string constant or a variable whose contents are 'Wait' or 
  2350.                 '4'. 
  2351.  
  2352.  Returns: 
  2353.  
  2354.  The return code from the Wait EHLLAPI service is returned. 
  2355.  
  2356.  '0'       Keyboard unlocked and ready for keystrokes 
  2357.  
  2358.  '1'       Not connected to a session 
  2359.  
  2360.  '4'       Wait timed out while still in XCLOCK or XSYSTEM state 
  2361.  
  2362.  '5'       Keyboard locked 
  2363.  
  2364.  '9'       System error 
  2365.  
  2366.  
  2367. ΓòÉΓòÉΓòÉ 4. Sample REXX Cmd using REXHLLAPI DLL Function Package ΓòÉΓòÉΓòÉ
  2368.  
  2369. The REXTEST3.CMD supplied on this distribution disk performs the following 
  2370. functions: 
  2371.  
  2372.  o Requests session information from Communications Manager. 
  2373.  o Searches for an unused session. 
  2374.  o Logs on to TSO. 
  2375.  o Downloads a file to the c: drive. 
  2376.  o Logs off TSO. 
  2377.  
  2378.  Because all TSO/MVS/VTAM systems are different you may have to alter some of 
  2379.  the search strings for your particular system. Be sure to set the USERID and 
  2380.  PASSWORD variables to your TSO id and password. 
  2381.  
  2382.  
  2383. ΓòÉΓòÉΓòÉ 5. Support of REXHLAPI DLL Function Package ΓòÉΓòÉΓòÉ
  2384.  
  2385. Support and enhancements for REXHLAPI will be performed by the author on an "as 
  2386. time permits" basis. If you have questions, comments or suggestions on 
  2387. improvements the author can be reached through the OS/2 Shareware BBS 
  2388. (703-385-4325) or at the address below: 
  2389.  
  2390.  Pedagogic Software 
  2391.  W. David Ashley 
  2392.  5 Timberline Dr. 
  2393.  Trophy Club, Tx 76262 
  2394.  
  2395.  AMR employees may contact me through PROFS, my user ID is Z2277. 
  2396.  
  2397.  
  2398. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2399.  
  2400. BookMark 
  2401.  
  2402. When you place a bookmark on a topic, it is added to a list of bookmarks you 
  2403. have previously set. You can view the list, and you can remove one or all 
  2404. bookmarks from the list. If you have not set any bookmarks, the list is empty. 
  2405.  
  2406. To set a bookmark, do the following: 
  2407.  
  2408.   1. Select a topic from the Contents. 
  2409.  
  2410.   2. When that topic appears, choose the Bookmark option from the Services 
  2411.      pull-down. 
  2412.  
  2413.   3. If you want to change the name used for the bookmark, type the new name in 
  2414.      the field. 
  2415.  
  2416.   4. Click on the Place radio button (or press the Up or Down Arrow key to 
  2417.      select it). 
  2418.  
  2419.   5. Click on OK (or select it and press Enter). The bookmark is then added to 
  2420.      the bookmark list. 
  2421.  
  2422.  
  2423. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2424.  
  2425. Search 
  2426.  
  2427. You can specify a word or phrase to be searched. You can also limit the search 
  2428. to a set of topics by first marking the topics on the Contentes list. 
  2429.  
  2430. To search for a word or phrase in all topics, do the following: 
  2431.  
  2432.   1. Choose the Search option from the Services pull-down. 
  2433.  
  2434.   2. Type the word or words to be searched. 
  2435.  
  2436.   3. Click on All sections (or press the Up or Down Arrow keys to select it). 
  2437.  
  2438.   4. Click on Search (or select it and press Enter) to begin the search. 
  2439.  
  2440.   5. The list of topics where the word or phrase appears is displayed. If only 
  2441.      one topic contains the word or phrase, a window containing that topic 
  2442.      appears. 
  2443.  
  2444.  
  2445. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2446.  
  2447. Print 
  2448.  
  2449. You can print one or more topics. You can also print a set of topics by first 
  2450. marking the topics on the Contents list. 
  2451.  
  2452. To print the document Contents list, do the following: 
  2453.  
  2454.   1. Choose Print from the Services pull-down. 
  2455.  
  2456.   2. Click on Contents (or press the Up or Down Arrow to select it). 
  2457.  
  2458.   3. Click on Print (or select it and press Enter). 
  2459.  
  2460.   4. The Contents list is printed on your printer. 
  2461.  
  2462.  
  2463. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2464.  
  2465. Copy 
  2466.  
  2467. You can copy a topic you are viewing into a temporary file named TEXT.TMP. You 
  2468. can later edit that file by using the editor of your choice. 
  2469.  
  2470. To copy a topic, do the following: 
  2471.  
  2472.   1. Expand the Contents list and select a topic. 
  2473.  
  2474.   2. When a topic appears, choose Copy to file from the Services pull-down. 
  2475.  
  2476.   3. The system puts the text pertaining to that topic in the temporary 
  2477.      TEXT.TMP file. 
  2478.  
  2479.  For information on one of the other choices in the Services pull-down, 
  2480.  highlight the choice and press the F1 key. 
  2481.  
  2482.  
  2483. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  2484.  
  2485. Options 
  2486.  
  2487. You can control the appearance of the Contents list. 
  2488.  
  2489. To expand the Contents and show all levels for all topics, choose Expand all 
  2490. from the Options pull-down. You can also press the Ctrl and * keys together. 
  2491.  
  2492. For information on one of the other choices in the Services pull-down, 
  2493. highlight the choice and press the F1 key.