HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CPIC_SIDE_INFO
Each entry in the data buffer consists of the following parameters:
cpic_side_info_data.overlay_size
The size of the returned
cpic_side_info_data
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
cpic_side_info_data
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.
cpic_side_info_data.sym_dest_name
Symbolic destination name for the returned side information entry.
cpic_side_info_data.def_data.description
A null-terminated text string describing the side information entry, as specified in the definition of the side
information entry.
cpic_side_info_data.def_data.side_info.partner_lu_name
Fully qualified name of the partner LU. The name is a 17-byte EBCDIC string, right-padded with EBCDIC
spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character, and a
network name of up to 8 A-string characters.
cpic_side_info_data.def_data.side_info.tp_name_type
The type of the target TP (the valid characters for a TP name are determined by the TP type). Possible values
are:
XC_APPLICATION_TP
Application TP. All characters in the TP name must be valid ASCII characters.
XC_SNA_SERVICE_TP
Service TP. The TP name must be specified as an 8–character ASCII string representing the hexadecimal
digits of a 4-character name. For example, if the hexadecimal representation of the name is 0x21F0F0F8,
set the
def_data.side_info.tp_name parameter to the 8–character string “21F0F0F8”.
The first character (represented by two bytes) must be a hexadecimal value in the range 0x0–0x3F,
excluding 0x0E and 0x0F; the remaining characters (each represented by two bytes) must be valid
EBCDIC characters.
cpic_side_info_data.def_data.side_info.tp_name
TP name of the target TP. This is a 64-byte ASCII character string, right-padded with spaces.
cpic_side_info_data.def_data.side_info.mode_name
Name of the mode used to access the target TP. This is an 8-byte ASCII character string, right-padded with
spaces.
cpic_side_info_data.def_data.side_info.conversation_security_type
Specifies whether the target TP uses conversation security. Possible values are:
XC_SECURITY_NONE
The target TP does not use conversation security.
XC_SECURITY_PROGRAM
The target TP uses conversation security. The security_user_id and security_password parameters
specified below will be used to access the target TP.
XC_SECURITY_PROGRAM_STRONG
384