Command Reference Guide

Administration Commands
define_cpic_side_info
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary
return codes that are common to all commands.
2.13 define_cpic_side_info
The define_cpic_side_info command adds a side information entry to the configuration file or replaces
an existing entry. A CPI-C side information entry associates a set of conversation characteristics with a symbolic
destination name.
Because CPI-C side information entries are defined as domain resources, this command is not associated with a
particular node.
2.13.1 Supplied Parameters
Parameter name Type Length Default
[define_cpic_side_info]
sym_dest_name character 8
description character 31 (null string)
partner_lu_name character 17 (null string)
tp_name_type constant APPLICATION_TP
tp_name character 64 (null string)
mode_name character 8 (null string)
conversation_security_type constant NONE
security_user_id character 10 (null string)
security_password character 10 (null string)
lu_alias character 8 (null string)
Supplied parameters are:
sym_dest_name
Symbolic destination name that identifies the side information entry. The name can contain any displayable
character.
description
A text string describing the side information entry. SNAplus2 uses this string for information only. It is
stored in the node’s configuration file and returned on the query_cpic_side_info command.
partner_lu_name
Fully qualified name of the partner LU. Specify 3–17 type-A characters that consist of a 1–8 character network
name, followed by a period, followed by a 1–8 character partner LU name.
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:
APPLICATION_TP
Application TP. All characters in the TP name must be valid ASCII characters.
SNA_SERVICE_TP
Service TP. The TP name must be specified as a hex array representing the 8 hexadecimal digits of
a 4-character name (for example 0x21F0F0F8). The first character (represented by two hexadecimal
70