The Rules heading

The Rules heading is divided into ten sections, called Stanzas. Users may wish to open the DM2IMAGE.SMP file as they read this section.

Note : DevTech has included a text file named REGEX.TXT on the distribution diskettes that provides additional information on using regular expressions. Interested readers are encouraged to review this file.

The [configuration flags] stanza

The [configuration flags] stanza can contain two flags: the REGEX flag and the CASESENSITIVE flag.

The REGEX flag:

The Configuration Image Facility ordinarily interprets any "\" characters in the rules files as escape characters. When the Configuration Image Facility encounters an escape character in the rules file, it will interpret the character immediately following the escape character literally rather than as a special character. For example, if the question mark (?) is used as a 'match any character' symbol, then "\?" tells the Configuration Image Facility to treat the "?" character as a real question mark.

Because OS/2 uses the "\" character as a separator character in file name path specifications, you would have to remember to enter both the escape character and the path separator character, every time you wanted to include a path specification in the rules file. If you forget to include the escape character, the Configuration Image Facility will probably not be able to understand the path specification correctly.

To make the task of entering path specifications into the rules file simpler, you can instruct the Configuration Image Facility to interpret the "\" character as a separator in a file name's path specification only, and not as an escape character.

So that you can still use an escape character if you need to, the Configuration Image Facility will interpret the "\" character as an escape character when the characters in question are within brackets ([ ]).

The REGEX flag can be set to DOSNAME, or left blank:

= DOSNAME

Setting this flag to DOSNAME means you do not need to include the escape character (\) in the path separator in the file names you reference in this file (e.g. C:\OS2\*.INI).

= blank

Leaving this flag blank means you must include the escape character in the file name path statements (e.g. C:\\OS2\\*.INI).

The CASESENSITIVE flag:

The CASESENSITIVE flag can be set to YES or NO:

= YES

Setting this flag to YES will limit the Configuration Image Facility to matching filename patterns exactly (e.g. *.ini only matches epm.ini, not Epm.Ini).

= NO

Setting this flag to NO will allow the Configuration Image Facility to match all filename patterns, regardless of case (e.g. *.ini will match *.INI, *.Ini, etc.) NO is the default setting.

The [include] stanza

The list of files following this stanza heading are the additional files that will be saved each time you save an image of an environment. Each file name in this list must be fully stated, including the entire drive and path specification (e.g. C:\OS2\EPM.INI). If the file has extended attributes, these will also be saved.

The [exclude] stanza

The list of files following this stanza heading will NOT be saved each time you save an image of an environment. As with the include stanza, each file name in this list must be fully stated, including the entire drive and path statement (e.g. C:\OS2\EPM.INI). Use this stanza to exclude files you backup using other methods, such as a large audio clip file under your desktop directory.

The [preserve on restore] stanza

Use this stanza to protect files that you do not want overwritten when you restore your environment, such as your CONFIG.SYS file. If the files are not present, they will be restored.

The [regex include] stanza

Use this stanza to specify the filename patterns to include each time you save an image of an environment (e.g. *.ini).

The [regex exclude] stanza

Use this stanza to specify the filename patterns to exclude each time you save an image of an environment (e.g. *.ini).

The [run before backup] stanza

The Configuration Image Facility will automatically run the list of files following this stanza heading before you save an image of an environment.

The [run after backup] stanza

The Configuration Image Facility will automatically run the list of files following this stanza heading after you save an image of an environment.

The [run before restore] stanza

The Configuration Image Facility will automatically run the list of files following this stanza heading before you restore an image of an environment.

The [run after restore] stanza

The Configuration Image Facility will automatically run the list of files following this stanza heading after you restore an image of an environment.