# Read File

Reads a job A job is a user-configured program in In-Sight 3D Spreadsheet consisting of functions and designed for specific applications. You can create and edit jobs using the In-Sight 3D Spreadsheet interface, and load them on a vision system for deployment in a live environment. from the specified In-Sight vision system flash memory.

## Read File Inputs

Syntax: RF<Filename>

Parameter | Description
--- | ---
Filename | The name of the job. The command executes with or without the .JOBX extension.

## Read File Outputs

Returns a status code, followed by a line terminator, followed by lines of job data.

The status codes are:

Status Codes | Description
--- | ---
1 | The command was executed successfully.
0 | Unrecognized command.
-1 | The job filename is missing.
-2 | There is no job saved with the given name or the job data is invalid, therefore the command could not be executed.
-3 | Read failed.
-6 | User does not have Full Access to execute the command.

The lines of job data are:

Parameter | Description
--- | ---
Name | The first line contains the job name.
Size | The second line contains an integer value for the size (in bytes) of the job.
CheckSum | The last line contains four ASCII hexadecimal bytes that are a checksum of the job data. The vision system calculates the checksum from the uppercase ASCII values of the hexadecimal encoded data, and not from the byte values of the file contents. For more information, see Native Mode Checksum.
Data | The actual job data is encoded as ASCII hexadecimal values formatted to 80 characters per line. Each line ends with a sequence of a carriage return and a line feed character.

## Read File Example

To receive information about the job text.jobx, which is saved on the In-Sight vision system, issue the following command: RFtext.jobx

After issuing the Read File command, the first line in the Telnet window output is the status code (1), followed by the job name (text.jobx) and size (22) in bytes, then the job data in ASCII hexadecimal format. Finally, the four-byte ASCII hexadecimal checksum is displayed on the last line (4206).

Note: The size that the RF command reports is twice the number of bytes of the actual .JOB file size stored on the In-Sight vision system, due to the ASCII hexadecimal encoding of the data.