IBM Support

Data Collection: Personal Communications EHLLAPI or HACL application problems

Recommended Resources


If the IBM Personal Communications EHLLAPI or HACL APIs do not function as expected, gather the following information.


When debugging macro problems, you must provide the following items to IBM support:

  • A description of the problem and scenario that you used
  • A Personal Communications trace of the failure
  • The Information Bundler output file

If you have already contacted support, continue to Component-specific Data Collection information. Otherwise, refer to Data Collection: Read first for all WebSphere Application Server products.

Component-specific Data Collection information

Describing the problem and scenario

When describing the problem and scenario, you should include the following information:

  • The name of the API for which problem is occurring (for example, EHLLAPI, HACL C++, HACL Automation Objects).
  • Details necessary to recreate the problem.

Capturing a Personal Communications trace of the API

The trace captures the entry and exit points in the API. Follow these steps to capture a trace:

  1. In the Administrative and PD Aids folder, select Trace Facility. Otherwise, from an active session, select Actions > Launch > Trace Facility.
  2. Increase the size of the trace buffer, to ensure that it is sufficient to capture the needed flows.
    1. From the main window of the Trace Facility, select Options > Preferences.
    2. Set the trace buffer size to 4096.
    3. Click OK.
  3. Select the appropriate line flow trace, based for the data types shown in this table.
    Function Name Component Name Trace Option
    3270/5250/VT Emulator API EHLLAPI
    3270/5250/VT Emulator Event Keystroke
    1. Close all Personal Communications sessions.
    2. Click Start in the Trace Facility window.
    3. Recreate the problem scenario.
    4. Click Stop in the Trace Facility window.
    5. Click Save to save the trace data to your hard disk.
    6. Click Format to specify a formatted trace file name and format the trace data.
Note: The Information Bundler utility should be used immediately after the trace is complete, to ensure that the correct information is gathered. It is not recommended that you change the default path for the formatted trace file. If you change the default path, the Information Bundler might not be able to locate the trace information.

Create the Information Bundler output file

Use the following procedure to create the information bundle:

  1. From the Administrative and PD Aids folder, click Information Bundler. Otherwise, from an active session, select Actions > Launch > Information Bundler.
  2. In the Information Bundler window, select the All Keys radio button.
  3. Click OK.

The Information Bundler output file (X12345.EXE) is created in the Personal Communications system-class application data directory. This file must be submitted to IBM support, so make note of its location when running the Information Bundler.

What to do next?
When you have collected the Data Collection information, submit the diagnostic information to IBM support. See Submitting Diagnostic Information to IBM Technical Support for Problem Determination for specific information.

For Technotes, downloads, and educational materials specific to Personal Communications, see the Personal Communications support site.

Document information

More support for: Personal Communications
General Information

Software version: 5.9, 6.0

Operating system(s): Windows

Reference #: 1220667

Modified date: 04 October 2011

Translate this page: