4D Doc Center : PROCESS PROPERTIES

4D v14.3

PROCESS PROPERTIES


PROCESS PROPERTIES ( processo ; procNome ; procEstado ; procTempo {; procVisivel {; unicoID {; origem}}} )

Parâmetro	Tipo	Descrição
processo	Inteiro longo	Número do processo
procNome	cadeia	Nome do processo
procEstado	Inteiro longo	Estado do processo
procTempo	Inteiro longo	Tempo acumulado de execução do processo em ticks
procVisivel	Booleano	Visível (TRUE) ou Oculto (FALSE)
unicoID	Inteiro	Número único do processo
origem	Inteiro longo	Origem do processo

Descrição

O comando PROCESS PROPERTIES devolve a informação sobre o processo cujo número de processo se passa em processo.

Depois da chamada:

procNome devolve o nome do processo. Alguns pontos a ter em conta acerca do nome do processo:
- Se o processo foi iniciado desde a caixa de diálogo Executar um método (com a opção Novo processo selecionada), seu nome é “P_” seguido por um número.
- Se o processo foi iniciado a partir de um comando de menu personalizado cuja propriedade Iniciar um novo processo é selecionada, o nome do processo é “M_” ou “ML_” seguido por um número.
- Se o processo foi iniciado pelo servidor web, seu nomes é "Web Process#" seguido por um UUID.
- Se o processo foi suspendido (e seu “espaço” não foi reutilizado), ainda é devolvido o nome do processo. Para detectar se um processo está suspendido, prove procEstado=-1 (ver a continuação).

procEstado devolve o estado do processo no momento da chamada. Este parâmetro pode devolver um dos valores oferecidos pelas seguintes constantes predefinidas:

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

procTempo devolve o tempo acumulado que o processo há utilizado desde que começou, em ticks (1/60 de segundo) .
procVisivel, se especificado, devolve TRUE se o processo é visível, FALSE se está oculto.
unicoID, se especificado, devolve o número único do processo. Na verdade, cada processo tem um número de processo assim como um número único de processo por seção. Este último permite diferenciar entre dois processos ou sessões de processo. Corresponde ao número de processos que tem sido iniciados durante a sessão da aplicação 4D.

origem, se especificado, devolve um valor que descreve a origem do processo. Este parâmetro pode devolver um dos valores das seguintes constantes predefinidas (no tema "Tipo de processo"):

Constante	Tipo	Valor
Client manager process	Inteiro longo	-31
Monitor process	Inteiro longo	-26
Internal timer process	Inteiro longo	-25
SQL Method execution process	Inteiro longo	-24
MSC process	Inteiro longo	-22
Restore Process	Inteiro longo	-21
Log file process	Inteiro longo	-20
Backup process	Inteiro longo	-19
Internal 4D server process	Inteiro longo	-18
Method editor macro process	Inteiro longo	-17
On exit process	Inteiro longo	-16
Server interface process	Inteiro longo	-15
Execute on client process	Inteiro longo	-14
Web server process	Inteiro longo	-13
Web process on 4D remote	Inteiro longo	-12
_o_Web process with context	Inteiro longo	-11
Other 4D process	Inteiro longo	-10
External task	Inteiro longo	-9
Event manager	Inteiro longo	-8
Apple event manager	Inteiro longo	-7
Serial Port Manager	Inteiro longo	-6
Indexing process	Inteiro longo	-5
Cache manager	Inteiro longo	-4
Web process with no context	Inteiro longo	-3
Design process	Inteiro longo	-2
Main process	Inteiro longo	-1
None	Inteiro longo	0
Execute on server process	Inteiro longo	1
Created from menu command	Inteiro longo	2
Created from execution dialog	Inteiro longo	3
Other user process	Inteiro longo	4

Nota: Os processos internos de 4D devolvem um valor negativo e os processos gerados pelo usuário devolvem um valor positivo.

Se o processo não existe, significa que não passou um número incluído no intervalo de 1 a Count tasks, PROCESS PROPERTIES deixa sem modificar os valores das variáveis passados em parâmetros.

Exemplo 1

O seguinte exemplo devolve o nome, o estado, o tempo tomado nas variáveis vNome, vEstado, e vTempoTransc para o processo atual:

 C_STRING(80;vNom) ` Inicializar as variáveis

 C_INTEGER(vEstado)

 C_INTEGER(vTempoTransc)

 PROCESS PROPERTIES(Current process;vNome;vEstado;vTempoTransc)

Exemplo 2

Ver o exemplo da seção Método banco de dados On Exit.