Operação

O Riversoft® STCP Gemini Rename é um utilitário de linha de comando. Ele não é um serviço: cada execução processa os arquivos e termina. Os exemplos usam o modo banco de dados (-db) e o arquivo de configuração padrão. Todas as opções estão em Referência de comandos.

Processar um arquivo

Informe o roteamento e o arquivo. Com -src, informe também a origem, comparada com o SrcRegEx das regras:

stcpren -db -rules ENTRADA -src PARCEIRO /caixa/IN/NOTAS.TXT

Varrer um diretório

Processa todos os arquivos do diretório que atendem aos filtros:

stcpren -db -rules ENTRADA -scan /caixa/IN

Sem -scan, nenhum diretório é varrido. Com -scan "", é usado o diretório de ScanDir, no roteamento.
Para incluir subdiretórios, use -subdir2. Para filtrar, use -fileregex e -dirregex.
Um arquivo com erro é registrado no log e não interrompe a varredura dos demais.

Execução automática

Acionamento	Como configurar
Riversoft STCP Gemini Server	Associe o roteamento aos eventos da instância no Riversoft Console Portal, como a recepção de arquivos.
Riversoft STCP DirectLink	Use o comando externo do roteamento (`routeExternalCmd` e `routeExternalCmdParams`). Veja Roteamento e distribuição.
Agendamento	Execute a varredura em intervalos, por um agendamento da instância no Riversoft Console Portal ou pelo agendador do sistema operacional.

Para varreduras agendadas em intervalos curtos, use um semáforo para que uma varredura não comece antes do fim da anterior:

stcpren -db -rules ENTRADA -scan /caixa/IN -scansemname ENTRADA -scansemoptions 1

Com -scansemoptions 1, a nova execução termina imediatamente se a anterior ainda estiver em andamento.

Testar um roteamento

Com -test, o Riversoft STCP Gemini Rename mostra a regra que seria aplicada a cada arquivo (mensagem MSG7034), sem processá-lo:

stcpren -db -rules ENTRADA -test /caixa/IN/NOTAS.TXT
stcpren -db -rules ENTRADA -scan /caixa/IN -test

Se nenhuma regra corresponder, a mensagem MSG7003 é registrada.

Exportar um roteamento

Grava em JSON um roteamento cadastrado no banco, para conferência, backup ou uso no modo arquivo local:

stcpren -db -rules ENTRADA -export /tmp

O arquivo é gravado como /tmp/ENTRADA.json. Para escolher o nome, informe o caminho completo do arquivo em -export.

Usar um roteamento em arquivo local

Sem -db, informe em -rules o caminho do arquivo JSON do roteamento:

stcpren -rules /usr/local/stcpren/configs/entrada.json /caixa/IN/NOTAS.TXT

Códigos de saída

Código	Significado
`0`	Execução concluída.
`1`	Falha no processamento do arquivo, na configuração ou no roteamento.
`2`	Uso inválido do comando.
`4`	Falha na inicialização (licença, banco ou log).

Use o código de saída em scripts para decidir os próximos passos. Os detalhes de cada falha ficam no log. Veja Monitoramento e auditoria.

Consultar a versão

stcpren -v

Administração Auditoria