このセクションでは、関数ごとにグループ化された各 APPC 動詞について簡単に説明します。
会話を開始するための動詞
ALLOCATEまたは MC_ALLOCATE
ローカル トランザクション プログラム (TP) によって発行されます。 この動詞は、ローカル論理ユニット (LU) とパートナー LU の間にセッションを割り当て、ローカル TP とパートナー TP の間の会話を確立します。
ALLOCATE は、基本会話またはマップされた会話を確立できます。 MC_ALLOCATE は、マップされた会話のみを開始できます。 会話が割り当てられた後、APPC はこの動詞を使用して会話識別子 (conv_id) を返します。
RECEIVE_ALLOCATE
パートナー TP によって発行されます。 この動詞は、パートナー TP が ALLOCATE またはMC_ALLOCATEを発行したローカル TP との会話を開始する準備ができていることを確認 します。 正常に実行されると、この動詞はパートナー TP とconv_idの TP 識別子 ( tp_id) を返します。
TP_STARTED
ローカル TP によって発行されます。 この動詞は、ローカル TP が開始されていることを APPC に通知します。 正常に実行されると、この動詞はローカル TP の tp_id を返します。
データを送信するための動詞
CONFIRMまたは MC_CONFIRM
ローカル LU の送信バッファーの内容と確認要求をパートナー TP に送信します。
FLUSHまたは MC_FLUSH
ローカル LU の送信バッファーをフラッシュし、バッファーの内容をパートナー LU と TP に送信します。 送信バッファーが空の場合、アクションは行われません。
PREPARE_TO_RECEIVEまたは MC_PREPARE_TO_RECEIVE
メッセージ交換の状態を SEND から RECEIVE に変更します。 会話の状態を変更する前に、この動詞は FLUSH、 MC_FLUSH、 CONFIRM、またはMC_CONFIRMと同等の機能 を実行します。 この動詞が正常に実行されると、ローカル TP はデータを受信できます。
REQUEST_TO_SENDまたは MC_REQUEST_TO_SEND
ローカル TP がデータを送信することをパートナー TP に通知します。 ローカル TP は、ローカル TP がデータの送信を開始する前に、パートナー TP が PREPARE_TO_RECEIVE、 MC_PREPARE_TO_RECEIVE、 RECEIVE_AND_WAIT、または MC_RECEIVE_AND_WAITを発行し、会話状態が RECEIVE に変わるまで待機する必要があります。
SEND_DATAまたは MC_SEND_DATA
パートナー TP に送信するために、ローカル LU の送信バッファーにデータを格納します。
ローカル LU の送信バッファーで収集されたデータは、次のいずれかが発生すると、パートナー LU とパートナー TP に送信されます。
送信バッファーがいっぱいになります。
ローカル TP は、 FLUSH、 MC_FLUSH、 CONFIRM、 MC_CONFIRM、 DEALLOCATE、 MC_DEALLOCATE、またはローカル LU の送信バッファーをフラッシュする別の動詞を発行します。
データを受信するための動詞
POST_ON_RECEIPTまたは MC_POST_ON_RECEIPT
この動詞を発行すると、データまたは状態がローカル LU に到着したときに、アプリケーションが通知を受信できるように登録できます。同時に実際に受信する必要はありません。 この動詞は RECEIVE 状態の間にのみ発行でき、会話状態の変更は発生しません。
TP がこの動詞を発行すると、APPC はすぐに制御を TP に返します。 指定した条件が満たされると、パラメーターとして指定された Win32® イベントが通知され、動詞が完了します。 次に、TP は動詞制御ブロック内のリターン コードを調べて、データまたは状態通知がローカル LU に到着したかどうかを判断し、実際にデータまたは状態通知を受信するために RECEIVE_IMMEDIATE または RECEIVE_AND_WAIT 動詞を発行します。
RECEIVE_AND_POSTまたは MC_RECEIVE_AND_POST
会話が RECEIVE 状態の間にこの動詞を発行すると、会話の状態がPENDING_POSTに変わり、ローカル TP が非同期的にデータを受信するようになります。 これにより、データがローカル LU に到達している間、ローカル TP は処理を続行できます。
会話が SEND 状態の間にこの動詞を発行すると、LU の送信バッファーがフラッシュされ、会話の状態がPENDING_POSTに変更されます。 その後、ローカル TP は非同期的にデータの受信を開始します。
RECEIVE_AND_WAITまたは MC_RECEIVE_AND_WAIT
会話が RECEIVE 状態の間にこの動詞を発行すると、ローカル TP はパートナー TP から現在使用可能なすべてのデータを受信します。 使用可能なデータがない場合、ローカル TP はデータの到着を待機します。
会話が SEND 状態の間にこの動詞を発行すると、LU の送信バッファーがフラッシュされ、会話の状態が RECEIVE に変更されます。 その後、ローカル TP がデータの受信を開始します。
RECEIVE_IMMEDIATEまたは MC_RECEIVE_IMMEDIATE
パートナー TP から現在使用可能なすべてのデータを受け取ります。 使用可能なデータがない場合、ローカル TP は待機しません。
TEST_RTSまたは MC_TEST_RTS
REQUEST_TO_SENDまたはMC_REQUEST_TO_SENDまたは通知を受信したかどうかを判断します。
データの確認またはエラーの報告に関する動詞
確認済みまたは MC_CONFIRMED
パートナー TP からの確認要求に応答します。 ローカル TP がエラーなしでデータを受信して処理したことをパートナー TP に通知します。
RECEIVE_LOG_DATAまたは MC_RECEIVE_LOG_DATA
この動詞を発行すると、ユーザーは、受信関数管理ヘッダー 7 (FMH7) エラー レポートに関連付けられているログ データを受け取るために登録できます。 動詞はバッファーを APPC に渡し、受信したログ データはそのバッファーに配置されます。 APPC は、別のバッファーが提供されるまで (つまり、TP が別の RECEIVE_LOG_DATA を発行するまで、または別のバッファーを指定するか、バッファーをまったく指定しない MC_RECEIVE_LOG_DATA ) まで、連続する FMH7 が到着するまで、このバッファーを引き続き使用します。
SEND_CONVERSATIONまたは MC_SEND_CONVERSATION
この動詞は、呼び出し元 TP によって発行され、ローカル LU とパートナー LU の間にセッションを割り当て、セッション上のデータを送信してから、セッションの割り当てを解除します。
SEND_ERRORまたは MC_SEND_ERROR
ローカル TP でアプリケーション レベルのエラーが発生したことをパートナー TP に通知します。
情報を取得および設定するための動詞
GET_ATTRIBUTESまたは MC_GET_ATTRIBUTES
会話の属性を取得するために TP によって使用されます。
GET_LU_STATUS
特定のリモート LU の状態を報告するために使用されます。
GET_STATE
TP が特定の会話の状態を問い合わせて使用します。
GET_TP_PROPERTIES
TP と現在のトランザクションの属性を返します。
GET_TYPE
TP が特定の会話の会話の種類 (基本またはマップ) を決定するために使用されます。 この情報を使用して、TP は基本的な会話動詞とマップされた会話動詞のどちらを発行するかを決定できます。
SET_TP_PROPERTIES
TP と現在のトランザクションの属性を設定するために使用されます。
管理機能を提供する動詞
ACTIVATE_SESSION
指定したモードを使用して、ローカル LU と指定したパートナー LU の間のセッションをアクティブにします。
CNOS(セッション数の変更)
APPC LU 6.2 セッション制限を確立します。
DEACTIVATE_SESSION
特定のセッション、または特定のモードのすべてのセッションを非アクティブ化します。
表示
SNA ノードの構成情報と現在の動作値を返します。
会話を終了するための動詞
DEALLOCATEまたは MC_DEALLOCATE
2 つの TP 間の会話の割り当てを解除します。 会話の割り当てを解除する前に、この動詞は FLUSH、 MC_FLUSH、 CONFIRM、またはMC_CONFIRMと同等の処理 を実行します。
TP_ENDED
ローカルおよびパートナーの両方の TP によって発行されます。 TP が終了していることを APPC に通知します。 この動詞を発行すると、アクティブな会話も終了します。