4D v12.4

PROCESS PROPERTIES

ホーム

 
4D v12.4
4D - ランゲージリファレンス
プロセス
PROCESS PROPERTIES

 

PROCESS PROPERTIES 


 

PROCESS PROPERTIES ( process ; procName ; procState ; procTime {; procVisible {; uniqueID {; origin}}} ) 
引数 型   説明
process  倍長整数 in プロセス番号
procName  文字 in プロセス名
procState  倍長整数 in プロセスの状態
procTime  倍長整数 in プロセスの稼働時間 (Tick)
procVisible  ブール in TRUE: 表示, FALSE: 非表示
uniqueID  整数 in ユニークなプロセス番号
origin  倍長整数 in プロセスの発生源

説明   

PROCESS PROPERTIESコマンドはprocessに渡したプロセス番号を持つプロセスに関する情報を返します。

このコマンド呼出し後に:

  • procNameはプロセスの名前を返します。プロセス名で注意すべき点は、次のとおりです:
    • プロセスがメソッド実行ダイアログボックスから (新規プロセスオプションを選択した状態で) 起動された場合、プロセスの名前は“P_”で始まりその後に数字が続きます。
    • プロセス開始プロパティが選択されたカスタムメニューから起動されたプロセスの場合には、プロセスの名前は“M_”または“ML_”で始まり、その後に数字が続きます。
    • Webサーバーによりプロセスが開始されれた場合、名前は"Web Process#"+UUIDです。
    • プロセスがアボートしていた場合（そして、そのスロットがまだ再使用されていない場合)、プロセスの名前はそのまま返されます。プロセスがアボートしたかどうかを検出するには、procState=-1を判定します（下記の表を参照）。
  • procStateは、呼び出しを行った時点のプロセスの状態を返します。この引数は次の定義済定数で提供される値のいずれか1つを返します:
    定数 型 値
    Aborted 倍長整数 -1
    Delayed 倍長整数 1
    Does not exist 倍長整数 -100
    Executing 倍長整数 0
    Hidden modal dialog 倍長整数 6
    Paused 倍長整数 5
    Waiting for input output 倍長整数 3
    Waiting for internal flag 倍長整数 4
    Waiting for user event 倍長整数 2

  • procTimeは、プロセスが起動されてからの稼働時間をtick数 (1/60秒) で返します。
  • procVisibleが指定された場合には、プロセスが表示されている場合はTRUE、隠されている場合はFALSEを返します。
  • uniqueIDが指定された場合には、独自のプロセス番号を返します。各プロセスはプロセス番号と、セッション内でユニークなプロセス番号を持っています。ユニークプロセス番号は、2つのプロセス間または2つのプロセスセッションの間で区別することができるようにするものです。これは4Dセッションの間に開始されたプロセス番号に対応するものです。
  • originが指定された場合には、プロセスの発生元を表わす値を返します。4Dは下記の定数を定義しています (Process Typeテーマ内):
    定数 型 値
    Apple Event Manager 倍長整数 -7
    Backup Process 倍長整数 -19
    Cache Manager 倍長整数 -4
    Client Manager Process 倍長整数 -31
    Created from execution dialog 倍長整数 3
    Created from Menu Command 倍長整数 2
    Design Process 倍長整数 -2
    Event Manager 倍長整数 -8
    Execute on Client Process 倍長整数 -14
    Execute on Server Process 倍長整数 1
    External Task 倍長整数 -9
    Indexing Process 倍長整数 -5
    Internal 4D Server Process 倍長整数 -18
    Internal Timer Process 倍長整数 -25
    Log File Process 倍長整数 -20
    Main Process 倍長整数 -1
    Method editor macro Process 倍長整数 -17
    Monitor Process 倍長整数 -26
    MSC Process 倍長整数 -22
    None 倍長整数 0
    On Exit Process 倍長整数 -16
    Other 4D Process 倍長整数 -10
    Other User Process 倍長整数 4
    Process Server Interface 倍長整数 -15
    Restore Process 倍長整数 -21
    Serial Port Manager 倍長整数 -6
    SQL Method Execution Process 倍長整数 -24
    Web Process on 4D Client 倍長整数 -12
    Web Process with no Context 倍長整数 -3
    Web Process with no Context 倍長整数 -3
    Web server Process 倍長整数 -13

注: 4Dの内部プロセスは負の値を返し、ユーザが作成したプロセスは正の値を返します。

プロセスが存在しない場合、つまり1からCount tasksまでの番号を渡さなかった場合、PROCESS PROPERTIESコマンドは変数パラメータの変更を行いません。

次の例は、変数vName, vState, vTimeSpentに現在のプロセスのプロセス名、プロセスステータス、プロセス時間を返します:

 C_STRING(80;vName) ` Initialize the variables
 C_INTEGER(vState)
 C_INTEGER(vTime)
 PROCESS PROPERTIES(Current process;vName;vState;vTimeSpent)

On Exitデータベースメソッドの例題参照

 
プロパティ 

プロダクト: 4D
テーマ: プロセス
番号: 336

 
履歴 

変更: 4D v11 SQL Release 3

 
参照 

Count tasks
Process state