Example: Information section of setup.ini

Descriptions of the global information fields needed in the setup.ini file

The first section of the Setup file (Plug-in Info) contains global information about the plug-in:

[Plugin Info]
Name=Sample plug-in
NameDLL=sampmri.dll
NameResID=128
Description=Sample plug-in description
DescriptionDLL=sampmri.dll
DescriptionResID=129
Version=0
VendorID=IBM.Sample
JavaPlugin=YES
Field in [Plugin Info] section of Setup.ini Description of field
Name English name of the plug-in. This name is displayed during installation of the plug-in when the translated name cannot be determined.
NameDLL Name of the resource DLL that contains the translated name of the plug-in. This DLL is located in the MRI directories of the plug-in.
NameResID Resource ID of the translated name in the MRI DLL. This field must contain the same value as the NameID field defined in the primary registry key for the plug-in.
Description English description of the plug-in. This description is displayed during installation of the plug-in when the translated description cannot be determined.
DescriptionDLL Name of the resource DLL that contains the translated description of the plug-in. This DLL is located in the MRI directories of the plug-in.
DescriptionResID Resource ID of the translated description in the MRI DLL. This field must contain the same value as the DescriptionID field that is defined in the primary registry key for the plug-in.
Version

A numeric value that indicates the release level of the plug-in. The Check Service Level program uses this value to determine whether the plug-in needs to be upgraded on the client workstation. This value is incremented by some amount for each new release of the plug-in.

The Version value is compared to the current Version value of the installed plug-in that is on the client workstation. When this Version value is greater than the one already existing on the client workstation, the Check Service Level program upgrades the plug-in to the new Version.

VendorID The <VENDOR>.<COMPONENT> string that is used to identify the plug-in. This string is used to create the registry key for the plug-in in the iSeries™ Access for Windows® registry tree. The VendorID must be identical to the <VENDOR>.<COMPONENT> portion of the path where the plug-in will be installed on the iSeries server.
JavaPlugin JavaPlugin is used to indicate whether this is a Java™ plug-in. The install process needs to do some special processing if the plug-in is a Java plug-in. All JAR files must be installed into the \PLUGINS\<VENDOR>.<COMPONENT> directory, and this value is used to determine whether the install process should do this. If the plug-in is a Java plug-in and this value is set to NO or doesn't exist, the plug-in may not work after it is installed.