TPGPRIO(3cbl)

名前

TPGPRIO() - サービス要求の優先順位を獲得

形式

01 TPPRIDEF-REC.
 COPY TPPRIDEF. 
 
01 TPSTATUS-REC.
 COPY TPSTATUS. 
 
CALL "TPGPRIO" USING TPPRIDEF-REC TPSTATUS-REC.

機能説明

TPGPRIO() は、最後に送信あるいは受信した要求の優先順位を返します。 優先順位の範囲は 1 から 100 までです。最高優先順位は 100 です。 TPGPRIO() は TPCALL() または TPACALL() (また、キュー機能がインストールされている場合は TPENQUEUE() あるいは TPDEQUEUE()) の後で呼び出すことができ、返される優先順位は送信された要求のものです。 また、TPGPRIO() はサービス・ルーチン内から呼び出して、呼び出されたサービスがどの優先順位で送られたかを明らかにします。 TPGPRIO() は何回でも呼び出すことができ、次の要求が送られるまでは同じ値を返します。

会話プリミティブは優先順位と関連付けられていないので、TPSEND() や TPRECV() を発行しても、TPGPRIO() が返す優先順位には影響しません。 また、会話サービス・ルーチンの場合も、TPCALL() や TPACALL() がそのサービス内から出されないかぎり、優先順位は関連付けられません。

戻り値

TPGPRIO() の正常終了時には、TP-STATUS に [TPOK] が設定され、要求の優先順位が TPPRIDEF-REC 内の PRIORITY に返されます。

エラー

次の条件が発生すると、TPGPRIO() は異常終了し、TP-STATUS に次の値を設定します。

関連項目