FILE SYSTEMS
Environment/Configuration Variables
16 M
X
800 SERIES PROGRAMMERS GUIDE
By default, all configuration files will have two sections, perm and reg. The perm
section is special in that entries under perm will not be deleted on a full download.
All other section entries will be deleted on a full download. To aid compatibility with
previous terminals, all keys that begin with “*” will automatically be placed in the
“perm” section provided the section parameter is a pointer to an empty null
terminated string. (i.e. empty quotes “”). The leading “*” character is not
actually stored in this case. It only indicates that the label field should be stored in
or retrieved from the perm section. If a section is specified then the value field is
stored as it is given to the function, including any ‘*’ character. This also applies
even if the section is specified to be the perm section. It is only if an empty, null-
terminated string is specified for the section is any leading “*” character ignored.
All created sections, and label entries will be converted to lower case before being
stored to eliminate case sensitivity. The getEnvFile() and putEnvFile()
functions will always convert to lower case before searching or storing.
The value part of the environment variable is case-sensitive and will always be
stored as it is passed to the functions. There are certain reserved characters with
the INI parser library that cannot be used in section, label or value fields and there
are certain characters that are not accepted. All other characters can be used
including non-printable ASCII characters. Please refer to the INI parser html
document included in the SDK for basic explanation of how the INI parser works
and what is supported. In addition to that documentation, the following characters
are reserved and cannot be used within one or more of the fields of the
environment variable or have special rules concerning them:
Table 4
Character Hex Decimal Usage
Null 0x00 0 Used to terminate string and cannot be
stored as part of section, label or value
field.
Space 0x20 32 Cannot be used in leading and trailing
position of section, label or value field.
Can only be used in non-leading and
trailing positions.
Equal (=) 0x3D 61 This is a reserved character and cannot
be used in any field. If used, unexpected
and unsupported results may occur.
Horizontal Tab 0x09 9 Cannot be used in leading and trailing
position of section, label or value field.
Can only be used in non-leading and
trailing positions.
Line Feed 0x0A 10 This is a reserved character and cannot
be used in any field. If used, unexpected
and unsupported results may occur.
Vertical Tab 0x0B 11 Cannot be used in leading and trailing
position of section, label or value field.
Can only be used in non-leading and
trailing positions.
To Next Page
Loading...
