Lire activite process

4D v20.6


Lire activite process {( options )} -> Résultat

Paramètre	Type	Description
options	Entier long	Options de retour
Résultat	Objet	Aperçu des process en cours d'exécution et/ou (4D Server uniquement) des sessions utilisateur

Description

La commande Lire activite process retourne une vue instantanée des sessions des utilisateurs connectés et/ou des process exécutés à un instant précis. Cette commande retourne tous les process, y compris les process internes qui n'étaient pas accessibles à la commande INFORMATIONS PROCESS.

Lorsqu'elle est exécutée sur le serveur, par défaut si vous omettez le paramètre options, Lire activite process retourne les listes des sessions utilisateur et des process, comme présenté ci-dessous :

{
"sessions": [
          {
             "type": "remote",
             "userName": "Designer",
             "machineName": "iMac27caroline",
             "systemUserName": "Caroline Briaud",
             "IPAddress": "192.168.18.18",
             "hostType": "mac",
             "creationDateTime": "2017-09-22T12:46:39Z",
             "state": "postponed",
             "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
           },...
       ],
"processes": [
          {
             "name": "Application process",
             "sessionID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5",
             "number": 4,
             "ID": 4,
             "visible": true,
             "systemID": "123145476132864",
             "type": -18,
             "state": 0,
             "cpuUsage": 0,
             "cpuTime": 0.006769,
             "preemptive": false,
             "session": {   
                      "type": "remote",
                      "userName": "Designer",
                      "machineName": "iMac27caroline",
                      "systemUserName": "Caroline Briaud",
                      "IPAddress": "192.168.18.18",
                      "hostType": "mac",
                      "creationDateTime": "2017-09-22T12:46:39Z",
                      "state": "postponed",
                      "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
                       }
           },...
    ]
}

Vous pouvez sélectionner la liste à retourner en passant une des constantes suivantes du thème "Environnement 4D" dans le paramètre options :

Constante	Type	Valeur	Comment
Process seulement	Entier long	1	Retourne uniquement la liste des process
Sessions seulement	Entier long	2	Retourne uniquement la liste des sessions utilisateurs

Lorsqu'elle est exécutée sur 4D en mode local ou distant, Lire activite process retourne uniquement la liste des process (le paramètre options est inutilisé).

Liste des sessions

La propriété "sessions" contient une collection d'objets décrivant toutes les sessions utilisateur en cours sur le serveur.

Chaque objet session contient les propriétés suivantes :

Nom	Type	Description
type	Texte (enum)	Type de session. Valeurs possibles : "remote", "storedProcedure", "web", "rest"
userName	Texte	Nom d'utilisateur
machineName	Texte	Nom de la machine distante
systemUserName	Texte	Nom de la session système ouverte sur la machine distante
IPAddress	Texte	Adresse IP de la machine distante
hostType	Texte (enum)	Type d'hôte. Valeurs possibles : "windows", "mac", "browser"
creationDateTime	Date ISO 8601	Date et heure de connexion de la machine distante
state	Texte (enum)	Statut de la session. Valeurs possibles : "active", "postponed", "sleeping"
ID	Texte	UUID de la session
persistentID	Text	ID persistant de la session

Liste des process

La propriété "processes" contient une collection d'objets décrivant tous les process en cours sur le serveur.

Chaque objet process contient les propriétés suivantes :

Nom

Type

Description

name

Texte

Nom du process

sessionID

Texte

UUID de la session

number

Entier long

Numéro du process

Entier long

ID unique du process

visible

Booléen

True si visible, False sinon

systemID

Texte

ID du process utilisateur, du process 4D ou du process en attente

type

Entier long

Type de process en exécution. Vous pouvez utiliser les constantes siuvantes du thème "Type du process" :

Constante	Valeur	Comment
Process HTTP Ecriture historique	-58
Process Logger	-57
Process HTTP Listener	-56
Process HTTP Worker pool serveur	-55
Process SQL Listener	-54
Gestionnaire de session SQL Net	-53
Process SQL Worker pool serveur	-52
Process DB4D Listener	-51
Process DB4D Miroir	-50
Process DB4D Cron	-49
Process DB4D Worker pool utilisateur	-48
Process DB4D Garbage collector	-47
Process DB4D Ecriture cache	-46
Process DB4D Index builder	-45
Gestionnaire de session ServerNet	-44
Process ServerNet Listener	-43
Process Worker pool réserve	-42
Process Worker pool utilisé	-41
Autre process interne	-40
Process 4D principal	-39
Process SOAP	-33
Web server spare process	-32
Process gestionnaire de clients	-31
Process compilateur	-29
Process d'activité	-26
Process minuteur interne	-25
Process exécution méthode SQL	-24
Process CSM	-22
Process de restitution	-21
Process du fichier d'historique	-20
Process de sauvegarde	-19
Process 4D Server interne	-18
Process macro éditeur de méthod	-17
Process sur fermeture	-16
Process interface serveur	-15
Process exécuté sur client	-14
Process du serveur Web	-13
Process Web 4D distant	-12
Autre process 4D	-10
Tâche externe	-9
Gestionnaire d’événement	-8
Gestionnaire Apple Event	-7
Gestionnaire du port série	-6
Gestionnaire d’index	-5
Gestionnaire du cache	-4
Process Web sans contexte	-3
Process développement	-2
Process principal	-1
Aucun	0
Process exécuté sur serveur	1
Créé par commande de menu	2
Créé par dialogue d'exécution	3
Autre process utilisateur	4
Process worker	5	Process worker lancé par l’utilisateur

state

Entier long

Statut courant (voir la liste de constantes Statut du process)

cpuUsage

Réel

Pourcentage de temps cpu dévolu à ce process (entre 0 et 1)

cpuTime

Réel

Durée d'exécution (secondes)

preemptive

Booléen

True si mode préemptif, False sinon

session

Objet

Session au sein de laquelle le process est exécuté. Valeur Indéfinie si le paramètre Process seulement est passé.

url

Texte

URL avec chemin et paramètres (le cas échéant) des process web (-3) et SOAP (-33) exécutés sur le serveur web. Non retourné pour les autres types de process.

Exemple

Vous souhaitez obtenir la liste de toutes les sessions utilisateurs :

  //A exécuter sur le serveur

 C_OBJET($o)

 C_ENTIER LONG($i)

 $o:=Lire activite process //Lire informations de process et de sessions

 Boucle($i;0;($o.processes.length)-1) //itération de la collection "processes"

    $processName:=$o.processes[$i].name

    $userName:=Chaine($o.processes[$i].session.userName) // Accès facile à userName

  //utiliser Chaine car l'objet session peut être non défini

 Fin de boucle

Voir aussi

INFORMATIONS PROCESS
WEB Lire infos serveur