PROCESS PROPERTIES

4D v16.3

PROCESS PROPERTIES


PROCESS PROPERTIES ( proceso ; procNom ; procEstado ; procTiempo {; procVisible {; unicoID {; origen}}} )

Parámetro	Tipo	Descripción
proceso	Entero largo	Número del proceso
procNom	Cadena	Nombre del proceso
procEstado	Entero largo	Estado del proceso
procTiempo	Entero largo	Tiempo acumulado de ejecución del proceso en tics
procVisible	Booleano, Entero largo	Visible (TRUE) u Oculto (FALSE)
unicoID	Entero largo	Número único del proceso
origen	Entero largo	Origen del proceso

Descripción

El comando PROCESS PROPERTIES devuelve diferente información sobre el proceso cuyo número de proceso se pasa en proceso.

Después de la llamada:

procNom devuelve el nombre del proceso. Algunos puntos a tener en cuenta acerca del nombre del proceso:

Si el proceso fue iniciado desde la caja de diálogo Ejecutar un método (con la opción Nuevo proceso seleccionada), su nombre es “P_” seguido por un número.
Si el proceso fue iniciado a partir de un comando de menú personalizado cuya propiedad Iniciar un nuevo proceso es seleccionada, el nombre del proceso es “M_” o “ML_” seguido por un número.
Si el proceso fue iniciado por el servidor web, su nombres es "Web Process#" seguido por un UUID.
Si el proceso ha sido suspendido (y su “espacio” no ha sido reutilizado), aún se devuelve el nombre del proceso. Para detectar si un proceso esta suspendido, pruebe procEstado=-1 (ver a continuación).

procEstado devuelve el estado del proceso en el momento de la llamada. Este parámetro puede devolver uno de los valores ofrecidos por las siguientes constantes predefinidas:

Constante	Tipo	Valor
Does not exist	Entero largo	-100
Aborted	Entero largo	-1
Executing	Entero largo	0
Delayed	Entero largo	1
Waiting for user event	Entero largo	2
Waiting for input output	Entero largo	3
Waiting for internal flag	Entero largo	4
Paused	Entero largo	5
Hidden modal dialog	Entero largo	6

procTiempo devuelve el tiempo acumulado que el proceso ha utilizado desde que comenzó, en tics (1/60 de segundo).
El parámetro opcional procModo puede ser una variable de tipo booleano o entero largo:
- Si es de tipo Booleano, devuelve True si el proceso es visible y False si está oculto.
- Si es de tipo entero largo, después de la ejecución del método, contiene un campo de bits donde los dos primeros bits son definidos:
  - bit 0 devuelve la propiedad de visibilidad: 1 si el proceso es visible y 0 si está oculto
  - bit 1 devuelve la propiedad de modo apropiativo: 1 si el proceso se ejecuta en modo apropiativo y 0 si se ejecuta en modo cooperativo.
    Nota: esta propiedad sólo es útil en aplicaciones de 64 bits, donde los procesos pueden ejecutarse en modo apropiativo o cooperativo. Para mayor información, consulte la sección Procesos 4D apropiativos.
unicoID, si se especifica, devuelve el número único del proceso. De hecho, cada proceso tiene un número de proceso así como un número único de proceso por sesión. Éste último permite diferenciar entre dos procesos o sesiones de proceso. Corresponde al número de procesos que han sido iniciados durante la sesión de la aplicación 4D.
origen, si se especifica, devuelve un valor que describe el origen del proceso. Este parámetro puede devolver uno de los valores de las siguientes constantes predefinidas (en el tema "Tipo de proceso"):
[#table_kst them="4727" remove="861928,3423082,3423089,3423075,3423068,3423061,3423054,3423047,3423039,3423025,3423018,3423010,3423003,3422996,3422989,3422982,3422973,3422966,3423032"/]

Nota: los procesos internos de 4D devuelven un valor negativo y los procesos generados por el usuario devuelven un valor positivo.

Si el proceso no existe, significa que no pasó un número incluido en el intervalo de 1 a Count tasks, PROCESS PROPERTIES deja sin modificar los valores de las variables pasados en parámetros.

Ejemplo 1

El siguiente ejemplo devuelve el nombre, el estado, el tiempo tomado en las variables vNom, vEstado, y vTiempoTransc para el proceso actual:

 C_TEXT(vNom) ` Inicializar las variables

 C_LONGINT(vEstado)

 C_LONGINT(vTiempoTransc)

 PROCESS PROPERTIES(Current process;vNom;vEstado;vTiempoTransc)

Ejemplo 2

Ver el ejemplo de la sección Método de base On Exit Database.

Ejemplo 3

Usted quiere conocer la visibilidad y el modo de ejecución del proceso actual. Puede escribir:

 C_TEXT(vName)

 C_LONGINT(vState)

 C_LONGINT(vTime)

 C_LONGINT(vFlags)

 C_BOOLEAN(isVisible)

 C_BOOLEAN(isPreemptive)

 PROCESS PROPERTIES(Current process;vName;vState;vTime;vFlags)

 isVisible:=vFlags?? 0 //true si visible

 isPreemptive:=vFlags?? 1 //true si apropiativo

Ver también

Count tasks
Procesos 4D apropiativos
Process state