A 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"
Required. The profile (INI) file to work on. This can be "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"
Optional. The application to be cleaned up in profile. If this is not specified, the whole profile is deleted. (This is prevented for the user and system profiles, of course.)
KEY="key"
Optional. The key to be deleted in 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"
/>