HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_3270_USER
Chapter 4 505
QUERY_3270_USER
QUERY_3270_USER returns information about users of the SNAplus2
3270 emulation program. It can return either summary or detailed
information, about a single user or multiple users, depending on the
options used. This verb returns information about the user's current
usage of 3270 emulation, not about the definition of this user in the
configuration file; use QUERY_3270_USER_DEF to obtain information
about the configuration file definition (such as session limits and access
to 3270 functions), and QUERY_3270_USER_SESSIONS to obtain
detailed information about individual sessions.
This verb must be issued to a running node.
VCB Structure
typedef struct query_3270_user
{
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 */
AP_UINT16 scope; /* parameters to match on */
unsigned char user_name[32]; /* 3270 user name */
unsigned char system_name[64]; /* computer name */
AP_UINT32 user_pid; /* process ID */
} QUERY_3270_USER;
typedef struct user_3270_summary
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char user_name[32]; /* 3270 user name */
unsigned char system_name[64]; /* computer name */
AP_UINT32 user_pid; /* process ID */
} USER_3270_SUMMARY;