Table of Contents

• Introduction
• File type and version
• Characters section
• Protection section
• Web Users section
• Database Options section

• Save Setup section
• Import Setup section
• Subset section
  • Global subsets
  • Local subsets
• Time Scales section
• Macro section
• Commands section

• Dimension section
  • Dimension Import Setup
• Cards section
• Templates section
  • Cards template
  • Lines template
  • Components template
  • Time Functions template
  • Component Functions template

• Common definitions

Introduction

HAT-text files can be used to move information to and from HAT at a lower level than the ordinary import and export functions. A HAT-text file is a complete HAT document file including dimension charts, analysis templates and other definitions. Importing data to HAT is very handy if the host computer can generate a transfer file directly in HAT-text format. Exporting data can also be made more extensive by using this format.

Compatibility
This format is used by HAT starting from version 5.0. Later HAT versions enhance this format: additions and modifications are documented here. Every HAT-text file must have version information included in its header, see section File type and version. The version information is used to ensure proper interpretation of the file contents.

Format
HAT-text file is a sequential 8-bit ASCII text file. System's native character set is used when HAT saves a text file. Information of special characters is included in the text file making it possible to read the file in other systems without any modification. Lines are terminated by carriage return (ASCII 13) or a line feed (ASCII 10) depending on the native character set. Fields inside a line are separated by tab character (ASCII 9). Tabs at the end of lines can be ignored.

Section order
The section order in the file is significant; for example dimension charts must be defined before cards. The section order in the file is the same as in this document.

Special Characters
The character # (ASCII 35, hex 23) has a special meaning: all section headers begin with two such characters. No other line is allowed to begin so.

Text examples do not explicitly show line terminators or field separators; columns and rows show where they should be inserted.