HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_3270_USER
Total number of entries that could have been returned. This may be higher than num_entries.
num_entries
The number of entries actually returned.
Each entry in the data buffer consists of the following:
user_3270_summary.overlay_size
The size of the returned
user_3270_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
user_3270_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.
user_3270_summary.user_name
The name of the 3270 user. This is an ASCII string of 1–32 characters.
user_3270_summary.system_name
The computer name on which the 3270 emulation program is running.
user_3270_summary.user_pid
The process ID of the 3270 emulation program.
user_3270_detail.overlay_size
The size of the returned
user_3270_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
user_3270_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.
user_3270_detail.user_name
The name of the 3270 user. This is an ASCII string of 1–32 characters.
user_3270_detail.system_name
The computer name on which the 3270 emulation program is running.
user_3270_detail.user_pid
The process ID of the 3270 emulation program.
user_3270_detail.user_uid
The user ID with which the 3270 emulation program is running.
user_3270_detail.user_gid
The group ID with which the 3270 emulation program is running.
user_3270_detail.user_gname
The group name with which the 3270 emulation program is running.
user_3270_detail.user_session_count
The number of sessions currently active for this copy of the 3270 emulation program. The application can
use the QUERY_3270_USER_SESSIONS verb to obtain detailed information about these sessions.
user_3270_detail.user_start_time
337