HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TN3270_ACCESS_DEF
last_user_incomplete
Specifies whether the information for the last user is incomplete. Possible values are:
AP_YES
The complete data for the last user was too large to fit in the data buffer. At least one session structure
is included, but there are further session structures that are not included in the data buffer. The
num_last_sessions parameter indicates how many session structures have been returned; the application
can issue further verbs to obtain the remaining data.
AP_NO
The data for the last user is complete.
Each entry in the data buffer consists of the following:
tn3270_access_summary.overlay_size
The size of the returned
tn3270_access_summary
structure, and therefore the offset to the start of the next entry
in the data buffer.
When your application needs to go through the returned buffer to find each
tn3270_access_summary
structure
in turn, it must use this value to move to the correct offset for the next data structure, and must not use the
C
sizeof() operator. This is because the size of the returned overlay may increase in future releases of
SNAplus2; using the returned overlay size ensures that your application will continue to work with future
releases.
tn3270_access_summary.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_summary.client_address
The TCP/IP address of the TN3270 user. This is a null-terminated ASCII string.
tn3270_access_summary.address_format
Specifies the format of the client_address parameter. Possible values are:
AP_ADDRESS_IP
IP address
AP_ADDRESS_FQN
Alias or fully qualified name
tn3270_access_detail.overlay_size
The size of the returned
tn3270_access_detail structure, and therefore the offset to the start of the next entry in
the data buffer.
When your application needs to go through the returned buffer to find each
tn3270_access_detail
structure in
turn, it must use this value to move to the correct offset for the next data structure, and must not use the
C sizeof() operator. This is because the size of the returned overlay may increase in future releases of
SNAplus2; using the returned overlay size ensures that your application will continue to work with future
releases.
tn3270_access_detail.sub_overlay_offset
The offset to the start of the first session data structure for this TN3270 access record in the data buffer.
672