HP-UX SNAplus2 R7 APPC Programmer's Guide

TP Server Verbs
REGISTER_TP
The local LU alias. Specify this name in ASCII padded with ASCII spaces, if necessary, to a length of eight
characters. Specify a value of eight ASCII spaces (
0x20) for an LU for which all attaches will be handled.
fqplu_name
The fully qualified name of the partner LU. Specify one of the following EBCDIC strings padded with
EBCDIC spaces, if necessary, to a length of 17 characters:
• A fully qualified name in EBCDIC to indicate that a match is to be made only with an attach that has the
same fully qualified name.
• A value of all EBCDIC spaces (0x40) to indicate that any partner LU name is considered a match
• A partial name, followed by an EBCDIC * (0x5C) to indicate a wildcard LU name.
tp_type
Type of the TP being registered. Possible values are:
AP_TP_TYPE_QUEUED
Incoming attaches are queued to running copies of the TP before attempting to start a new TP or queue
the attach to wait for a suitable TP.
AP_TP_TYPE_QUEUED_BROADCAST
Same as AP_TP_TYPE_QUEUED except that the existence of the TP is broadcast around the SNAplus2
domain. Broadcasting the existence of this TP obviates the need to configure attach routing data for
many local LUs is they are all handled by the same TP on a single machine.
AP_TP_TYPE_NON_QUEUED
A new instance of the TP is started for each attach received, unless a running instance has a
RECEIVE_ALLOCATE verb outstanding.
rcv_alloc_timeout
The amount of time in seconds that the TP’s RECEIVE_ALLOCATE verb should wait for an automatically
started TP. Possible values are:
0
(zero)
Do not wait. This is normally the value specified because a TP server starts TPs in response to an
attach arriving, so there should always be an attach available for a TP’s RECEIVE_ALLOCATE. The
only exception to this is if the attach has timed out while the TP server is starting the TP.
-1
Wait indefinitely.
x where x is greater than 0
Wait the number of seconds indicated by x.
modify_existing
Specifies whether this verb is being used to change an existing registration or to register a new TP. Possible
values are:
AP_YES
This verb is being used to change the rcv_alloc_timeout parameter, the type parameter, or both of these
parameters for an existing registration. The following restrictions apply:
• The verb must be issued by the same TP Server program that issued the original REGISTER_TP
verb.
• The res_id parameter must be specified, and must match the value returned on the original
REGISTER_TP verb.
255