HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_3270_USER_SESSIONS
Chapter 4 515
If the SNAplus2 system includes only one server, this
parameter is required only if the user is using more
than one copy of the 3270 emulation program. If there
are multiple servers and no process ID is specified,
SNAplus2 returns the first entry it finds for the
specified user name; there is no need to specify the
process ID unless the specified user is using more than
one copy of the 3270 emulation program on the
computer specified by the system_name parameter. If
the process ID is not required, set it to zero.
lu_name
The LU used by the session for which information is
required, or the LU name to be used as an index into
the list of sessions. This parameter is ignored if
list_options is set to AP_FIRST_IN_LIST. The name
is an 8-character EBCDIC string, padded on the right
with EBCDIC spaces if necessary.
Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc
AP_OK
buf_size
Length of the information returned in the buffer.
total_buf_size
Returned value indicating the size of buffer that would
have been required to return all the list information
requested. This may be higher than buf_size .
total_num_entries
Total number of entries that could have been returned.
This may be higher than num_entries .
num_entries
The number of entries actually returned.
system_name