Set_TP_Name (CPI-C)

  • [アーティクル]

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

構文

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);

パラメーター

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

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

  • 大文字と小文字。

  • 0 ~ 9 の数字。

  • スペースを除く特殊文字。

    Set_TP_Nameを使用して SNA サービス・トランザクション・プログラム (TP) の名前を指定することはできません。 ただし、 Set_CPIC_Side_Information を使用してこれを行うことができます。

    漢字などの 2 バイト文字セットはサポートされていません。

    TP_name_length
    指定されたパラメーター。 パートナー プログラム名の長さを指定します。 範囲は 1 ~ 64 です。

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

リターン コード

CM_OK
主なリターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_STATE_CHECK
主なリターン コード。会話が INITIALIZE 状態ではありません。

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。次のいずれかが発生しました。

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

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

  • 変数のアドレスが無効です。

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

State Changes (状態の変化)

会話は INITIALIZE 状態である必要があります。

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