MC_POST_ON_RECEIPT

[アーティクル]
07/21/2023

MC_POST_ON_RECEIPT動詞を使用すると、データまたは状態がローカル論理ユニット (LU) に到着したときに、アプリケーションが通知を同時に受信せずに、登録して通知を受け取ることができます。この動詞は、RECEIVE 状態の間にのみ発行でき、会話状態の変更は発生しません。

トランザクションプログラム (TP) がこの動詞を発行すると、APPC はすぐに TP に制御を返します。指定した条件が満たされると、 sema パラメーターで指定された Win32® イベントが通知され、動詞が完了します。次に、TP は動詞制御ブロック (VCB) のリターンコードを調べて、データまたは状態通知がローカル LU に到着したかどうかを判断し、実際にデータまたは状態通知を受信するために MC_RECEIVE_IMMEDIATE または MC_RECEIVE_AND_WAIT 動詞を発行します。

MC_POST_ON_RECEIPT動詞は、LU タイプ 6.2 の IBM トランザクション・プログラマーズ・マニュアルで説明されているように、POST_ON_RECEIPT動詞と TEST 動詞の両方を実装します。

次の構造体では、 MC_POST_ON_RECEIPT 動詞で使用される動詞制御ブロックについて説明します。

構文

  
struct mc_post_on_receipt {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv1;  
    unsigned char    primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
    unsigned short   reserv2;  
    unsigned char    reserv3;  
    unsigned char    reserv4;  
    unsigned short   max_len;  
    unsigned short   reserv5;  
    unsigned char *  reserv6;  
    unsigned char    reserv7[5];  
    unsigned long    sema;  
};

メンバー

opcode
指定されたパラメーター。動詞操作コード (AP_M_POST_ON_RECEIPT) を指定します。

opext
指定されたパラメーター。動詞操作拡張機能をAP_MAPPED_CONVERSATION指定します。

reserv1
予約済みフィールド。

primary_rc
返されたパラメーター。動詞の完了時に APPC によって設定されるプライマリリターンコードを指定します。有効なリターンコードは、発行された APPC 動詞によって異なります。この動詞の有効なエラーコードについては、「リターンコード」を参照してください。

secondary_rc
返されたパラメーター。動詞の完了時に APPC によって設定されるセカンダリリターンコードを指定します。有効なリターンコードは、発行された APPC 動詞によって異なります。この動詞の有効なエラーコードについては、「リターンコード」を参照してください。

tp_id
指定されたパラメーター。ローカル TP を識別します。このパラメーターの値は、呼び出し元 TP の TP_STARTED または呼び出された TP のRECEIVE_ALLOCATE によって返されます。

conv_id
指定されたパラメーター。会話識別子を提供します。このパラメーターの値は、呼び出し元の TP で MC_ALLOCATE するか、呼び出された TP で RECEIVE_ALLOCATE することによって返されます。

reserv2
予約済みフィールド。

reserv3
予約済みフィールド。

reserv4
予約済みフィールド。

max_len
指定されたパラメーター。通知を TP に投稿するために APPC をトリガーするデータの長さを指定します。

reserv5
予約済みフィールド。

reserv6
予約済みフィールド。

reserv7
予約済みフィールド。

Sema
指定されたパラメーター。 Win32 イベントのハンドルを指定します。イベントは TP によって作成されている必要があり、TP は呼び出しが行われる前と動詞が完了した後にリセットされるようにします。

リターンコード

AP_OK
プライマリリターンコード。動詞は正常に実行されました。

AP_DATA

セカンダリリターンコード。データは、プログラムが受け取るために使用できます。

AP_NOT_DATA

セカンダリリターンコード。データ以外の情報は、プログラムが受け取るために使用できます。

AP_CANCELLED
主なリターンコード。動詞が取り消されました。

AP_PARAMETER_CHECK
プライマリリターンコード。パラメーターエラーのため、動詞は実行されませんでした。

AP_BAD_CONV_ID

セカンダリリターンコード。 conv_id の値が、APPC によって割り当てられた会話識別子と一致しませんでした。

AP_BAD_TP_ID

セカンダリリターンコード。 tp_id の値が、APPC によって割り当てられた TP 識別子と一致しませんでした。

AP_INVALID_SEMAPHORE_HANDLE

セカンダリリターンコード。 sema パラメーターが有効な値に設定されていません。

AP_STATE_CHECK
プライマリリターンコード。動詞は無効な状態で発行されたため、実行されませんでした。

AP_ALLOCATION_ERROR
主なリターンコード。APPC が会話を割り当てませんでした。会話の状態は RESET に設定されます。

このコードは、 MC_ALLOCATE後に発行された動詞を介して返すことができます。

AP_ALLOCATION_FAILURE_NO_RETRY

セカンダリリターンコード。構成エラーやセッションプロトコルエラーなどの永続的な条件のため、会話を割り当てることができません。エラーを特定するには、システム管理者がエラーログファイルを調べる必要があります。エラーが修正されるまで、割り当てを再試行しないでください。

AP_ALLOCATION_FAILURE_RETRY

セカンダリリターンコード。リンクエラーなどの一時的な状態のため、会話を割り当てませんでした。エラーの理由は、システムエラーログに記録されます。割り当てを再試行してください。

