Read File

Reads a job from the specified In-Sight flash memory, RAM Disk or SD Card.

Note:

To read a job file stored in the RAMDisk folder, the syntax is: RFRAMDisk/[Filename]. For example, to read the file "Model.job" stored in the vision system's RAMDisk folder, issue the following command: "RFRAMDisk/Model.job".
To read a job file stored in the SD Card folder, the syntax is RFSDCARD/[Filename]. For example, to read the file "Model.job" stored in the vision system's SD Card folder, issue the following command: "RFSDCARD/Model.job".

Read File Inputs

Syntax: RF[Filename]

Parameter	Description
Filename	The name of the job. The command will execute with or without the .JOB 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.
-6	User does not have Full Access to execute the command. For more information, see User Access Settings Dialog.

The lines of job data are:

Name	The first line contains the job name.
Size	The second line contains an integer value for the size (in bytes) of the job.
Data	The actual job data is encoded as ASCII hexadecimal values formatted to 80 characters per line. Each line ends with a terminating character.
CheckSum	The last line contains four ASCII hexadecimal bytes that are a checksum of the job data.

Read File Example

To receive information about the job "Model.job", which is saved on the In-Sight vision system, issue the following command: RFModel.job

After issuing the Read File command, the first line outputted to the telnet window is the status code (1), followed by the job name (Model.job) and size (1900) in bytes, then the job data (in ASCII hexadecimal format). Finally, the four-byte ASCII hexadecimal checksum is displayed on the last line (48A3).

Note: The size reported by the RF command will be 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.