qRFC API for the Inbound Queue

TRFC_GET_QIN_INFOおよびTRFC_GET_QIN_INFO_DETAILS

• 1つまたはすべてのインバウンドキューの現在のコンテンツを表示します。

TRFC_QIN_GET_CURRENT_PARAM

• インバウンドキューに関する次の情報を取得します。現在のLUWのキュー名とキューカウンターの割り当て。インバウンドキューでqRFCの再利用機能を使用する場合は、この情報が必要です。

TRFC_QIN_ACTIVATE

• キュー名（たとえば、単一または汎用）を指定する場合は、この汎用モジュールを使用します。BASIS_TEST_ *）および1つ以上のキューを処理する宛先。この機能は、通信エラーが原因でキューがブロックされている場合、またはシステムまたはアプリケーションの例外が発生して問題がすでに解決されている場合にのみ使用してください。LUWがインバウンドキューに保存されており、再有効化する必要がある場合にも使用できます。

• 関数の呼び出しによってブロックされたキューTRFC_QIN_STOPこの関数を使用して処理することはできません。

  • インポートパラメータを設定した場合MAXLUW0に等しくない値に設定すると、qRFCマネージャはインバウンドキュー内のすべてのLUWをアクティブにします。

  • インポートパラメータを設定した場合MAXTIME0以外の値（0 =キューが空になるとすぐに呼び出しが返される）にすると、qRFCマネージャーは指定された時間内にのみキューをアクティブにします。最後のLUWの処理中に時間がなくなると、この呼び出しは最後のLUWの後に返されます。

  • インポートパラメータを変更した場合モードBに対して、qRFCマネージャはバックグラウンドタスクでキューをアクティブ化します（qRFC LUWを実行します）。インポートパラメータは、このバックグラウンドジョブの開始にはオプションです（デフォルト）。即時）。

  • インポートパラメータを変更した場合モード‘L’の場合、qRFCマネージャーは、呼び出し元のコンテキストでキュー内のすべてのqRFCLUWを処理します。このキューの汎用モジュールで例外が発生した場合、qRFCマネージャはこのセッションで例外を検出できないため、ショートダンプが発生します。

  • インポートパラメータを設定した場合USERDESTSM59の「ローカル」RFC宛先（たとえば、参照宛先としてNONEまたはSPACEを使用する論理宛先）に対して、qRFCマネージャーは、現在ログオンしているユーザーの下のキューにあるすべてのqRFCLUWを処理します。宛先が入力されていない場合、またはユーザーが定義されていない場合は、現在のユーザーが使用されます。

TRFC_QIN_DELETE_LUW

• インバウンドキュー（インポートパラメータTIDで定義）のLUWを削除します。

TRFC_QIN_DELETE_QUEUE

• importパラメータで定義されたインバウンドキュー全体を削除しますQNAME。

TRFC_QIN_GET_CURRENT_QUEUES

• 現在存在するすべてのキューを表示します。

TRFC_QIN_GET_ERROR_QUEUES

• 次のステータス設定のいずれかが原因でブロックされたエラーのあるすべてのキューを表示します。SYSFAIL、CPICERR、リトライ、ARETRY、アノレトリー。

  • ステータスのあるキュー待っている表示されません。

TRFC_QIN_GET_FIRST_LUW

• キュー内の最初のLUWの情報（TIDなど）を表示します。

TRFC_QIN_GET_HANGING_QUEUES

• この関数は、アプリケーションが後で処理するためにキューに明示的に書き込んだ、ステータスを持つキューを含む、ブロックされたすべてのキューを表示します。待っている。

  • この関数は、ステータスを持つすべてのキューを表示します待っている。エラーのあるキューを表示するには、汎用モジュールを使用しますTRFC_QIN_GET_ERROR_QUEUES。

TRFC_QIN_OVERVIEW

• 現在のインバウンドキューの概要を取得します。これらには、キュー名やSAPクライアントなど、さまざまなオプションのインポートパラメータを含めることができます。

TRFC_QIN_RESTART

