HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_TP
The standard parameters for invoked TPs are defined in the invokable TP information file (for more information,
see the HP-UX SNAplus2 Administration Guide). DEFINE_TP is required only if you need to specify additional
parameters that cannot be set in the file: to restrict the TP to use particular options for conversation security, confirm
synchronization, or conversation type (mapped or basic), or to restrict the number of instances of the TP that can
be running at any time.
3.47.1 VCB Structure
typedef struct define_tp
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char tp_name[64]; /* TP name */
TP_CHARS tp_chars; /* TP characteristics */
} DEFINE_TP;
typedef struct tp_chars
{
unsigned char description[32]; /* resource description */
unsigned char security_list_name[14]; /* security access list name */
unsigned char reserv1[2]; /* reserved */
unsigned char conv_type; /* conversation type */
unsigned char security_rqd; /* security support */
unsigned char sync_level; /* synchronisation level support */
unsigned char dynamic_load; /* dynamic load (AP_YES) */
unsigned char enabled; /* is the TP enabled? */
unsigned char pip_allowed; /* program initialization */
/* parameters supported */
unsigned char reserv3[10]; /* reserved */
AP_UINT16 tp_instance_limit; /* limit on currently active TP */
/* instances */
AP_UINT16 incoming_alloc_timeout; /* reserved */
AP_UINT16 rcv_alloc_timeout; /* reserved */
AP_UINT16 tp_data_len; /* reserved */
unsigned char tp_data[120]; /* reserved */
} TP_CHARS;
3.47.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_TP
tp_name
Name of the TP being defined.
tp_chars.description
A null-terminated text string (0–31 characters followed by a null character) describing the TP. This string is for
information only; it is stored in the node’s configuration file and returned on the QUERY_TP_DEFINITION
and QUERY_TP verbs, but SNAplus2 does not make any other use of it.
tp_chars.security_list_name
Name of the security access list used by this TP (defined using the DEFINE_SECURITY_ACCESS_LIST
verb). This parameter restricts the TP so that only the users named in the specified list can allocate
263