All references for reference data are stored in the file REFERENCES.
Location: This file must be in a specified folder, currently S:/utility/ (for Windows) or ~/M/utility/ (Linux and Mac). Alternatively, it can be in the directory that the job is being run in.
Structure: Each reference consists of four lines. The first line is the mnemonic. The next one, two, or three lines are the reference. If the reference does not extend to three lines, blank lines must be present, to ensure that the four lines are used.
Mnemonic: This can be up to 8 characters long. To avoid ambiguity, mnemonics should not be less than 7 characters. The mnemonic is composed of upper case letters and numbers, in any order.
Reference: These should be in the form suitable for reading. A good format would be as in a journal reference. Use existing references as a guide.
Adding new references: First, check that the reference does not already exist. Then create a new mnemonic, again make sure it is unique. Put the new reference at the end of the REFERENCES file. That way, if a mistake is made, it will not damage the other references.