Filtrando pelo campo TSK_STATUS

Tela de computador exibindo códigos de uma linguagem de programação

💻📝🤖
...
Registrando um memorando rápido (para os Totvers que trabalham com Protheus) e querem (ou precisam) fazer alguma consulta rápida de alguma rotina rodando via Schedule (ou quem sabe até desenvolver algum relatório).

Mas é claro que o motivo da sua visita aqui pode não ser técnica e nem ter nada a ver com assuntos técnicos que envolvam esse ERP chamado Protheus. Se for este o caso, eu recomendo outros posts meus, como o da vez em que resolvi filosofar com o Chat GPT (o que rendeu algumas conversas bem malucas sobre inteligência aritificila e o significado do que é ser um "ser vivo") ou até mesmo o post em que discorro um pouco sobre o Halloween (é o meu feriado favorito, ainda que ele não me permita ficar em casa).

Mas se você precisa mesmo fazer uns filtros no Protheus para consultar os agendamentos das rotinas Scheduladas, então o post é esse mesmo.

As rotinas programas e agendadas para rodar "automaticamente" no ERP Protheus gravam uma tabela de agendamento (tabela SCHDTSK), em que há um campo indicando o Status das várias rotinas agendadas. Esses Status também pode ser consultado na tela da rotina de monitoramento (chamado Monitor; quem diria), disponível no módulo Configurador (SIGACFG)... Mas isso é outra história... (afinal, essa dica é para quem já está familiarizado com o assunto).

Um robô braco azulado
Para quem é da área de Tecnologia (o famoso T.I.) e trabalha com Protheus e precisa consultar o "status" de uma rotina que "roda" via Schedule, uma forma rápida de fazer essa consulta sem precisar abrir o configurador e ir na rotina de monitoramento propriamente dita, é abrir a tabela SCHDTSK via MPSDU (APSDU para alguns) e filtrar a rotina desejada (pelo campo TSK_STATUS).

Eu já procurei no Google uma lista com o valor de cada status (disponível na legenda da rotina), mas não encontrei. Esse valor é um número (sei disso por ter visto o conteúdo gravado no campo TSK_STATUS), mas queria ter certeza de qual número corresponde a qual "status".

Como não achei, fiz algumas análises com as rotinas que conheço e comparei os Status usando a legenda na própria tela de monitoramente no Configurador e, por incrível que pareça (afinal, nem sempre as coisas precisam ser difíceis) as legendas estão em ordem crescente, de modo que o primeiro "status" corresponde ao número zero e o último ao número mais alto (no caso, o número 5).

Eis as opções de filtro:

0 = "Aguardando execução"
1 = "Em execução"
2 = "Finalizada"
3 = "Falhou"
4 = "Permanente"
5 = "Descartada"

Imagem do passo a passo


Bom, esse memorando é sobre isso. Mas eu tenho outros memorandos sobre uma porção de outros assuntos e, se acaso você se interessar por conhecimentos gerais, te convido a conhecer esses textos.