Solução de problemas

Como investigar

Confira o código de saída do comando. Veja Códigos de saída.
Localize as mensagens da execução no Riversoft® Console Portal (modo banco de dados) ou no log em texto de applLogDir (modo arquivo local).
Procure o código da mensagem (MSGnnnn) em Códigos de mensagem.
Repita a execução com -test para ver qual regra é aplicada ao arquivo.
Se precisar de mais detalhes, aumente temporariamente applDebug e grave a saída com -errfile. Veja Nível de detalhe.

Inicialização

Sintoma	Causa provável	O que fazer
O comando exibe a ajuda e termina com o código `2`.	Não foi informado o arquivo nem a opção `-scan`, `-ini` ou `-export`.	Informe o arquivo depois das opções ou use `-scan`. Veja Sintaxe.
Código `4` e `MSG7942`.	Licença inválida ou vencida, número de série divergente, banco de configuração ou banco de log inacessível.	Confira o arquivo de `License`, a instância e a conexão com os bancos.
Erro ao ler o `config.json`.	Arquivo ausente, JSON inválido ou caminho de `-config` incorreto.	Valide o arquivo com `python3 -m json.tool config.json`.
Senhas da instância não são aceitas.	`applConfigPassPhrase` diferente da usada pelos demais produtos.	Use a mesma chave. Veja Chave de criptografia das senhas.
A instância não é encontrada.	`cfgInstanceName` diferente do nome da instância.	Ajuste `cfgInstanceName`.

Regras

Sintoma	Causa provável	O que fazer
`MSG7003`: nenhuma regra para o arquivo.	Nenhuma regra corresponde ao nome, ao diretório ou à origem do arquivo.	Revise `FileRegEx`, `DirRegEx` e `SrcRegEx`. Confira se `-src` foi informado quando a regra usa `SrcRegEx`.
Uma regra correta nunca é aplicada.	Uma regra anterior, mais genérica, corresponde primeiro; a regra está bloqueada (`Locked`); ou há uma lacuna no `Index`.	Reordene as regras, desbloqueie a regra e mantenha os números sem lacunas.
O roteamento não é encontrado.	Nome em `-rules` diferente do cadastrado, ou falta `-db`.	Confira o nome no Portal. Para roteamentos em arquivo, informe o caminho do JSON sem `-db`.
`MSG7027`: expressão regular inválida.	Erro de sintaxe na expressão, como uma barra invertida sem escape no JSON.	No JSON, escreva `\\.` para representar `\.`.
`MSG7032`: fora do período.	O arquivo chegou fora do horário ou do dia permitido.	Revise os campos `StartDate...`, `EndDate...` e `WeekDayInterval`.
`MSG7021`: idade mínima não atingida.	O arquivo é mais novo do que `ProcessAfterSeconds`.	Aguarde a próxima execução ou reduza o valor, que é interpretado em milissegundos.
`MSG7033`: tamanho inválido.	O arquivo está fora de `FileLenMin` e `FileLenMax`.	Revise os limites e `FileLenOption`.
O arquivo não é copiado e nenhuma falha é registrada.	`CopyFileOption` não inclui a opção `1`.	Some `1` às opções da cópia.

Cópia, backup e comandos

Sintoma	Causa provável	O que fazer
`MSG7007` com “file exist”.	O arquivo de destino já existe.	Some a opção `16` para sobrescrever ou inclua data e hora ou número sequencial no nome.
`MSG7007` ou `MSG7019` com “no such file or directory”.	O diretório de destino ou de backup não existe.	Some a opção `4` para criar o diretório.
`MSG7007` ou `MSG7019` com “permission denied”.	O usuário de execução não tem permissão no diretório.	Ajuste as permissões. Veja Usuário de execução.
`MSG7011` ou `MSG7012`.	O comando externo não existe, não tem permissão de execução ou terminou com código diferente de `0`.	Use o caminho absoluto, teste o comando com o usuário de execução e confira o código de saída.
O comando externo recebe o texto da variável, por exemplo `$ERROR`.	A variável não tem valor nesta execução ou não é substituída.	Confira a Referência de variáveis.
`MSG7022`: arquivo de controle não encontrado.	A regra exige um arquivo de controle (opção `2`) que não existe.	Confira o nome em `CheckLockUnlockFileName` e o processo que deveria criá-lo.
`MSG7023`: falha ao criar o arquivo de controle.	O arquivo já existe, de uma execução anterior interrompida.	Confira se não há outra execução em andamento e remova o arquivo de controle antigo.

Varredura

Sintoma	Causa provável	O que fazer
Nenhum arquivo é processado.	Faltou `-scan`, os filtros de varredura excluem os arquivos ou os arquivos estão em subdiretórios.	Confira `-scan`, `ScanFileRegEx`, `ScanDirRegEx` e use `-subdir2` para incluir subdiretórios.
A varredura termina sem processar, com outra em andamento.	O semáforo (`ScanLockSem`) está em uso e a opção `1` encerra a nova execução.	Comportamento esperado. Ajuste o intervalo do agendamento se as execuções se sobrepõem com frequência.

Suporte

Se o problema continuar, acione o Suporte com a versão (stcpren -v), o comando executado, o código de saída, as mensagens registradas e o roteamento exportado com -export.

Auditoria Notas de versão