HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_3270_USER
3.88 QUERY_3270_USER
QUERY_3270_USER returns information about 3270 emulation program users. 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_EMULATOR_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.
3.88.1 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[5]; /* reserved */
AP_UINT16 scope; /* parameters to match on */
unsigned char user_name[32]; /* 3270 user name */
unsigned char system_name[128]; /* 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[128]; /* computer name */
AP_UINT32 user_pid; /* process ID */
unsigned char reserv3[4]; /* reserved */
} USER_3270_SUMMARY;
typedef struct user_3270_detail
{
AP_UINT16 overlay_size; /* size of returned entry */
unsigned char user_name[32]; /* 3270 user name */
unsigned char system_name[128]; /* computer name */
AP_UINT32 user_pid; /* process ID */
AP_UINT32 reserv1; /* reserved */
AP_UINT32 user_uid; /* user ID */
AP_UINT32 user_gid; /* group ID */
unsigned char user_gname[32]; /* group name */
AP_UINT32 user_session_count; /* count of user’s 3270 sessions */
AP_UINT32 user_start_time; /* time when user started the */
/* 3270 emulation program */
334