WRITEPROFILE element specifies profile (INI) data
which should be added to a profile when a package is installed.
This can only be specified in a
PCK block and defines that if
the package in which the WRITEPROFILE element appears is
selected for installation, the specified data should be added to the profile.
This element is optional, but can appear more than once per PCK block.
If several WRITEPROFILE elements appear, they are processed in the
order in which they are specified.
The data is automatically removed again on de-installation of the profile.
As a result, you do not have to specify a separate
CLEARPROFILE element
for the data added with WRITEPROFILE. In other words,
WRITEPROFILE includes CLEARPROFILE.
Syntax:
<WRITEPROFILE
PROFILE="profile"
APPLICATION="app"
KEY="key"
DATA="string"
/>
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.
KEY="key"
app to add data to in
profile.
DATA="string"
WarpIN does not support writing binary data to profiles, but strings only. If you
need binary data, your application must do this by itself, or specify a program using
the EXECUTE attribute which does this on install.
WarpIN will always add a terminating null byte to the string.
This supports macro resolution.
Example: This will store the path where package 1 was written to
in an entry in the user profile (usually OS2.INI).
<WRITEPROFILE
PROFILE="USER"
APPLICATION="SuperWord"
KEY="InstallPath"
DATA="$(1)"
/>