Set_CPIC_Side_Information调用（函数名称 xcmssi）在内存中添加或替换侧信息条目。 CPI-C 侧信息条目将一组聊天特征与符号定义名称相关联。 此调用替代具有相同符号目标名称的条目。
语法
CM_ENTRY Set_CPIC_Side_Information(
unsigned char FAR *key_lock,
SIDE_INFO FAR *side_info_entry,
CM_INT32 FAR *side_info_entry_length,
CM_INT32 FAR *return_code
);
参数
key_lock
提供的参数。 忽略此参数。
side_info_entry
提供的参数。 指定侧信息条目的内容。 下表描述了 side_info_entry 结构，该结构定义侧信息条目的格式。
| 抵消 | DESCRIPTION | 类型 | 长度 |
|---|---|---|---|
| 0 | sym_dest_name | 无符号字符 | 8 字节 |
| 8 | partner_LU_name | 无符号字符 | 17 字节 |
| 二十五 | 保留 | 无符号字符 | 3 个字节 |
| 28 | TP_name_type | 已签名的长 int | 32 位 |
| 32 | TP_name | 无符号字符 | 64 字节 |
| 96 | mode_name | 无符号字符 | 8 字节 |
| 104 | conversation_ security_type | 已签名的长 int | 32 位 |
| 108 | security_user_ID | 无符号字符 | 8 字节 |
| 116 | security_password | 无符号字符 | 8 字节 |
sym_dest_name的允许字符是大写字母（A 到 Z），数字从 0 到 9。
Set_CPIC_Side_Information 是唯一允许将 SNA 服务事务计划（TP）指定为合作伙伴计划的 CPI-C 调用。 用于命名服务 TP 的 SNA 约定最多为四个字符。 第一个字符是0x00和0x3F之间的十六进制字节。 其余字符从 ASCII 转换为 EBCDIC。
有关其他字段的允许字符，请参阅相应 Set_ 调用的说明。 例如，对于 mode_name 字段，请参阅 Set_Mode_Name 调用的说明。
结构中的每个字段都必须左对齐。 根据需要用空格填充右侧的字段。
side_info_entry_length
提供的参数。 指定 side_info_entry的长度。 它始终为 124。
return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。
返回代码
CM_OK
主要返回代码;调用已成功执行。
CM_PROGRAM_PARAMETER_CHECK
主要返回代码;发生以下事件之一：
side_info_entry结构中指定的值无效。
side_info_entry的左字符包含空格。
CM_PRODUCT_SPECIFIC_ERROR
主要返回代码;发生了特定于产品的错误，并且已记录在产品错误日志中。
状态更改
对话可以处于任何状态。
没有状态更改。
注解
在发出 “分配 ”之前，在侧信息（例如，指定不存在的伙伴逻辑单元（LU）中无效的字符串参数。 在 “分配”之后的调用中返回错误。