|
|
tpsprio(3c)
名前
tpsprio()-サービス要求の優先順位の設定
形式
#include <atmi.h>
int tpsprio(prio, flags)
機能説明
tpsprio() は、カレント・コンテキストのカレント・スレッドが、次に送信または転送する要求の優先順位を設定します。設定された優先順位は、次に送信される要求に対してのみ有効です。メッセージのキュー登録機能がインストールされている場合、優先順位を tpenqueue() や tpdequeue() によってキューへ登録、または削除されたメッセージに対しても設定することができます。デフォルトの設定では、prio の設定条件が正か負かにより、サービスのデフォルトの優先順位が最大 100、あるいは最小 1 に上下します。100 が最も高い優先順位です。要求のデフォルトの優先順位は、その要求の送信先となるサービスによって決まります。このデフォルトの設定は、構成時に指定してもよいですし (UBBCONFIG(5) を参照)、システムのデフォルト値 50 を使用してもかまいません。tpsprio() は、tpconnect() あるいは tpsend() を介して送られたメッセージには影響しません。
メッセージは、10 回に 1 回は FIFO 方式に基づいて取り出されるため、優先順位の低いメッセージがキューにいつまでも残されることはありません。優先度の低いインターフェイスやサービスでは、応答時間を問題にすべきではありません。
マルチスレッドのアプリケーションでは、tpsprio() はスレッド単位で動作します。
次に、有効なフラグの一覧を示します。
マルチスレッドのアプリケーションの場合、TPINVALIDCONTEXT 状態のスレッドは、tpsprio() の呼び出しを発行できません。
戻り値
異常終了すると、tpsprio() は -1 を返し、tperrno() を設定してエラー条件を示します。
エラー
異常終了時には、tpsprio() は tperrno() を次のいずれかの値に設定します。
関連項目
tpacall(3c)、 tpcall(3c)、 tpdequeue(3c)、 tpenqueue(3c)、 tpgprio(3c)
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|