HP-UX SNAplus2 R7 Administration Guide

Configuring APPC Communication
Defining TPs
Note
In this manual, the phrase “Receive_Allocate” is used to indicate any of these three
API calls.
You can also define an invokable TP to route incoming allocation requests to a running TP.
For an invokable TP, you can also specify a timeout value, to limit the wait for an allocation request. (You
can only configure this option using command-line administration.)
SNAplus2 uses the invokable TP definition for the following purposes:
• When a TP issues Receive_Allocate, SNAplus2 searches for an invokable TP definition with the appropriate
TP name. If the definition exists, and includes a value for the Receive_Allocate timeout, SNAplus2 uses
this value when processing the Receive_Allocate; otherwise it uses the default (no timeout, which causes
the TP to wait indefinitely).
• When an incoming Allocate request arrives at the target system, and the requested TP is not already running
with a Receive_Allocate outstanding, SNAplus2 searches for a TP definition with the TP name specified
on the incoming Allocate. If the definition exists, SNAplus2 uses the information in this definition to start
the TP (if multiple instances are permitted or the TP is not already running), or to determine that it should
queue the incoming Allocate (if the TP is already running and multiple instances are not permitted ).
If necessary, you can configure both types of definitions for the same TP (for example, to define conversation
security for an invokable TP).
To configure a TP definition, use one of the following methods:
To de fine APPC characteristics:
Use either of the following methods:
Motif administration program
Select
APPC and
Transaction Programs from the
Services menu on the Node window. When SNAplus2
displays the TP window, select the bottom pane and click on the
New button, or select an existing TP
definition and click on the
Properties button.
Command-line administration program
Issue the
snapadmin define_tp command.
To de fine an invokable TP:
The configuration methods for servers and clients are different:
• On a server, use either of the following methods:
Motif administration program
Select
APPC and Transaction Programs from the
Services menu on the Node window. When
SNAplus2 displays the TP window, select the top pane and click on the
New button, or select
an existing invokable TP definition and click on the
Properties
button.
Command-line administration
Issue the snaptpinstall command.
•
UNIX
On a HP-UX client, issue the snaptpinstall command.
•
WINDOWS
On a Windows client, issue the tpinst32 command.
111