HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_TN3270_ACCESS_DEF
Chapter 4 971
information is the same as for the
DEFINE_TN3270_ACCESS verb, except for the
following:
• The num_sessions parameter in the def_data
structure defines the total number of sessions
defined for the user.
• If the port_number 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_CLIENT_ADDRESS
The list_options parameter was
set to AP_LIST_INCLUSIVE, but the
client_address parameter did not
match the address of any defined
TN3270 user.
AP_INVALID_PORT_NUMBER
The list_options parameter was
set to AP_LIST_INCLUSIVE, but the
port_number parameter did not
match a port number defined for the
specified TN3270 user.