通过

Set_CPIC_Side_Information (CPI-C)

  • 项目

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 结构，该结构定义了侧边信息条目的格式。

Offset 说明 类型 Length
0 sym_dest_name unsigned char 8 字节
8 partner_LU_name unsigned char 17 字节
25 reserved unsigned char 3 个字节
28 TP_name_type signed long int 32 位
32 TP_name unsigned char 64 字节
96 mode_name unsigned char 8 字节
104 conversation_ security_type signed long int 32 位
108 security_user_ID unsigned char 8 字节
116 security_password unsigned char 8 字节

sym_dest_name允许的字符是 A 到 Z) (大写字母，以及 0 到 9 的数字。

Set_CPIC_Side_Information 是唯一允许将 SNA 服务交易计划指定为合作伙伴计划的 CPI-C 调用 (TP) 。 用于命名服务 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) ) 。 在 分配后调用时返回错误。