Manualshelf

HP-UX SNAplus2 R7 APPC Programmer's Guide

ManualsBrandsHP ManualsSoftwareHP-UX SNAplus2 Software
241242243244245246247248249250
TP Server Verbs
REGISTER_TP_SERVER
5 TP Server Verbs
UNIX
This chapter contains a description of each APPC TP server verb. The following information is provided for each
verb:
• Definition of the verb.
• Structure defining the verb control block (VCB) used by the verb. The structure is defined in the TP Server
header file /usr/include/sna/tpsrv_c.h. (Parameters beginning with rsrvd are reserved.)
• Parameters (VCB fields) supplied to and returned by APPC. For each parameter, the following information is
provided:
• Description
• Possible values
• Additional information
• Additional information describing the use of the verb.
Notes
1. TP server verbs must be issued using the asynchronous entry point APPC_Async, and
not the synchronous entry point APPC. For more information about these entry points,
see Chapter 2, Writing Transaction Programs.
2. TP server verbs do not affect APPC conversations or states.
Most parameters supplied to and returned by APPC for the TP Server verbs are hexadecimal values. To
simplify coding, these values are represented by meaningful symbolic constants defined in the header file
values_c.h, which is included by the TP Server header file tpsrv_c.h. For example, the opcode
parameter of the REGISTER_TP_SERVER verb is the hexadecimal value represented by the symbolic constant
AP_REGISTER_TP_SERVER.
It is important that you use the symbolic constant and not the hexadecimal value when setting values for supplied
parameters, or when testing values of returned parameters. This is because different HP-UX systems store these
values differently in memory, so the value shown may not be in the format recognized by your system.
The TP server verbs are described in the following order:
REGISTER_TP_SERVER
UNREGISTER_TP_SERVER
REGISTER_TP
UNREGISTER_TP
QUERY_ATTACH
ACCEPT_ATTACH
REJECT_ATTACH
ABORT_ATTACH
5.1 REGISTER_TP_SERVER
The REGISTER_TP_SERVER verb is used to notify SNAplus2 that the application is capable of automatically
starting transaction programs (TPs).
249