Refreader will only work after a particular "reference file" has been created by a GAMS run. The file is generated by adding the rf option to the command line call of GAMS. The general form of this is to either run
GAMS mymdel rf=filename.ref
or enter a command in the command line box of the IDE as follows
The run of GAMS with the rf option places the name of the ref file in blue in the GAMS log file and double clicking on that line causes the refreader program to run and create its output. Several notes about the run
| • | The rf= command specifies the name of the file refreader will use. Generally refreader expects it to have the extension .ref. Typically we use list.ref. |
| • | The rf file should be cleared out before the program is run as the rf command appends and does not overwrite. |
| • | The rf file only covers the program components in a run and does not include any information from restart files. In general it is best to explicitly use all the files in one program without use of save and restart. |
| • | It is often useful to just generate the reference file without any execution on behalf of the GAMS program. This is done by including the a=c option on the command line or in the command parameter IDE box. |
Once the file has been run with the rf option the logfile is augmented with the blue line identifying the ref file name as below
Double clicking on this opens the refreader window as discussed above.