If your ESL APPC program calls the APPCAcceptStart subroutine, it is considered an acceptor program, and you must configure an APPN profile for the ESL APPC acceptor TP (ESLAPPCA.EXE). If using IBM's Personal Communications you should follow these steps:

1.Select the IBM Personal Communications SNA Node Configuration Utility from the Windows start Menu.

2.        Open the current default configuration file, using the "File" pull-down. If there is no default, having completed the configuration below, use the "File" pull-down to "Select Default File..."

3.        Within the Configuration options list, select "Configure Transaction Programs".

4.Select the "New..." push button

5.On the "Define a Transaction Program" basic - panel, supply the following parameter values:

TP Name:

Specify a name that is the same name as the ESL APPC acceptor profile name. This name is case sensitive. Maximum length is 64 characters

Complete pathname:

Specify the full path and filename with extension for the ESL APPC acceptor TP (EXLAPPCA.EXE). For example, specify:

c:\program files\eslsyndetic\esl\eslappca.exe

Parameters

Enter into this field an ESL APPC acceptor profile name. The name is case sensitive. The ESL acceptor profile, built using APPCSetAcceptProfile, must specify, in the INVOCATION_CMD argument, how to start your ESL program.

Conversation Type:

Select Mapped

Synchronization Level:

All options are valid; select whichever one is appropriate for your conversation. If your program does not support confirmation processing, select None.

Conversation Security required

Whether you check this option should be consistent with the SECURITY_PARAMETERS value you set using APPCSetInitProfile

6.On the "Define a Transaction Program" basic - panel, supply the following parameter values:

Receive_Allocate timeout:

This value will be dependant on the speed of the computer and the likely stress applied to this service. The default value of 3600 (i.e. 1 hour), should be acceptable in most installations.

Incomming allocate timeout:

This value will be dependant on the speed of the computer and the likely stress applied to this service. The default value of 30 seconds, should be acceptable in most installations.

TP Instance Limit

If you are not using"Queued TP", you may wish to limit the number of instances of the ESL program that will be running concurrently. The number of instances will be dependant of the performance and other resources with the server computer. Leaving this value at zero, means that there is no limit on the number of instances.

PIP Allowed

The ESL facility does not support Program Initialization Parameters, so this option does not need to be set.

Full-duplex support

Set this option if your ESL acceptor program simulates full-duplex capability by conducting two half-duplex conversations.

Dynamically Loaded

Set this option to ensure the Acceptor program is loaded when an allocation request is received on a conversation.

Queued TP

If you set this option, you can only run one instance of your ESL program at a time. If a request to start a new conversation arrives while your program is running, the request is queued until the current conversation ends.

Background Process

As ESL cannot run as a service, ensure this option is NOT selected.

Tracing may be helpful in debugging your ESL APPC applications.

The trace shows the APPC verbs issued, the parameters passed and returned, and the return codes.

To turn tracing on:

1.Start the IBM Personal Communication Facility from the start menu.

2.Select the Function Name "APPN and APPC" from the initial list.

3.Select the Component Name "APPC API" from the second list.

4.Select Trace Option, depending on the problem you are experiencing.

5.Press the Start push button.

6.Run the APPC Application, which requires communication analysis.

7.Press the Stop push button.

8.Press the Save push button, a decide where to locate the unformatted trace file.

9.Press the Format push button, locate the unformatted trace file and press OK.

10.Use a text editor, such as Notepad to view the formatted trace file.

Note: You must stop tracing in order to enable the option to copy the trace output to a file.