AP_CONVERSATION_TYPE_MISMATCH

セカンダリリターンコード。パートナー LU または TP は、割り当て要求で指定された会話の種類 (基本またはマップ済み) をサポートしていません。

AP_PIP_NOT_ALLOWED

セカンダリリターンコード。割り当て要求で PIP データが指定されましたが、パートナー TP がこのデータを必要としないか、パートナー LU でサポートされていません。

AP_PIP_NOT_SPECIFIED_CORRECTLY

セカンダリリターンコード。パートナー TP には PIP データが必要ですが、割り当て要求で PIP データが指定されていないか、パラメーターの数が正しくありません。

AP_SECURITY_NOT_VALID

セカンダリリターンコード。割り当て要求で指定されたユーザー識別子またはパスワードが、パートナー LU によって受け入れられなかった。

AP_SYNC_LEVEL_NOT_SUPPORTED

セカンダリリターンコード。パートナー TP は、割り当て要求で指定された sync_level (AP_NONEまたはAP_CONFIRM_SYNC_LEVEL) をサポートしていないか、 sync_level が認識されませんでした。

AP_TP_NAME_NOT_RECOGNIZED

セカンダリリターンコード。パートナー LU は、割り当て要求で指定された TP 名を認識しません。

AP_TRANS_PGM_NOT_AVAIL_NO_RETRY

セカンダリリターンコード。リモート LU は、要求されたパートナー TP を開始できなかったため、割り当て要求を拒否しました。条件は永続的です。エラーの理由が、リモートノードでログに記録されている可能性があります。エラーが修正されるまで、割り当てを再試行しないでください。

AP_TRANS_PGM_NOT_AVAIL_RETRY

セカンダリリターンコード。リモート LU は、要求されたパートナー TP を開始できなかったため、割り当て要求を拒否しました。状態は一時的 (タイムアウトなど) である可能性があります。エラーの理由が、リモートノードでログに記録されている可能性があります。割り当てを再試行してください。

AP_COMM_SUBSYSTEM_ABENDED
プライマリリターンコード。次のいずれかの条件を示します。

このメッセージ交換で使用されているノードで、ABEND が発生しました。
TP と PU 2.1 ノードの間の接続が切断されました (LAN エラー)。
TP のコンピューターの SnaBase で ABEND が発生しました。

ABEND の理由を特定するには、システム管理者がエラーログを調べる必要があります。

AP_COMM_SUBSYSTEM_NOT_LOADED
プライマリリターンコード。動詞の処理中に、必要なコンポーネントを読み込めなかったか、終了できませんでした。そのため、通信を行うことができませんでした。是正措置については、システム管理者に問い合わせてください。

AP_DEALLOC_ABEND_PROG
主なリターンコード。次のいずれかの理由により、会話の割り当てが解除されました。
パートナー TP が MC_DEALLOCATE発行しました。
パートナー TP で異常終了が発生し、パートナー LU から MC_DEALLOCATE 要求が送信されました。

AP_DEALLOC_NORMAL
主なリターンコード。パートナー TP は、確認を要求せずに会話の割り当てを解除し、 dealloc_type 次のいずれかに設定 されたMC_DEALLOCATE を発行しました。
AP_CONFIRM_SYNC_LEVEL
AP_FLUSH
メッセージ交換の同期レベルが AP_NONE として指定されたAP_SYNC_LEVEL

AP_PROG_ERROR_NO_TRUNC
主なリターンコード。会話が SEND 状態の間に、パートナー TP が MC_SEND_ERROR を発行しました。データは切り捨てられませんでした。

AP_PROG_ERROR_PURGING
主なリターンコード。RECEIVE、PENDING、PENDING_POST、CONFIRM、CONFIRM_SEND、またはCONFIRM_DEALLOCATEの状態では、パートナー TP は MC_SEND_ERRORを発行します。送信されたが、まだ受信されていないデータは消去されます。

AP_PROG_ERROR_TRUNC
主なリターンコード。会話が SEND 状態の間に、パートナー TP が MC_SEND_ERROR を発行しました。データは切り捨てられました。

AP_SVC_ERROR_NO_TRUNC
主なリターンコード。RECEIVE、PENDING_POST、CONFIRM、 CONFIRM_SEND 、または CONFIRM_DEALLOCATE 状態の間 にAP_SVC に設定err_type MC_SEND_ERROR発行されたパートナー TP (またはパートナー LU)。パートナー TP に送信されたデータは切り捨てされませんでした。

AP_SVC_ERROR_PURGING
主なリターンコード。RECEIVE、PENDING_POST、CONFIRM、 CONFIRM_SEND 、または CONFIRM_DEALLOCATE 状態の間 にAP_SVC に設定err_type MC_SEND_ERROR発行されたパートナー TP (またはパートナー LU)。パートナー TP に送信されたデータが削除された可能性があります。

AP_SVC_ERROR_TRUNC
主なリターンコード。RECEIVE、PENDING_POST、CONFIRM、 CONFIRM_SEND 、または CONFIRM_DEALLOCATE 状態の間 にAP_SVC に設定err_type MC_SEND_ERROR発行されたパートナー TP (またはパートナー LU)。パートナー TP に送信されたデータが切り捨てられている可能性があります。