General 9610 Restore Processing

Characters are assumed to be coded in UTF-16 LE (little-endian, with Byte Order Mark (BOM) for LE (0xFFFE)), with each item on a separate line terminated by” <CR><LF>” (000D 000A in UTF-16) characters.

Important: If the file is not in this format, the telephone displays the message "Restore failed.".

The generic format for data values is: name=value.

The format for retrieving a Main Menu entry is:

MMLBLxx =entry label
MMTYPExx =entry type
MMDATAxx =entry data

For more information, see Main Menu (MM) Administration.

The format for retrieving a Contacts entry is:

CONLABELxxx = entry label
CONDATAxxx = entry data

For more information, see Contacts Application Administration.

The other parameters that have meaning in a 9610 backup file are:

IDLEAPP- as described in The 9610 Idle Application, WMLIDLETIME, SCREENSAVERON, IDLEAPP, and WMLSMALL.

LISTAPP - when LISTAPP is null (the default), the assumption is the administrator has not created an external equivalent to the local Contacts application. The local Contacts application is used unless it too is empty. When the local Contacts application is empty, selecting List is the same as pressing the Start button. When LISTAPP is non-null, the assumption is the administrator has populated it with a URI for a WML-based application to be displayed when List is selected.

When retrieving data, the following applies:

• If the Byte Order Mark (BOM) is not 0xFFFE, the entire file is rejected and the retrieval fails.
• All identifiers, for example, names, are interpreted in a case-insensitive manner.
• The case of parameter values and Contacts names and numbers are preserved.
• Spaces preceding, within, or following a name or value are treated as part of that entity.
• <CR> and <LF> are interpreted as line termination characters.
• Blank lines are ignored.
• If an identifier is not recognized or is invalid, the entire line is ignored.
• If an identifier is valid but the data itself is invalid or incomplete, the line is ignored.
  The determination of what constitutes a valid value for each data element is specified in General 9610 Restore Processing and Backup File Format.
• If more than one line contains a value for a parameter or Contacts entry, the last value read is used (hence, new values overwrite previous values as lines are read from the file). In all other cases, the order of the lines in the file does not matter.

The success of the retrieval process requires the telephone to obtain the backup file, and to successfully store valid data. The existence of invalid data does not constitute a failed retrieval.