Send_Error (CPI-C)

2025-06-05

Send_Error呼び出し (関数名 cmserr) は、ローカル・プログラムがアプリケーション・レベルのエラーを検出したことをパートナー・プログラムに通知します。

構文

  
CM_ENTRY Send_Error(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *request_to_send_received,    
  CM_INT32 FAR *return_code              
);

パラメーター

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

request_to_send_received
返されたパラメーター。受信要求インジケーターを指定します。使用可能な値は次のとおりです。

CM_REQ_TO_SEND_RECEIVED
Request_To_Send 発行されたパートナープログラムは、会話を RECEIVE 状態に変更するようローカルプログラムに要求します。

CM_REQ_TO_SEND_NOT_RECEIVED
パートナープログラムは Request_To_Sendを発行しませんでした。この値は、 return_codeが CM_PROGRAM_PARAMETER_CHECK または CM_STATE_CHECK に設定されている場合は関係ありません。

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

リターンコード

return_codeの値は、呼び出しが発行されたときの会話の状態によって異なります。

SEND 状態

プログラムが SEND 状態の会話で呼び出しを発行した場合、次のリターンコードが可能です。

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

CM_OPERATION_NOT_ACCEPTED
プライマリリターンコード。この会話に対する以前の操作は不完全です。

CM_OPERATION_INCOMPLETE
プライマリリターンコード。操作が完了せず (処理モードは非ブロッキングのみ)、進行中です。プログラムは、操作の完了を待機するWait_For_Conversationを発行するか、操作と会話を取り消す Cancel_Conversation できます。 Specify_Windows_Handleが呼び出された場合、アプリケーションは Microsoft® Windows® メッセージによる通知を待機し、Wait_For_Conversation呼び出す必要はありません。

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

CM_CONVERSATION_TYPE_MISMATCH
プライマリリターンコード。パートナー論理ユニット (LU) またはプログラムは、割り当て要求で指定された会話の種類 (基本またはマップ) をサポートしていません。

CM_PIP_NOT_SPECIFIED_CORRECTLY
プライマリリターンコード。割り当て要求が、CPI-C 以外の LU 6.2 トランザクションプログラム (TP) によって拒否されました。パートナー・プログラムには、CPI-C でサポートされていない 1 つ以上の PIP データ変数が必要です。

CM_SECURITY_NOT_VALID
プライマリリターンコード。割り当て要求で指定されたユーザー ID またはパスワードが、パートナー LU によって受け入れられなかった。

CM_SYNC LEVEL_NOT_SUPPORTED_PGM
プライマリリターンコード。パートナープログラムは、割り当て要求で指定された同期レベルをサポートしていません。

CM_TPN_NOT_RECOGNIZED
プライマリリターンコード。パートナー LU は、割り当て要求で指定されたプログラム名を認識しません。

CM_TP_NOT_AVAILABLE_NO_RETRY
プライマリリターンコード。永続的な条件のため、パートナー LU は割り当て要求で指定されたプログラムを開始できません。エラーの理由は、リモートノードに記録される可能性があります。エラーが修正されるまで、割り当てを再試行しないでください。

CM_TP_NOT_AVAILABLE_RETRY
プライマリリターンコード。パートナー LU は、一時的な条件のため、割り当て要求で指定されたプログラムを開始できません。エラーの理由は、リモートノードに記録される可能性があります。割り当てを再試行します。

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

RECEIVE または CONFIRM 状態の間、パートナープログラムは Send_Errorを発行しました。送信されたデータがまだ受信されていないデータは消去されます。
エラーの方向がCM_RECEIVE_ERRORに設定SEND_PENDING状態の間、パートナープログラムは Send_Errorを発行しました。データが消去されませんでした。

CM_RESOURCE_FAILURE_NO_RETRY
プライマリリターンコード。次のいずれかが発生しました。
永続的な状態のため、会話が途中で終了しました。エラーが修正されるまで再試行しないでください。
パートナープログラムは、正常に終了する前に会話の割り当てを解除しませんでした。

CM_RESOURCE_FAILURE_RETRY
プライマリリターンコード。モデム障害などの一時的な状態のため、会話が途中で終了しました。会話を再試行します。

