HP-UX SNAplus2 R7 APPC Programmer's Guide

TP Server Verbs
QUERY_ATTACH
Parameter Check
If the verb does not execute because of a parameter error, APPC returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_BAD_TPS_ID
The value specified for the tps_id parameter was not recognized.
AP_BAD_RES_ID
The value specified for the res_id parameter was not recognized.
Other Conditions
If the verb does not execute because other conditions exist, APPC returns the following primary return code. For a
list of return codes common to all verbs, see Appendix B, Common Return Codes.
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR
5.5 QUERY_ATTACH
The QUERY_ATTACH verb is used to retrieve information about an Attach of which SNAplus2 has notified the
application. This verb is optional. If the data represented by the TP server correlator passed into the attach callback
is sufficient for the TP server’s use, the TP server does not need to issue this verb.
For security reasons, the user id and password information in the attach are made available only to a TP server
whose effective user id is
root. For applications that do not run as root, the returned attach has had the access
security subfields stripped from it.
This verb can be issued as many times as required by the TP server. However, the PIP data can be extracted only
once. To retrieve attach information without retrieving the PIP data, issued QUERY_ATTACH with max_pip_len
set to 0 (zero).
5.5.1 VCB Structure: QUERY_ATTACH
The definition of the VCB structure for the QUERY_ATTACH verb is as follows:
typedef struct query_attach
{
AP_UINT16 opcode;
unsigned char rsrvd1; /* Reserved */
unsigned char rsrvd2; /* Reserved */
AP_UINT16 primary_rc;
AP_UINT32 secondary_rc;
AP_UINT32 tps_id;
unsigned char attach_id[8];
unsigned char tp_name[64];
char lu_alias[8];
unsigned char fq_plu_name[17]
unsigned char mode_name[8];
AP_UINT16 max_pip_len;
258