HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_TP_LOAD_INFO
lu_alias
The LU alias to query. This is an 8-byte ASCII string, padded on the right with spaces if the name is shorter
than 8 bytes. Specify all binary zeroes to match on all LUs.
This parameter can be used only if the TP is an APPC application; it is reserved if the TP is a CPI-C
application.
3.166.3 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 supplied buffer.
total_buf_size
Returned value indicating the size of buffer that would have been required to return all the list information
requested. A value greater than
buf_size indicates that not all the available entries were returned.
num_entries
Number of entries returned in the data buffer.
total_num_entries
Total number of entries available. A value greater than num_entries indicates that not all the available entries
were returned.
Each entry in the data buffer consists of the following parameters:
tp_load_info.overlay_size
The size of this overlay, including the LTV data. This size includes padding to ensure that the next overlay
falls on a properly aligned memory location.
When your application needs to go through the returned buffer to find each
tp_load_info 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.
tp_load_info.tp_name
TP name of the TP load info entry. This is a 64-byte EBCDIC string, padded on the right with spaces if the
name is shorter than 64 characters.
tp_load_info.lu_alias
The LU alias of the TP load info entry. This is an 8-byte ASCII string, padded on the right with spaces if
the name is shorter than 8 bytes.
This parameter is used only if the TP is an APPC application; it is reserved if the TP is a CPI-C application.
def_data.description
Description of the TP load info.
def_data.user_id
User ID required to access and run the TP.
def_data.group_id
Group ID required to access and run the TP.
689