• キュー名（たとえば、単一または汎用）を指定する場合は、この汎用モジュールを使用します。BASIS_TEST_ *）これらのキューが以前に停止されているかどうかに関係なく、1つ以上のキューの処理を続行します。

  • インポートパラメータを変更した場合力にスペース、qRFC ManagerはSTOPカウンターを減らし、カウンターが0の場合、キューをアクティブにします。それ以外の場合、STOPカウンターのステータスに関係なく、qRFCマネージャーは常にキューをアクティブにします。

  • インポートパラメータを設定した場合MAXLUW0に等しくない値に設定すると、qRFCマネージャはインバウンドキュー内のすべてのLUWをアクティブにします。

  • キューが停止している場合は、この呼び出しを使用してください。TRFC_QIN_ACTIVATE。。

  • インポートパラメータを変更した場合NO_ACTIVATE「X」に設定すると、qRFCマネージャーはキューのロックを解除しますが、アクティブにしません。

  • インポートパラメータを設定した場合MAXTIME0に等しくない値（0 =キューが空になるとすぐに呼び出しが返される）にすると、qRFCマネージャーはこの時間内にのみキューをアクティブにします。最後のLUWの処理中に時間がなくなると、最後のLUWが処理されるとすぐにこの呼び出しが返されます。

  • インポートパラメータを設定した場合モード‘B’にすると、qRFCマネージャはキューをアクティブにし、バックグラウンドジョブでqRFCLUWを処理します。インポートパラメータは、このバックグラウンドジョブを開始するためのオプションです（デフォルト：すぐに）。即時）。

  • インポートパラメータを変更した場合モード‘L’の場合、qRFCマネージャーは、呼び出し元のコンテキストでキュー内のすべてのqRFCLUWを処理します。このキューの汎用モジュールで例外が発生した場合、qRFCマネージャはこのセッションで例外を検出できないため、ショートダンプが発生します。

  • インポートパラメータを設定した場合USERDESTトランザクションSM59の「ローカル」RFC宛先（たとえば、参照宛先としてNONEまたはSPACEを使用する論理宛先）に対して、qRFCマネージャーは、現在ログオンしているユーザーの下のキューにあるすべてのqRFCLUWを処理します。宛先が入力されていない場合、またはユーザーが定義されていない場合は、現在のユーザーが使用されます。

TRFC_QIN_RESTART_COND

• この汎用モジュールは、キュー名または優先度の高いキュー名（たとえば、単一または汎用）を指定する場合に使用します。BASIS_TEST_ *）1つ以上のキューを再起動します。

  • インポートパラメータを変更した場合TILL_STOPにスペース、qRFC Managerは、この優先度の高いキューが空になるとすぐにキューを再起動します。それ以外の場合、このキューは停止または空になるとすぐに再開されます。

  • 他にない場合止まる呼び出しがスケジュールされており、この関数を使用して呼び出しますTILL_STOP=スペース通話時にキューを自動的に終了します。

TRFC_QIN_SAVE_CURRENT_LUW

• 汎用モジュールの実行中にqRFCマネージャに、現在のLUWが正常に実行された後に保存（再利用）されることを通知します。

TRFC_QIN_STATE

• キュー名と（オプションで）SAPクライアントを指定する場合は、この汎用モジュールを使用してこのキューのステータスを表示します。

  • キューには、次の可能なステータス表示があります。準備、CPICERR、SYSFAIL、止まる、ウェイトストップ、 と待っている。

  • ステータスSYSFAIL重大なシステムエラーが原因で発生し、現在のLUWがターゲットシステムで処理されている間のシステム例外またはアプリケーション例外が原因で発生します。この状況では、キューはブロックされ、自動再起動はできません。あなたはプログラムを使うことができますRSTRFCI0LUWを再アクティブ化するか、プログラムを使用しますRSTRFCIDqRFCLUWを削除します。

  • ステータスCPICERR、自動再試行もありません。このエラーは、ローカルアプリケーションサーバーのゲートウェイが故障している場合にのみ発生する可能性があります。使用するRSTRFCI0ゲートウェイの問題が解決された後にキューを再起動します。

  • キューのステータスがウェイトストップまた待っている、エクスポートパラメータWQNAME現在のキューが処理される前に待機しているキューを表示します。

TRFC_QIN_STOP

• この関数は、キュー名を指定して1つ以上のキュー（たとえば、単一または汎用）の処理を停止する場合に使用します。BASIS_TEST_ *）。

  • インポートパラメータの場合力に変更されますスペース、qRFC Managerは、キューに存在するLUWのみを処理します。止まる時間。それ以外の場合、qRFCManagerは処理をすぐに停止します。

  • STOPカウンターは、止まる呼び出します。

  • 空の（存在しない）キューを停止することもできます。この状況では、このキューに割り当てられたすべてのLUWがqRFCテーブルに保存されます。

TRFC_QINS_DELETE_LUW

• 保存されたインバウンドキューのインポートパラメータTIDで定義されたLUWを削除します。

TRFC_QINS_DELETE_QUEUE

• importパラメータで定義されたインバウンドキュー全体を削除しますQNAME。

TRFC_QINS_ERASE

• インポートパラメータで定義されたLUWの一部またはすべてを削除しますQNAMEとFROM_COUNTそしてどれが保存されます。

TRFC_QINS_OVERVIEW

• 現在保存されているインバウンドキューの概要を取得します。

TRFC_QINS_RESTORE

• インポートパラメータで定義されたLUWの一部またはすべてを削除しますQNAMEとFROM_COUNTそしてどれが保存されます。

TRFC_RECEIVER_INFO

• tRFCまたはqRFCLUWの送信者から、TID、クライアント、ユーザー、アプリケーションサーバーのホスト名、プログラム名、トランザクションコードなどの情報を取得します。この汎用モジュールを使用して、汎用モジュールが受信キューを使用してtRFCまたはqRFCのどちらから送信されたかを判別することもできます。

TRFC_SET_QIN_PROPERTIES

• アウトバウンドキュー名、インバウンドキュー名、およびオプションでキューカウンターをqRFCマネージャーに転送します。これらのパラメーターは、バックグラウンドタスクの次の呼び出し関数に対してのみ有効です。アウトバウンドキューとインバウンドキューは同じキュー名を持つことができます。