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	描述	類型	長度
0	sym_dest_name	unsigned char	8 個位元組
8	partner_LU_name	unsigned char	17 個位元組
25	保留	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 是唯一的 CPI-C 呼叫，可讓您將 SNA 服務交易計畫指定為合作夥伴計畫 (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) ) 。 錯誤會在 配置之後的呼叫中傳回。