HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_CPIC_SIDE_INFO
} CPIC_SIDE_INFO;
3.15.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_CPIC_SIDE_INFO
sym_dest_name
Symbolic destination name which identifies the side information entry. This is an 8-byte ASCII string, padded
on the right with spaces if necessary. The name can contain any displayable character.
def_data.description
A null-terminated text string (0–31 characters followed by a null character) describing the side information
entry. This string is for information only; it is stored in the configuration file and returned on the
QUERY_CPIC_SIDE_INFO verb, but SNAplus2 does not make any other use of it.
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.
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.
def_data.side_info.tp_name
TP name of the target TP. This is a 64-byte ASCII character string, padded on the right with ASCII spaces.
def_data.side_info.mode_name
Name of the mode used to access the target TP. This is an 8-byte ASCII character string, padded on the right
with spaces.
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.
122