APPC Verb の概要

このセクションでは、関数ごとにグループ化された各 APPC 動詞について簡単に説明します。

会話を開始する動詞

ALLOCATEORMC_ALLOCATE
ローカル トランザクション プログラム (TP) によって発行されます。 この動詞は、ローカル論理ユニット (LU) とパートナー LU の間にセッションを割り当て、ローカル TP とパートナー TP の間の会話を確立します。

ALLOCATE では、基本またはマップされた会話を確立できます。 MC_ALLOCATE は、マップされた会話のみを開始できます。 会話が割り当てられた後、APPC はこの動詞を使用して会話識別子 (conv_id)。

RECEIVE_ALLOCATE
パートナー TP によって発行されます。 この動詞は、ALLOCATE または割り当て操作を発行したローカル TP との会話をパートナー TP が開始する準備ができていることをMC_ALLOCATE。 正常に実行されると、この動詞は、パートナー TP と tp_idの TP 識別子 (conv_id) を返 conv_id

TP_STARTED
ローカル TP によって発行されます。 この動詞は、ローカル TP が開始中である APPC に通知します。 正常に実行されると、この動詞はローカル TP tp_idを返します。

データ送信用の動詞

CONFIRMorMC_CONFIRM
ローカル LU の送信バッファーの内容と確認要求をパートナー TP に送信します。

FLUSHorMC_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 が PREPARE_TO_RECEIVEMC_PREPARE_TO_RECEIVERECEIVE_AND_WAITまたは MC_RECEIVE_AND_WAIT を発行するまで待機し、ローカル TP がデータの送信を開始する前に、メッセージ交換状態がパートナー TP の RECEIVE に変わるまで待機する必要があります。

SEND_DATAまたは MC_SEND_DATA
データをローカル LU の送信バッファーに入れて、パートナー TP に送信します。

ローカル LU の送信バッファーで収集されたデータは、次のいずれかの場合にパートナー LU とパートナー TP に送信されます。

  • 送信バッファーがいっぱいに表示されます。

  • ローカル TP は 、FLUSHMC_FLUSHCONFIRMMC_CONFIRMDEALLOCATEMC_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 が非同期的にデータを受信します。 これにより、ローカル TP は、データがまだローカル LU に到着している間に処理を続行できます。

会話が 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を決定します。

データの確認またはエラーの報告に関する動詞

CONFIRMEDORMC_CONFIRMED
パートナー TP からの確認要求に応答します。 ローカル TP がエラーなしでデータを受信して処理したとパートナー TP に通知します。

RECEIVE_LOG_DATAまたは MC_RECEIVE_LOG_DATA
この動詞を発行すると、ユーザーは登録して、受信関数管理ヘッダー 7 (FMH7) エラー レポートに関連付けられているログ データを受信できます。 動詞はバッファーを APPC に渡し、受信したログ データは、そのバッファーに配置されます。 APPC は、連続する FMH7 が別のバッファーで提供されるまで (つまり、TP が別の RECEIVE_LOG_DATA または MC_RECEIVE_LOG_DATA を発行するまで、別のバッファーを指定するか、バッファーを指定しないまで)、このバッファーを引き続き使用します。

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 は基本会話動詞とマップされた会話動詞の 2 つを発行するかどうかを決定できます。

SET_TP_PROPERTIES
TP と現在のトランザクションの属性を設定するために使用します。

管理機能を提供する動詞

ACTIVATE_SESSION
指定したモードを使用して、ローカル LU と指定されたパートナー LU の間のセッションをアクティブにします。

CNOS(セッション数の変更)
APPC LU 6.2 セッション制限を確立します。

DEACTIVATE_SESSION
特定のセッション、または特定のモードのすべてのセッションを非アクティブ化します。

DISPLAY
SNA ノードの構成情報と現在の動作値を返します。

会話を終了する動詞

DEALLOCATEorMC_DEALLOCATE
2 つの TP 間の会話の割り当てを割り当てない。 この動詞は、会話の割り当てを割り当てMC_FLUSHCONFIRM、または MC_CONFIRM。

TP_ENDED
ローカルとパートナーの両方の TP によって発行されます。 TP が終了していることを APPC に通知します。 この動詞を発行すると、アクティブなメッセージ交換もすべて終了します。