HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs
SET_TP_PROPERTIES
The value of tp_id did not match a TP identifier assigned by APPC.
UNIX
AP_INVALID_FORMAT
The format byte is not a valid value.
AP_SYNC_NOT_ALLOWED
The application issued this verb within a callback routine, using the synchronous APPC entry point.
Any verb issued from a callback routine must use the asynchronous entry point.
State Check
No state check errors occur for this verb.
Other Conditions
If the verb does not execute because other conditions exist, APPC returns primary return codes (and, if applicable,
secondary return codes). For information about these return codes, see Appendix B, Common Return Codes.
Possible values are:
primary_rc
AP_COMM_SUBSYSTEM_ABENDED
AP_INVALID_VERB
AP_TP_BUSY
AP_UNEXPECTED_SYSTEM_ERROR
WINDOWS
AP_COMM_SUBSYSTEM_NOT_LOADED
AP_STACK_TOO_SMALL
AP_INVALID_VERB_SEGMENT
APPC does not return secondary return codes with these primary return codes.
3.5.5 State When Issued
The conversation can be in any state except Reset when the TP issues this verb.
3.5.6 State Change
The conversation state does not change for this verb.
3.6 SET_TP_PROPERTIES
UNIX
The SET_TP_PROPERTIES verb enables the application to set properties of the local TP, which are used when
allocating new conversations for the TP. It provides access to the following properties:
• The user ID to be used when allocating a new conversation specifying “already verified” security. In general,
a TP uses “already verified” security when it has been invoked by another TP specifying a valid user ID and
97