Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com

Accueil

 
4D v20.6
PROCESS PROPERTIES

PROCESS PROPERTIES 


 

PROCESS PROPERTIES ( process ; procNom ; procStatut ; procTemps {; procMode {; uniqueID {; origine}}} ) 
Paramètre Type   Description
process  Entier long in Numéro du process
procNom  Chaîne in Nom du process
procStatut  Entier long in Statut du process
procTemps  Entier long in Temps d'exécution cumulé du process en ticks
procMode  Booléen, Entier long in Si booléen : Visible (Vrai) ou Caché (Faux)
Si entier long (champ de bits) : bit 0 = Visibilité, bit 1 = Exécution en préemptif
uniqueID  Entier long in Numéro unique du process
origine  Entier long in Origine du process

La commande PROCESS PROPERTIES retourne diverses informations sur le process dont vous passez le numéro dans process.

Note : Si le process n'existe pas, ce qui veut dire que vous n'avez pas passé, dans process, un nombre inclus dans l'intervalle [1>Count tasks], PROCESS PROPERTIES laisse les valeurs des variables passées en paramètres inchangées.

Après l'appel :

  • procNom retourne le nom du process. Quelques points sont à noter à propos du nom du process :
    • Si le process a été démarré depuis la boîte de dialogue Exécuter une méthode (avec l'option Nouveau process sélectionnée), son nom est “P_” suivi d'un numéro.
    • Si le process a été démarré à partir d'une commande de menu personnalisé dont la propriété Démarrer un process est sélectionnée, le nom du process est “M_” ou “ML_” suivi d'un numéro.
    • Si le process a été démarré par le serveur Web, son nom est "Web Process#" suivi d'un identifiant UUID.
    • Si un process a été stoppé (et son “espace” non encore réutilisé), son nom est encore retourné. Pour détecter si un process est stoppé, testez procStatut=-1 (voir ci-dessous).
  • procStatut retourne le statut du process au moment de l'appel. Ce paramètre peut retourner l'une des valeurs fournies par les constantes prédéfinies suivantes :
    Constante Type Valeur
    Does not exist Entier long -100
    Aborted Entier long -1
    Executing Entier long 0
    Delayed Entier long 1
    Waiting for user event Entier long 2
    Waiting for input output Entier long 3
    Waiting for internal flag Entier long 4
    Paused Entier long 5

 

  • procTemps retourne le cumul du temps que le process a utilisé depuis qu'il a été démarré, en ticks (1/60e de seconde).
  • Le paramètre optionnel procMode peut être une variable de type booléen ou entier long :
    • s'il est de type booléen, il retourne Vrai si le process est visible et Faux s'il est caché.
    • s'il est de type entier long, il contient après l’exécution de la méthode un champ de bits où les deux premiers bits sont définis :
      • le bit 0 retourne la propriété de visibilité : 1 si le process est visible, et 0 s'il est caché
      • le bit 1 retourne la propriété de mode préemptif : 1 si le process est exécuté en mode préemptif, et 0 s'il est exécuté en mode coopératif. Pour plus d'informations, reportez-vous à la section Process 4D préemptifs.
  • uniqueID, s'il est spécifié, retourne le numéro unique du process. En effet, chaque process se voit attribuer un numéro de process ainsi qu’un numéro unique de process par session. Ce dernier permet de différencier strictement deux process ou sessions de process. Il correspond au nombre de process ayant été lancés au cours de la session de l’application 4D.
 

  • origin, s'il est spécifié, retourne une valeur décrivant l’origine du process. 4D propose les constantes prédéfinies suivantes (thème "Type du process") : 

    Constante Type Valeur Comment
    Apple event manager Entier long -7
    Backup process Entier long -19
    Cache manager Entier long -4
    Client manager process Entier long -31
    Compiler process Entier long -29
    Created from execution dialog Entier long 3
    Created from menu command Entier long 2
    DB4D Cron Entier long -49
    DB4D Flush cache Entier long -46
    DB4D Garbage collector Entier long -47
    DB4D Index builder Entier long -45
    DB4D Listener Entier long -51
    DB4D Mirror Entier long -50
    DB4D Worker pool user Entier long -48
    Design process Entier long -2
    Event manager Entier long -8
    Execute on client process Entier long -14
    Execute on server process Entier long 1
    External task Entier long -9
    HTTP Listener Entier long -56
    HTTP Log flusher Entier long -58
    HTTP Worker pool server Entier long -55
    Indexing process Entier long -5
    Internal 4D server process Entier long -18
    Internal timer process Entier long -25
    Log file process Entier long -20
    Logger process Entier long -57
    Main 4D process Entier long -39
    Main process Entier long -1
    Method editor macro process Entier long -17
    Monitor process Entier long -26
    MSC process Entier long -22
    None Entier long 0
    On exit process Entier long -16
    Other 4D process Entier long -10
    Other internal process Entier long -40
    Other user process Entier long 4
    Restore Process Entier long -21
    Serial Port Manager Entier long -6
    Server interface process Entier long -15
    ServerNet Listener Entier long -43
    ServerNet Session manager Entier long -44
    SOAP process Entier long -33
    SQL Listener Entier long -54
    SQL Method execution process Entier long -24
    SQL Net Session manager Entier long -53
    SQL Worker pool server Entier long -52
    Web process on 4D remote Entier long -12
    Web process with no context Entier long -3
    Web server process Entier long -13
    Web server spare process Entier long -32
    Worker pool in use Entier long -41
    Worker pool spare Entier long -42
    Worker process Entier long 5 Process worker lancé par l’utilisateur
     

    Note: Les process internes à 4D retournent une valeur négative et les process générés par l’utilisateur retournent une valeur positive.

L'exemple suivant retourne le nom, le statut, et le temps écoulé dans les variables vNom, vStatut, et vTempsPassé pour le process courant :

 C_TEXT(vNom//Initialiser les variables
 C_LONGINT(vStatut)
 C_LONGINT(vTempsPassé)
 PROCESS PROPERTIES(Current process;vNom;vStatut;vTempsPassé)

Voir l'exemple de la section Semaphore.

Pour connaître la visibilité et le mode d'exécution du process courant, vous pouvez écrire :

 C_TEXT(vNom)
 C_LONGINT(vStatut)
 C_LONGINT(vDurée)
 C_LONGINT(vMode//peut être déclaré en booléen si on veut juste connaître la visibilité
 C_BOOLEAN(estVisible)
 C_BOOLEAN(estPreemptif)
 PROCESS PROPERTIES(Current process;vNom;vStatut;vDurée;vMode)
 estVisible:=vMode?? 0 //vrai si visible
 estPreemptif:=vMode?? 1 //vrai si préemptif



Voir aussi  

Count tasks
Get process activity
Process 4D préemptifs
Process state

 
PROPRIÉTÉS 

Produit : 4D
Thème : Process
Numéro : 336

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
PAGE CONTENTS 
 
HISTORIQUE 

Modifié : 4D v11 SQL Release 3
Modifié : 4D v15 R5

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v20)
4D - Langage ( 4D v20.1)
4D - Langage ( 4D v20.2)
4D - Langage ( 4D v20.3)
4D - Langage ( 4D v20.4)
4D - Langage ( 4D v20.5)
4D - Langage ( 4D v20.6)