High Availability Monitors Version A.03.02 Release Notes

NOF API Verbs (QUERY Verbs)
QUERY_EMULATOR_USER_DEF
Chapter 4 679
• 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
The list_options parameter was set to
AP_LIST_INCLUSIVE, but the session_name
parameter did not match a session name defined for
the specified user.
AP_INVALID_LIST_OPTION
The list_options parameter was not set to a valid
value.
Appendix A, “Common Return Codes,” lists further secondary return
codes associated with AP_PARAMETER_CHECK, which are common to all
NOF verbs.