Solución de problemas

Cómo investigar

Verifique el código de salida del comando. Vea Códigos de salida.
Localice los mensajes de la ejecución en el Riversoft® Console Portal (modo base de datos) o en el log en texto de applLogDir (modo archivo local).
Busque el código del mensaje (MSGnnnn) en Códigos de mensaje.
Repita la ejecución con -test para ver qué regla se aplica al archivo.
Si necesita más detalles, aumente temporalmente applDebug y grabe la salida con -errfile. Vea Nivel de detalle.

Inicio

Síntoma	Causa probable	Qué hacer
El comando muestra la ayuda y termina con el código `2`.	No se informó el archivo ni la opción `-scan`, `-ini` o `-export`.	Informe el archivo después de las opciones o use `-scan`. Vea Sintaxis.
Código `4` y `MSG7942`.	Licencia inválida o vencida, número de serie distinto, base de configuración o base de log inaccesible.	Verifique el archivo de `License`, la instancia y la conexión con las bases.
Error al leer el `config.json`.	Archivo ausente, JSON inválido o ruta de `-config` incorrecta.	Valide el archivo con `python3 -m json.tool config.json`.
No se aceptan las contraseñas de la instancia.	`applConfigPassPhrase` distinta de la usada por los demás productos.	Use la misma clave. Vea Clave de cifrado de las contraseñas.
No se encuentra la instancia.	`cfgInstanceName` distinto del nombre de la instancia.	Ajuste `cfgInstanceName`.

Reglas

Síntoma	Causa probable	Qué hacer
`MSG7003`: ninguna regla para el archivo.	Ninguna regla corresponde al nombre, al directorio o al origen del archivo.	Revise `FileRegEx`, `DirRegEx` y `SrcRegEx`. Verifique que se informó `-src` cuando la regla usa `SrcRegEx`.
Una regla correcta nunca se aplica.	Una regla anterior, más genérica, corresponde primero; la regla está bloqueada (`Locked`); o hay un hueco en el `Index`.	Reordene las reglas, desbloquee la regla y mantenga los números sin huecos.
No se encuentra el enrutamiento.	Nombre en `-rules` distinto del registrado, o falta `-db`.	Verifique el nombre en el Portal. Para enrutamientos en archivo, informe la ruta del JSON sin `-db`.
`MSG7027`: expresión regular inválida.	Error de sintaxis en la expresión, como una barra invertida sin escape en el JSON.	En el JSON, escriba `\\.` para representar `\.`.
`MSG7032`: fuera del período.	El archivo llegó fuera del horario o del día permitido.	Revise los campos `StartDate...`, `EndDate...` y `WeekDayInterval`.
`MSG7021`: antigüedad mínima no alcanzada.	El archivo es más nuevo que `ProcessAfterSeconds`.	Espere la próxima ejecución o reduzca el valor, que se interpreta en milisegundos.
`MSG7033`: tamaño inválido.	El archivo está fuera de `FileLenMin` y `FileLenMax`.	Revise los límites y `FileLenOption`.
El archivo no se copia y no se registra ninguna falla.	`CopyFileOption` no incluye la opción `1`.	Sume `1` a las opciones de la copia.

Copia, backup y comandos

Síntoma	Causa probable	Qué hacer
`MSG7007` con “file exist”.	El archivo de destino ya existe.	Sume la opción `16` para sobrescribir o incluya fecha y hora o un número secuencial en el nombre.
`MSG7007` o `MSG7019` con “no such file or directory”.	El directorio de destino o de backup no existe.	Sume la opción `4` para crear el directorio.
`MSG7007` o `MSG7019` con “permission denied”.	El usuario de ejecución no tiene permiso en el directorio.	Ajuste los permisos. Vea Usuario de ejecución.
`MSG7011` o `MSG7012`.	El comando externo no existe, no tiene permiso de ejecución o terminó con un código distinto de `0`.	Use la ruta absoluta, pruebe el comando con el usuario de ejecución y verifique el código de salida.
El comando externo recibe el texto de la variable, por ejemplo `$ERROR`.	La variable no tiene valor en esta ejecución o no se sustituye.	Consulte la Referencia de variables.
`MSG7022`: archivo de control no encontrado.	La regla exige un archivo de control (opción `2`) que no existe.	Verifique el nombre en `CheckLockUnlockFileName` y el proceso que debería crearlo.
`MSG7023`: falla al crear el archivo de control.	El archivo ya existe, de una ejecución anterior interrumpida.	Verifique que no haya otra ejecución en curso y elimine el archivo de control antiguo.

Barrido

Síntoma	Causa probable	Qué hacer
No se procesa ningún archivo.	Faltó `-scan`, los filtros del barrido excluyen los archivos o los archivos están en subdirectorios.	Verifique `-scan`, `ScanFileRegEx`, `ScanDirRegEx` y use `-subdir2` para incluir subdirectorios.
El barrido termina sin procesar, con otro en curso.	El semáforo (`ScanLockSem`) está en uso y la opción `1` termina la nueva ejecución.	Comportamiento esperado. Ajuste el intervalo del agendamiento si las ejecuciones se superponen con frecuencia.

Soporte

Si el problema continúa, contacte al Soporte con la versión (stcpren -v), el comando ejecutado, el código de salida, los mensajes registrados y el enrutamiento exportado con -export.

Auditoría Notas de la versión