HP-UX SNAplus2 R7 APPC Programmer's Guide

ManualsBrandsHP ManualsSoftwareHP-UX SNAplus2 Software

100

APPC Control Verbs

SET_TP_PROPERTIES

password, and is now invoking a third TP as part of the same transaction; in this case, APPC sends the user

ID from the original TP without requiring a password. Alternatively, if the TP was not invoked by another TP,

APPC uses the HP-UX user name with which the application is running as the user ID for conversation security.

However, if the TP obtained and veriﬁed the user ID and password by another means (for example, if it requires

the user to type in a user ID and password explicitly before allocating the conversation), it needs to provide the

user ID to APPC using SET_TP_PROPERTIES before invoking another TP using “already veriﬁed” security.

• Identiﬁers for the Logical Unit of Work in which the TP is participating. A Logical Unit of Work is a

transaction between APPC TPs to accomplish a particular task; it may involve two communicating TPs, or

a sequence of conversations between several TPs. There are two Logical Unit of Work Identiﬁers (LUWIDs)

associated with the TP: the unprotected LUWID, which is used for conversations with a

sync_level of AP_NONE

or AP_CONFIRM_SYNC_LEVEL, and the protected LUWID, which is used for conversations with a sync_level

of AP_SYNCPT.

3.6.1 VCB Structure: SET_TP_PROPERTIES

The deﬁnition of the VCB structure for the SET_TP_PROPERTIES verb is as follows:

typedef struct set_tp_properties

{

AP_UINT16 opcode;

unsigned char opext; /* Reserved */

unsigned char format; /* Reserved */

AP_UINT16 primary_rc;

AP_UINT32 secondary_rc;

unsigned char tp_id[8];

unsigned char set_prot_id;

unsigned char new_prot_id;

LUWID_OVERLAY prot_id;

unsigned char set_unprot_id;

unsigned char new_unprot_id;

LUWID_OVERLAY unprot_id;

unsigned char set_user_id;

unsigned char set_password;

unsigned char user_id[10];

unsigned char new_password[10];

} SET_TP_PROPERTIES;

typedef struct luwid_overlay

{

unsigned char fq_length;

unsigned char fq_luw_name[17];

unsigned char instance[6];

unsigned char sequence[2];

} LUWID_OVERLAY;

3.6.2 Supplied Parameters

The TP supplies the following parameters to APPC:

opcode

AP_SET_TP_PROPERTIES

tp_id

Identiﬁer for the local TP.