CM_DEALLOCATED_ABEND
プライマリリターンコード。次のいずれかの理由により、会話の割り当てが解除されました。
リモート・プログラムがCM_DEALLOCATE_ABENDするタイプ・パラメーター・セットを使用して割り振り解除を発行したか、リモート・プログラムの異常終了状態が原因でリモート LU が割り当てを解除しました。呼び出しの発行時にリモート・プログラムの会話が RECEIVE 状態であった場合、ローカル・プログラムによって送信され、リモート・プログラムがまだ受信していない情報は消去されます。
リモート TP は正常に終了しましたが、終了する前に会話の割り当てを解除しませんでした。リモート LU のノードサービスは、リモート TP に代わって会話の割り当てを解除しました。

CM_DEALLOCATED_ABEND_SVC
プライマリリターンコード。次のいずれかの理由により、会話の割り当てが解除されました。
パートナープログラムは、型パラメーターを ABEND_SVC に設定して 割り当て解除 を発行しました。
パートナープログラムは、終了する前に会話の割り当てを解除しませんでした。

この呼び出しがローカル・プログラムによって発行されたときに、パートナー・プログラムの会話が RECEIVE 状態にある場合、ローカル・プログラムによって送信され、まだパートナー・プログラムによって受信されていないデータは消去されます。

CM_DEALLOCATED_ABEND_TIMER
プライマリリターンコード。パートナープログラムが型パラメーターを ABEND_TIMER に設定して 割り当てを解除 を発行したため、会話の割り当てが解除されました。この呼び出しがローカル・プログラムによって発行されたときに、パートナー・プログラムの会話が RECEIVE 状態にある場合、ローカル・プログラムによって送信され、まだパートナー・プログラムによって受信されていないデータは消去されます。

CM_SVC_ERROR_PURGING
プライマリリターンコード。SEND 状態の場合、パートナープログラムまたはパートナー LU は、型パラメーターを SVC に設定して Send_Error 発行しました。パートナープログラムに送信されたデータが消去されている可能性があります。

RECEIVE 状態

呼び出しが RECEIVE 状態で発行された場合、次のリターンコードが可能です。

CM_OK
プライマリリターンコード。受信情報は 、Send_Error 呼び出しが RECEIVE 状態で発行されると消去されるため、次の代わりにCM_OKが生成されます。
CM_PROGRAM_ERROR_NO_TRUNC
CM_PROGRAM_ERROR_PURGING
CM_SVC_ERROR_NO_TRUNC
CM_SVC_ERROR_PURGING
CM_PROGRAM_ERROR_TRUNC
CM_SVC_ERROR_TRUNC (基本的な会話のみ)
CM_PRODUCT_SPECIFIC_ERROR
CM_RESOURCE_FAILURE_NO_RETRY
CM_RESOURCE_FAILURE_RETRY

これらのリターンコードの詳細については、「一般的なリターンコードCPI-C」を参照してください。

CM_DEALLOCATED_NORMAL
プライマリリターンコード。受信情報は RECEIVE 状態で発行されると Send_Error 消去されるため、次の代わりにCM_DEALLOCATED_NORMALが生成されます。
CM_CONVERSATION_TYPE_MISMATCH
CM_PIP_NOT_SPECIFIED_CORRECTLY
CM_SECURITY_NOT_VALID
CM_SYNC_LEVEL_NOT_SUPPORTED_PGM
CM_TPN_NOT_RECOGNIZED
CM_TP_NOT_AVAILABLE_NO_RETRY
CM_TP_NOT_AVAILABLE_RETRY
CM_DEALLOCATED_ABEND
CM_DEALLOCATED_ABEND_SVC
CM_DEALLOCATED_ABEND_TIMER

SEND_PENDING状態

呼び出しがSEND_PENDING状態で発行された場合、次のリターンコードが可能です。
CM_OK (プライマリリターンコード。呼び出しは正常に実行されました)。
CM_PRODUCT_SPECIFIC_ERROR
CM_PROGRAM_ERROR_PURGING
CM_RESOURCE_FAILURE_NO_RETRY
CM_RESOURCE_FAILURE_RETRY
CM_DEALLOCATED_ABEND
CM_DEALLOCATED_ABEND_SVC
CM_DEALLOCATED_ABEND_TIMER
CM_SVC_ERROR_PURGING

これらのリターンコードの詳細については、「一般的なリターンコードCPI-C」を参照してください。

CONFIRM、CONFIRM_SEND、または CONFIRM_DEALLOCATE State

