CLEARPROFILE
element specifies profile (INI) data
which should be deleted on de-installation of a package.
This can only be specified in a
PCK
block and defines that if
the package in which the CLEARPROFILE element appears is
later de-installed, the specified profile data should be deleted.
This element is optional, but can appear more than once per PCK
block.
If several CLEARPROFILE
elements appear, they are processed in the
order in which they are specified.
Note that this element is only for de-installation.
If you wish to write string data into a profile, use
WRITEPROFILE
.
We strongly recommend specifying this attribute if your application stores
additional data in the system profiles (other than that added by the
WRITEPROFILE
element).
For example, if your application writes
its settings to the user profile (usually OS2.INI
), this should
be cleaned up upon de-installation.
Syntax:
<CLEARPROFILE PROFILE="profile" [APPLICATION="app" [KEY="key"] ] />This is an empty element and must therefore be terminated with a
"/"
character.
Attributes:
PROFILE="profile"
"USER"
or "SYSTEM"
for the user or system profiles (usually OS2.INI
and
OS2SYS.INI
) or an explicit full path specification of an INI file.
This supports macro resolution.
APPLICATION="app"
profile
.
If this is not specified, the whole profile is deleted.
(This is prevented for the user and system profiles, of course.)
KEY="key"
app
of profile
.
If this is specified, app
must be specified as well.
If this is not specified, the whole application (or, if app
is not specified either, the entire profile) is deleted.
Example: This will delete the "SuperWord" application in the user
profile (usually OS2.INI
) on de-installation, including all keys
which might be present in there.
<CLEARPROFILE PROFILE="USER" APPLICATION="SuperWord" />