This section describes some of the more common REXX EHLLAPI functions. For a complete description of all of the EHLLAPI functions, refer to the EHLLAPI Programming Reference.
Note: Before invoking EHLLAPI function, your REXX program must first load them. Refer to the sample program for the procedure to load REXX EHLLAPI support.
Connects the program to the emulator presentation space to allow sending or monitoring presentation space activities. Connect is a prerequisite function for the presentation space functions, like Copy_PS_To_String and Sendkey.
Connect_PM
Connects the program to the Presentation Manager window (the PC5250 emulation window) to allow for manipulation. Connect_PM is a prerequisite function for the PM window-based functions, like Change_Window_Name and Get_Window_Status.
Disconnect
Disconnects the REXX program from the currently connected session. Any program connected to a host presentation space with the Connect command must be disconnected.
Connect
Disconnect_PM
Disconnects the REXX program from the specified session window. Any program connected to a Presentation Manager window with the Connect_PM command must be disconnected.
Change_Window_Name
Allows the program to change or reset the session name as displayed in the windows title bar. To use Change_Window_Name, you must first use Connect_PM.
Copy_PS_To_Str
Copies all of the text on an emulation session display into a REXX variable. To use Copy_PS_To_Str, you must first Connect.
Query_Sessions
Returns information about configured emulator sessions.
Reset_System
Reinitializes any changed session parameters and disconnects from all connected resources. It is appropriate to Reset_System before exiting from a REXX EHLLAPI program.
Searches the currently connected presentation space for the specified string. To use Search_PS, you must first Connect.
Transmits keystrokes to the currently connected presentation space. To use Sendkey, you must first Connect.
Set_Cursor_Pos
Positions the cursor at the specified position in the currently connected presentation space. One use of Set_Cursor_Pos is to move the cursor to an area in the presentation space as a result of Search_PS, where you will be programmatically typing keystrokes with Sendkey.
Set_Window_Status
Changes the window status of the specified session based on the specified action
(e.g., make the emulator session window invisible). To use Set_Window_Status, you must first Connect_PM.
Waits for host request to complete and indicate a ready state. Your REXX EHLLAPI program must wait after specifying host requests like Sendkey. You do not have to wait for PM window functions like Set_Window_Status. To use Wait, you must first Connect.
LATEST COMMENTS
MC Press Online