HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_3270_USER_SESSIONS
The time at which the user started the 3270 emulation program (this may be earlier than the start time for
the first session). This value is specified as “seconds since epoch” (the number of seconds since the start of
the year 1970).
3.88.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_3270_USER
The user_name, system_name,oruser_pid parameter was not set to a valid value.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.88.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.89 QUERY_3270_USER_SESSIONS
QUERY_3270_USER returns information about a 3270 emulation user’s current sessions. It can return either
summary or detailed information, about a single session or multiple sessions, depending on the options used. The
application can use QUERY_EMULATOR_USER_DEF to obtain information about the configuration file definition
of a 3270 user (such as session limits and access to 3270 functions), and QUERY_3270_USER to obtain general
information about the user’s 3270 emulation program usage.
This verb must be issued to a running node.
3.89.1 VCB Structure
typedef struct query_3270_user_sessions
{
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 */
338