Set_Partner_LU_Name (CPI-C)

  • [アーティクル]

Set_Partner_LU_Name呼び出し (関数名 cmspln) は、パートナー論理装置 (LU) 名を指定するために呼び出し側プログラムによって発行されます。 この呼び出しは、 Initialize_Conversation 呼び出しが発行されたときに、サイド情報から派生したパートナー LU 名をオーバーライドします。 Allocate が発行された後は、この呼び出しを発行できません。 この呼び出しを発行しても、サイド情報自体には影響しません。

構文

  
CM_ENTRY Set_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  CM_INT32 FAR *return_code              
);

パラメーター

conversation_ID
指定されたパラメーター。 会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversationによって返されました。

partner_LU_name
指定されたパラメーター。 パートナー LU 名の開始アドレスを指定します。 モード名には、最大 17 文字の ASCII 文字を含めることができます。 使用できる文字は次のとおりです。

  • 大文字。

  • 0 ~ 9 の数字。

    パートナー LU 名には、次のいずれかを指定できます。

  • 1 から 8 文字で構成されるエイリアス。

  • 2 ~ 17 文字で構成される完全修飾ネットワーク名。 ピリオドは、ネットワーク ID (0 から 8 文字) とネットワーク LU 名 (1 文字から 8 文字まで) を区切ります。 ネットワーク識別子が 0 文字の長さである場合、期間は引き続き必要です。

    パートナー LU 名は、構成時に確立されたパートナー LU の名前と一致している必要があります。

    partner_LU_name_length
    指定されたパラメーター。 パートナー LU 名の長さを指定します。 範囲は 1 ~ 17 です。

    return_code
    この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。

リターン コード

CM_OK
プライマリ リターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_STATE_CHECK
プライマリ リターン コード。メッセージ交換が INITIALIZE 状態ではありません。

CM_PROGRAM_PARAMETER_CHECK
プライマリ リターン コード。次のいずれかが発生しました。

  • conversation_IDで指定された値が無効です。

  • partner_LU_name_lengthで指定された値が範囲外です (17 より大きいか、1 未満)。

    CM_PRODUCT_SPECIFIC_ERROR
    プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

スレッドは INITIALIZE 状態である必要があります。

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

注釈

partner_LU_nameに無効な値を指定することは、Allocate が発行されるまで検出されません。