Comandos

Referencia de comandos

Sintaxis

stcpren [opciones] <archivo>                         # procesa un archivo
stcpren [opciones] -scan <directorio>                # barre un directorio
stcpren -ini <reglas.ini> -rules <reglas.json>       # convierte reglas INI a JSON
stcpren -db -rules <enrutamiento> -export <destino>  # exporta un enrutamiento de la base

Las opciones van antes del nombre del archivo. Es necesario informar un archivo, la opción -scan, la opción -ini o la opción -export; de lo contrario, el comando muestra la ayuda y termina con el código 2. Con -scan "", el directorio es el informado en ScanDir en el enrutamiento.

Configuración y reglas

Opción	Tipo	Predeterminado	Descripción
`-config`	texto	`/usr/local/stcpren/configs/config.json`	Archivo de configuración.
`-db`	booleana	`false`	Lee el enrutamiento de la base de configuración.
`-rules`	texto	—	Con `-db`, nombre del enrutamiento. Sin `-db`, ruta del archivo JSON del enrutamiento. Con `-ini`, archivo JSON generado.
`-ini`	texto	—	Archivo de reglas en formato INI a convertir a JSON.
`-export`	texto	—	Con `-db`, graba el enrutamiento en JSON. Si el destino es un directorio, el archivo recibe el nombre del enrutamiento con la extensión `.json`.
`-test`	booleana	`false`	Muestra la regla que se aplicaría a cada archivo, sin procesarlo.

Barrido

Opción	Tipo	Predeterminado	Descripción
`-scan`	texto	—	Directorio del barrido. Sustituye `ScanDir`.
`-nosubdir`	booleana	`false`	Solo el directorio informado.
`-subdir`	booleana	`false`	Solo los subdirectorios.
`-subdir2`	booleana	`false`	El directorio y los subdirectorios.
`-dirregex`, `-dirregexneg`	texto	—	Expresiones que incluyen o excluyen directorios.
`-fileregex`, `-fileregexneg`	texto	—	Expresiones que incluyen o excluyen archivos.
`-firstrule`	entero	`0`	Número de la primera regla evaluada.
`-scansemname`	texto	—	Nombre del semáforo del barrido.
`-scansemtimeout`	entero	`-1`	Tiempo máximo de espera por el semáforo, en milisegundos.
`-scansemoptions`	entero	`0`	Opciones del semáforo. `1`: termina si el semáforo está en uso.

Las opciones de barrido sustituyen los valores correspondientes del enrutamiento. Vea Referencia de reglas.

Datos del archivo

Opción	Tipo	Predeterminado	Descripción
`-src`	texto	—	Origen del archivo, comparado con `SrcRegEx`.
`-dst`	texto	—	Destino del archivo, disponible en `$DSTUSER` cuando no se aplica ninguna regla.
`-filekey`	texto	—	Clave del archivo, disponible en `$FILEKEY`.
`-copydir`	texto	—	Directorio de copia. Sustituye `CopyToDir`.
`-backupdir`	texto	—	Directorio de backup. Sustituye `BkpToDir`.
`-var0` a `-var9`	texto	—	Valores de las variables `$VAR0` a `$VAR9` y de los ítems de sustitución por valor fijo. Vea Referencia de variables.

Ejecución y log

Opción	Tipo	Predeterminado	Descripción
`-lang`	texto	`ptb`	Idioma de los mensajes: `ptb` (portugués), `enu` (inglés) o `esp` (español).
`-langfile`	texto	`/usr/local/stcpren/configs/messages.json`	Archivo de mensajes.
`-pid`	texto	—	Archivo de PID. Sustituye `applPidFile`.
`-errfile`	texto	—	Redirige la salida de error (stderr) a un archivo.
`-nologevent`, `-nologroute`	booleana	`false`	Mantenidas por compatibilidad. No tienen efecto en esta versión.
`-v`	booleana	`false`	Muestra la versión y termina.

Códigos de salida

Código	Significado
`0`	Ejecución completada. En el barrido, los errores de archivos individuales se registran en el log y no cambian el código.
`1`	Falla en el procesamiento del archivo, en la lectura de la configuración o del enrutamiento. También es el código de `-v`.
`2`	Uso inválido: falta el archivo o la opción `-scan`, `-ini` o `-export`.
`4`	Falla en el inicio, por ejemplo en la licencia, en la base de configuración o en el log.

Ejemplos

# Procesa un archivo recibido de SOCIO
stcpren -db -rules ENTRADA -src SOCIO /buzon/IN/NOTAS.TXT

# Barre el directorio y los subdirectorios, solo archivos .TXT
stcpren -db -rules ENTRADA -scan /buzon/IN -subdir2 -fileregex '\.TXT$'

# Muestra la regla aplicada a cada archivo, sin procesar
stcpren -db -rules ENTRADA -scan /buzon/IN -test

# Usa un enrutamiento en archivo local
stcpren -rules /usr/local/stcpren/configs/entrada.json /buzon/IN/NOTAS.TXT

# Exporta un enrutamiento de la base
stcpren -db -rules ENTRADA -export /tmp

Archivos Variables