呼び出しが CONFIRM、CONFIRM_SEND、またはCONFIRM_DEALLOCATE状態で発行された場合は、次のリターンコードを使用できます。
CM_OK (プライマリリターンコード。呼び出しは正常に実行されました)。
CM_PRODUCT_SPECIFIC_ERROR
CM_RESOURCE_FAILURE_NO_RETRY
CM_RESOURCE_FAILURE_RETRY

これらのリターンコードの詳細については、「一般的なリターンコードCPI-C」を参照してください。

その他の状態

RESET または INITIALIZE 状態の会話で Send_Error を発行することは無効です。次のリターンコードを使用できます。

CM_PROGRAM_PARAMETER_CHECK
プライマリリターンコード。 conversation_ID で指定された値が無効です。

CM_PROGRAM_STATE_CHECK
プライマリリターンコード。会話の状態が SEND、RECEIVE、CONFIRM、CONFIRM_SEND、CONFIRM_DEALLOCATE、またはSEND_PENDINGではありません。

状態の変更

会話は、INITIALIZE または RESET 以外の任意の状態にすることができます。

次の表に示す状態の変更は、 return_code パラメーターの値に基づいています。

return_code	新しい状態
CM_OK	送信
CM_CONVERSATION_TYPE_MISMATCH	リセット
CM_PIP_NOT_SPECIFIED_CORRECTLY	リセット
CM_SECURITY_NOT_VALID	リセット
CM_SYNC_LEVEL_NOT_SUPPORTED_PGM	リセット
CM_TPN_NOT_RECOGNIZED	リセット
CM_TP_NOT_AVAILABLE_NO_RETRY	リセット
CM_TP_NOT_AVAILABLE_RETRY	リセット
CM_RESOURCE_FAILURE_RETRY	リセット
CM_RESOURCE_FAILURE_NO_RETRY	リセット
CM_DEALLOCATED_ABEND	リセット
CM_DEALLOCATED_ABEND_PROG	リセット
CM_DEALLOCATED_ABEND_SVC	リセット
CM_DEALLOCATED_ABEND_TIMER	リセット
CM_DEALLOCATED_NORMAL	リセット
CM_PROGRAM_ERROR_PURGING	受ける
CM_SVC_ERROR_PURGING	受ける
その他のすべて	変更なし

この呼び出しが正常に実行されると、会話はローカルプログラムの場合は SEND 状態になり、パートナープログラムの場合は RECEIVE 状態になります。

基本的な会話では、ローカルプログラムは Set_Log_Data を使用して、エラーログデータをパートナー LU に送信し、ローカルエラーログに追加することを指定できます。会話ログのデータ長特性が 0 より大きい場合、LU はデータをフォーマットし、送信バッファーに格納します。

Send_Errorが完了すると、ログデータの長さが 0 に設定され、ログデータが null に設定されます。

プログラムが Send_Errorを発行したときに会話が RECEIVE 状態の場合、受信データは CPI-C によって消去されます。このデータには、次のものが含まれます。

Send_Dataによって送信されるデータ。
確認要求。
会話の割り当て解除の種類が CM_DEALLOCATE_CONFIRM に設定されているか、同期レベルが CM_CONFIRM に設定されたCM_DEALLOCATE_SYNC_LEVELに設定されている場合、割り当て解除要求。

CPI-C は、受信した要求から送信へのインジケーターを要求しません。

会話がSEND_PENDING状態の場合、ローカル・プログラムは Set_Error_Direction を発行して、エラーが受信したデータから、またはデータを正常に受け取った後のローカル・プログラムの処理によって、エラーが発生したかどうかを指定できます。

注釈

ローカルプログラムは、受信したデータで発生したエラーをパートナープログラムに通知したり、確認要求を拒否したり、送信中の不完全な論理レコードを切り捨てたりする目的で、 Send_Error を使用できます。

Send_Error ローカル LU 送信バッファーをフラッシュし、パートナープログラムに送信バッファーの内容とエラー通知を送信します。

エラー通知は、次のいずれかの return_code 値としてパートナーに送信されます。

CM_PROGRAM_ERROR_TRUNC
CM_PROGRAM_ERROR_NO_TRUNC
CM_PROGRAM_ERROR_PURGING

次の方法で共有

Send_Error (CPI-C)

構文

パラメーター

リターン コード

注釈

その他のリソース

リターンコード