# Read File

Lee una tarea ubicada en la memoria flash de In-Sight que se ha especificado.

## Entradas de Read File

Sintaxis: RF[nombre del archivo]

Parámetro | Descripción
--- | ---
Nombre de archivo | El nombre de la tarea. El comando se ejecuta con y sin la extensión .JOBX.

## Salidas de Read File

Devuelve un código de estado seguido de un terminador de línea seguido, a su vez, de líneas de datos del trabajo.

Los códigos de estado son:

Códigos de estado | Descripción
--- | ---
1 | El comando se ha ejecutado correctamente.
0 | Comando no reconocido.
-1 | Falta el nombre del archivo de la tarea.
-2 | No hay ninguna tarea guardada con el nombre indicado o los datos de la tarea no son válidos, por lo que no se pudo ejecutar el comando.
-3 | Error de lectura.
-6 | El usuario no dispone de acceso total para ejecutar el comando.

Las líneas de datos de la tarea:

Parámetro | Descripción
--- | ---
Nombre | La primera línea contiene el nombre de la tarea.
Tamaño | La segunda línea contiene un valor entero que indica el tamaño (en bytes) del trabajo.
Datos | Los datos reales del trabajo se codifican en forma de valores ASCII hexadecimales formateados a 80 caracteres por línea. Cada línea termina con un carácter de terminación.
Suma de verificación | La última línea contiene cuatro bytes ASCII hexadecimales que representan la suma de verificación de los datos de la tarea.

## Ejemplo con Read File

Para recibir información sobre la tarea "texto.jobx" que se ha guardado en el sistema de visión In-Sight, emita el siguiente comando: RFtexto.jobx

Tras la emisión del comando Read File, la primera línea que se visualiza en la ventana de telnet es el código de estado (1) seguido del nombre de la tarea (texto.jobx) y el tamaño expresado en bytes (22) y, a continuación, los datos de la tarea en formato ASCII hexadecimal. Finalmente, se visualizan en la última línea los cuatro Bytes en ASCII hexadecimal que representan la suma de verificación (A09E).

Nota: Debido a la codificación ASCII hexadecimal de los datos, el tamaño notificado por el comando RF será dos veces mayor que el tamaño real en bytes del archivo .JOB almacenado en el sistema de visión In-Sight.