Get process activity

4D v20.6


Get process activity {( opciones )} -> Resultado

Parámetro	Tipo	Descripción
opciones	Entero largo	Opciones a devolver
Resultado	Objeto	Instantánea de los procesos en ejecución y/o (4D Server únicamente) de las sesiones de usuario

Descripción

El comando Get process activity devuelve una instantánea de las sesiones de los usuarios conectados y/o de los procesos relacionados que se ejecutan en un momento dado. Este comando devuelve todos los procesos, incluyendo los procesos internos que no eran accesibles por el comando PROCESS PROPERTIES.

Cuando se ejecuta en el servidor, por defecto si omite el parámetro opciones, Get process activity devuelve las listas de sesiones usuario y de los procesos, como se muestra a continuación:

{
"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"
                       }
           },...
    ]
}

Se puede seleccionar la lista a devolver al pasar una de las siguientes constantes del tema "Entorno 4D" en el parámetro opciones:

Constante	Tipo	Valor	Comentario
Processes only	Entero largo	1	Devuelve sólo la lista de procesos
Sessions only	Entero largo	2	Devuelve sólo la lista de sesión de usuario

Cuando se ejecuta en 4D en modo remoto o local, Get process activity sólo devuelve la lista de procesos (el parámetro opciones es inútil).

Sesiones

La propiedad "sessions" contiene una colección de objetos que describen todas las sesiones usuario en ejecución en el servidor, por ejemplo:

{
    "sessions": [
        {
            "type": "remote",
            "hostType": "mac",
            "userName": "Designer",
            "machineName": "YANNICK-CORE-I7",
            "systemUserName": "Yannick",
            "IPAddress": "fe80::c189:5ea1:c635:90e6",
            "creationDateTime": "2017-04-24T17:13:15Z",
            "state": "postponed",
            "ID": "63DCD177059C60459F2AD278EAD84B4B" 
        },
        ...
    ],...
}

Cada objeto sesión contiene las propiedades siguientes (cuando no están disponibles, las propiedades no se devuelven):

Nombre de la propiedad	Tipo	Descripción
type	Texto (enum)	Tipo de sesión. Valores posibles: "remote", "storedProcedure", "web", "rest"
hostType	Texto (enum)	Tipo de host. Valores posibles: "windows", "mac", "browser"
userName	Texto	Nombre de usuario
machineName	Texto	Nombre de la máquina remota
systemUserName	Texto	Nombre de la sesión del sistema abierta en la máquina remota
IPAddress	Texto	Dirección IP de la máquina remota
hostType	Texto (enum)	Tipo local. Valores posibles: "windows", "mac", "browser"
creationDateTime	Date ISO 8601	Fecha y hora de la conexión del equipo remoto
state	Texto (enum)	Estado de las sesión. Valores posibles: "active", "postponed", "sleeping"
ID	Texto	UUID de la sesión
persistentID	Texto	ID persistente de la sesión

Proceso

La propiedad "proceso" contiene una colección de objetos que describen todos los procesos en ejecución en el servidor.

Cada objeto de proceso contiene las siguientes propiedades:

Nombre de la propiedad

Tipo

Descripción

name

Texto

Nombre del proceso

sessionID

Texto

UUID de la sesión

number

Entero largo

Número del proceso

Entero largo

Identificador único del proceso

visible

Booleano

True si es visible, de lo contrario false

systemID

Texto

ID para el proceso usuario, proceso 4D o proceso de repuesto

type

Entero largo

Tipo de proceso en ejecución. Puede utilizar las siguientes constantes del tema "Tipo de proceso":

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

state

Entero largo

Estado actual (ver la lista de constantes Estado del proceso)

cpuTime

Real

Tiempo de ejecución (segundos)

cpuUsage

Real

Porcentaje de tiempo dedicado a este proceso (entre 0 y 1)

preemptive

Booleano

si ejecuta apropiativo,de lo contrario false

session

Objeto

La sesión específica en la que se está ejecutando el proceso. No definido si se pasa el parámetro Processes only.

url

Texto

URL con ruta y parámetros (si los hay) de los procesos web (-3) y SOAP (-33) que se ejecutan en el servidor web. No devuelto para otros tipos de procesos.

Ejemplo

Usted quiere obtener la colección de todas las sesiones de usuario:

  //A ser ejecutado en el servidor

 

 C_OBJECT($o)

 C_LONGINT($i)

 

 $o:=Get process activity //Obtenga información sobre el proceso y la sesión

 For($i;0;($o.processes.length)-1) //Iterar sobre la colección "procesos"

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

    $userName:=String($o.processes[$i].session.userName) // Acceso fácil a userName

  //utilizar String porque el objeto de la sesión podría estar indefinido

 End for

Ver también

PROCESS PROPERTIES
WEB Get server info