HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_EMULATOR_USER_DEF
Chapter 4694
The details of the user, as defined in the configuration.
This is followed by a number of session structures,
defining the user's sessions and the user's remap list.
The format of this information is the same as for the
DEFINE_EMULATOR_USER verb, except for the
following:
• The sub_overlay_size def_data parameter in the
structure specifies the size of each returned
session_def_data structure, and therefore the
offset to the start of the next entry in the data
buffer.
• The num_sessions parameter in the def_data
structure defines the total number of sessions
(3270, 5250, or both) defined for the user.
• If the session_name parameter was set to a
nonzero value, the data for the first user will
contain only the remaining session structures
(starting from the requested entry), without the
def_data structure.
• If the last_user_incomplete parameter is set to
AP_YES, the total number of session structures
returned for the last user will be as specified by the
num_last_sessions parameter; this will be less
than num_sessions .
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_EMULATOR_USER
The list_options parameter was
set to AP_LIST_INCLUSIVE, but the
user_name parameter did not match
the name of any defined user.
AP_INVALID_SESSION_NAME