Windows HLLAPI Visual C++ Sample Program

Download sample project for Visual Studio 6.0 (WHLLAPI3270CPP VS60.ZIP)
Download sample project for Visual Studio 2005 (WHLLAPI3270CPP VS2005.ZIP)

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 \WHLLAPI3270CPPVS60\WHLLAPI3270.dsw
The Visual Studio 6.0 executable file is \WHLLAPI3270CPPVS60\Release\WHLLAPI3270.exe

The Visual Studio 2005 solution file is \WHLLAPI3270CPPVS2005\WHLLAPI3270.sln
The Visual Studio 2005 executable file is:

WHLLAPI3270CPPVS2005\Release\WHLLAPI3270.exe (32-bit)
WHLLAPI3270CPPVS2005\x64\Release\WHLLAPI3270.exe (64-bit)

A typical program session would look like this:

1. Start the WHLLAPI3270 program (WHLLAPI3270.exe)

2. Open the WHLLAPI3270 File menu and select New... to create a session.

3. Respond to the prompt for the WHLLAPI DLL file. This is the DLL the application will use to interface with TN3270 Plus. In the default TN3270 Plus installation, this file is:
   c:\Programs Files (x86)\SDI\TN3270 Plus\Whllapi.dll (32-bit)
   c:\Programs Files (x86)\SDI\TN3270 Plus\Whllapi64.dll (64-bit)

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.