HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TN3270_ASSOCIATION
3.161 QUERY_TN3270_ASSOCIATION
QUERY_TN3270_ASSOCIATION returns information about associations between display LUs and printer LUs.
Associations are queried by display LU name and are returned in order of display LU name.
This verb can be used to obtain information about a specific association or about multiple associations, depending
on the options used.
3.161.1 VCB Structure
typedef struct query_tn3270_association
{
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 *buf_ptr; /* pointer to buffer */
AP_UINT32 buf_size; /* buffer size */
AP_UINT32 total_buf_size; /* total buffer size required */
AP_UINT16 num_entries; /* number of entries */
AP_UINT16 total_num_entries; /* total number of entries */
unsigned char list_options; /* listing options */
unsigned char reserv3; /* reserved */
unsigned char display_lu_name[8]; /* Display LU name */
} QUERY_TN3270_ASSOCIATION;
typedef struct tn3270_association
{
AP_UINT16 overlay_size; /* Overlay size */
unsigned char reserv2[2]; /* reserved */
unsigned char display_lu_name[8]; /* Display LU name */
TN3270_ASSOCIATION_DEF_DATA def_data; /* association definition */
} TN3270_ASSOCIATION;
typedef struct tn3270_association_def_data
{
unsigned char description[32]; /* resource description */
unsigned char reserve0[16]; /* reserved */
unsigned char printer_lu_name[8]; /* name of printer LU/pool */
unsigned char reserv2[8]; /* reserved */
} TN3270_ASSOCIATION_DEF_DATA;
Data is returned in the form of
tn3270_association structures.
3.161.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_QUERY_TN3270_ASSOCIATION
buf_ptr
674