次の方法で共有

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 説明 Type 長さ
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 サービス・トランザクション・プログラム (TP) をパートナー・プログラムとして指定できる唯一の CPI-C 呼び出しです。 サービス TP に名前を付ける SNA 規則は、最大 4 文字です。 先頭の文字は、0x00 から 0x3F までの 16 進数のバイトです。 残りの文字は 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
    プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

会話は任意の状態にすることができます。

状態の変更はありません。

注釈

サイド情報内の無効な文字列パラメーター (存在しないパートナー論理ユニット (LU) の指定など) は、 Allocate が発行されるまで検出されません。 このエラーは、 Allocate の後の呼び出しで返されます。