Windows HLLAPI Visual C++ Sample Program

Download sample project for Visual Studio 2005 (WHLLAPI3270CPP 2005.ZIP -  10.6M)

This sample program was written in Visual C++. There are two versions, one for Visual Studio 6.0 and one for Visual Studio 2005. The sample program demonstrates most of the Windows HLLAPI (WinHLLAPI) functions defined in the WinHLLAPI specification.  This application is an MDI (Multiple Document Interface) application so you may connect to multiple terminal emulation sessions at the same time.

Click the download link above to download the zip file containing the program executable and all the source code. Unzip the program to your hard drive. The zip file was saved with full path information and the \WHLLAPI3270CPP VS60\ or the WHLLAPI3270CPP VS2005\ folder will be created in the specified location.

The Visual Studio 6.0 workspace file is \WHLLAPI3270CPP VS60\WHLLAPI3270.dsw
The Visual Studio 6.0 executable file is \WHLLAPI3270CPP VS60\Release\WHLLAPI3270.exe

The Visual Studio 2005 solution file is \WHLLAPI3270CPP VS2005\WHLLAPI3270.sln
The Visual Studio 2005 executable file is \WHLLAPI3270CPP VS2005\Release\WHLLAPI3270.exe

A typical program session would look like this:

1. The WHLLAPI3270.exe file must be located in the same directory as the TN3270 Plus Whllapi.dll. If it is not, you will receive the "WinHLLAPI initialization failed" message in step 3.  
2. Start the WHLLAPI3270 program (WHLLAPI3270.exe)
3. Open the WHLLAPI3270 File menu and select New... to create a session.
4. Open the WHLLAPI3270 Other Function menu and select Start Emulator... to start TN3270 Plus.  Or, you may start TN3270 Plus manually.  
5. Connect a TN3270 Plus session. Your TN3270 Plus session must be connected before you can access the terminal emulation screen with WHLLAPI3270.exe. The TN3270 Plus session must have a WinHLLAPI Session ID defined (Setup, Host, WinHLLAPI Session ID).
6. Open the WHLLAPI3270 PS Function menu and select Connect PS. You are prompted for the Session ID. Specify the WinHLLAPI Session ID specified in your TN3270 Plus session.
7. The WHLLAPI3270 program now has access to the terminal emulation screen and you may send information to, and receive information from, the terminal emulation screen.  For example, Open the WHLLAPI3270 PS Function menu and select Copy PS to copy the contents of the terminal emulation screen into the WHLLAPI3270 window.