HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TN3270_ACCESS_DEF
tn3270_access_detail.default_record
Specifies whether this entry is the default record. Possible values are:
AP_YES
This is the default record. The client_address parameter is reserved.
AP_NO
This is a normal TN3270 user record.
tn3270_access_detail.client_address
The TCP/IP address of the TN3270 user. This is a null-terminated ASCII string.
tn3270_access_detail.num_filtered_sessions
The number of sessions returned for this user.
tn3270_access_detail.def_data
The details of the user, as defined in the configuration. This is followed by a number of session structures
defining the user’s sessions. The format of this 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.
3.160.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_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.
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.160.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.
673