Get process activity

4D v17.4


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).

Lista de 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
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

Process list

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

{
    "processes": [
        {
            "state": 0,
            "cpuTime": 12.755332415303,
            "preemptive": true
        },
        {
            "name": "processOnServer",
            "sessionID": "BB8A0C8420FE5741B59F3B13F40A3063",
            "number": 6,
            "ID": 6,
            "visible": true,
            "type": 1,
            "state": 0,
            "cpuTime": 0.40872755886655,
            "preemptive": false
        },
        {
            "name": "ServerNet select I/O handler",
            "state": 0,
            "cpuTime": 0.015625,
            "preemptive": true
        },...
    ]
}

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

Nombre

Tipo

Descripción

name

Texto

Nombre del proceso

sessionID

Texto

UUID de la sesión

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
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

visible

Booleano

True si es visible, de lo contrario false

Entero largo

Identificador único del proceso

number

Entero largo

Número del proceso

Ejemplo

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

  //A ser ejecutado en el servidor

 C_OBJECT($result)

 C_COLLECTION($userCol)

 $result:=Get process activity(Sessions only)

 $userCol:=OB Get($result;"users")

Ver también

PROCESS PROPERTIES
WEB Get server info