4D v12.4

PROCESS PROPERTIES

Página Inicial

 
4D v12.4
Manual de linguagem 4D
Processos
PROCESS PROPERTIES

 

PROCESS PROPERTIES 


 

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

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
    Process Server Interface Inteiro longo -15
    Execute on Client Process Inteiro longo -14
    Web server Process Inteiro longo -13
    Web Process on 4D Client Inteiro longo -12
    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
    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.

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)

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

 
PROPRIEDADES 

Produto: 4D
Tema: Processos
Número 336

 
HISTÓRIA 

Modificado: 4D v11 SQL Release 3

 
VER TAMBÉM 

Count tasks
Process state