HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_FOCAL_POINT
• 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.
3.120.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_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 B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.120.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.121 QUERY_FOCAL_POINT
QUERY_FOCAL_POINT returns information about the focal point for a specific Management Services category,
or about multiple focal points, depending on the options used.
3.121.1 VCB Structure
typedef struct query_focal_point
{
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 */
455