Attachmate Worldwide  |   Contact Us  |   NetIQ.com
Home » Support » Solution Library

Technical Notes

EXTRA! Developer Tools: API Code Samples and Manuals
Technical Note 2164
Last Reviewed 28-Mar-2007
Applies To
EXTRA! X-treme version 8.0 or higher
myEXTRA! Enterprise
EXTRA! Enterprise 2000
EXTRA! Personal Client
Summary

This technical note provides information on EXTRA! application programming interfaces (APIs), including code samples and programming reference manuals.

API Information for EXTRA! Products

This technical note is organized into the following sections:

Simple Functionality Code Samples

The following code samples are provided to illustrate basic functionality. Each code sample includes function calls that perform the same four tasks:

- Connect to a host session
- Capture data
- Send keystrokes to the host.
- Disconnect host session

To use these code samples:

  1. Download the appropriate sample for your particular integrated development environment (IDE) and desired API.

Note: Typically, the OLE Automation API is recommended for new application development. (Other API information is provided as reference for existing legacy applications.)

  1. Run the downloaded .exe file on a Windows system to unzip it. (You will be prompted to accept the agreement and enter a destination directory.)
  2. See the unzipped Readme.txt file for further instructions.

API Reference Manuals

The following documentation is available for EXTRA! APIs.

API
Reference Information
OLE Automation (COM)
See the EXTRA! Macro Editor component help (installed with product), or EPC_OLE.HLP as described in Technical Note 2271.
WinHLLAPI
WinHLLAPI Language Reference
http://docs.attachmate.com/extra/x-treme/APIs/whllapi.pdf
EHLLAPI
EHLLAPI Language Reference
http://docs.attachmate.com/extra/x-treme/APIs/ehllapi.pdf
Attachmate HLLAPI
HLLAPI Language Reference
http://docs.attachmate.com/extra/x-treme/APIs/hllapi.pdf
EAL
Enterprise Access Library Language Reference
http://docs.attachmate.com/extra/x-treme/APIs/eal.pdf
PCSHLL
PCSHLL Language Reference (IBM PCOMM 4.01 EHLLAPI)
http://docs.attachmate.com/extra/x-treme/APIs/pcshll.pdf
WD_API
Wall Data (RUMBA) WD_API Language Reference
http://docs.attachmate.com/extra/x-treme/APIs/wd_api.pdf

EXTRA! Basic Code Samples

A collection of over 20 EXTRA! Basic macros is available for download. These educational samples demonstrate:

- displaying Windows dialogs,
- checking the host 3270 OIA status line,
- transferring a file at a regular interval,
- calling Win32 API functions (e.g., modify Windows registry),
- copying host screen text to a Microsoft Excel spreadsheet,
- and more.

Download eb-samples.zip and see the enclosed _ReadMe.txt file for more information.

Test Tool Code Samples

The following additional test tool code samples are available for older APIs and IDEs.

 
VB 5.0 / 6.0
VC++ 5.0 / 6.0
WinHLLAPI
hllvb32w.exe
hlltes32.exe
EHLLAPI
hllvb32e.exe
hlltes32.exe
HLLAPI
-
hlldem32.exe
EAL
atmapi32.exe
ealtutor.exe
PCSHLL
-
pcshll32.exe

By default, EXTRA! X-treme is configured to use 32-bit Enhanced Transport for HLLAPI. You can confirm the HLLAPI Transport Type selection by clicking Options > Global Preferences > Advanced.

For information on tracing API calls for debugging purposes, see Technical Note 2249.

Related Technical Notes
2183 Developer Tools for Attachmate Products
2249 Performing a Trace in EXTRA! X-treme
2271 Programming with Reflection 2007 and COM
2284 Supported Programming Interfaces with EXTRA! 6530 Client Option
2319 Support Status of 16-bit API Options in EXTRA! X-treme
2357 Configuring DOS HLLAPI Pass-through with EXTRA! X-treme
9970 Technical Notes for EXTRA!

Did this technical note answer your question?

Yes    No    Somewhat     Not sure yet

Additional comments about this tech note:

Need further help? For technical support, please contact Support.