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 の後の呼び出しで返されます。