The primary registry key defines a set of fields that specify global information for the plug-in. This information is required.
;-------------------------------------------------------------------- ; Define the primary registry key for the plugin ; NOTE: NLS and ServerEntryPoint DLL names must not contain qualified directory paths [HKEY_CLASSES_ROOT\IBM.AS400.Network\3RD PARTY plug-inS\IBM.Sample] "Type"="PLUGIN" "NLS"="sampmri.dll" "NameID"=dword:00000080 "DescriptionID"=dword:00000081 "MinimumIMPIRelease"="NONE" "MinimumRISCRelease"="030701" "ProductID"="NONE" "ServerEntryPoint"="sampext.dll"
| Primary Registry key field | Field Description |
|---|---|
| Type | If the plug-in adds new folders to the iSeries™ Navigator hierarchy, the value of this field should be PLUGIN. Otherwise, it should be EXT. |
| NLS | Identifies the name of the resource DLL that contains the locale-dependent resources for the plug-in. In the development version of the registry file, this may be a fully-qualified pathname. |
| NameID | A double word containing the resource identifier of the text string in the resource DLL which will be used to identify the plug-in in the iSeries Navigator user interface. |
| DescriptionID | A double word that contains the resource identifier of the text string in the resource DLL. This resource DLL is used to describe the function of the plug-in in the iSeries Navigator user interface. |
| MinimumIMPIRelease | A 6-character string that identifies the minimum release of i5/OS® that runs on the IMPI hardware that the plug-in requires. The string should be of the form vvrrmm, where vv is the i5/OS Version, rr is the Release, and mm is the Modification Level. For example, if the plug-in requires Version 3 Release 2 Modification Level 0, the value of this field should be "030200." If the plug-in does not support any i5/OS release that runs on IMPI hardware (releases prior to Version 3 Release 6), the value of this field should be "NONE." If the plug-in can support any release that runs on IMPI hardware, the value of this field should be "ANY." |
| MinimumRISCRelease | A 6-character string that identifies the minimum release of i5/OS that runs on RISC hardware that the plug-in requires. The string should be of the form vvrrmm, where vv is the i5/OS Version, rr is the Release, and mm is the Modification Level. For example, if the plug-in requires Version 3 Release 7 Modification Level 1, the value of this field should be "030701." If the plug-in does not support any i5/OS release that runs on RISC hardware (Version 3 Release 6 and above), the value of this field should be "NONE." If the plug-in can support any release that runs on RISC hardware, the value of this field should be "ANY." |
| ProductID | A 7-character string that specifies the product ID of a prerequisite iSeries server licensed program that is required by the plug-in. If the plug-in does not require that a particular licensed program be installed on the iSeries server, the value of this field should be "NONE." Multiple comma-separated product IDs may be specified if multiple IDs exist for the same product. |
| ServerEntryPoint | The name of the code DLL that implements the server entry point. This entry point is called by the iSeries Navigator when it needs to determine whether the plug-in is supported on a particular iSeries server. If the plug-in does not implement the entry point, the value of this field should be "NONE." In the development version of the registry file, this may be a fully-qualified pathname. |
| JavaPath | The classpath string that identifies the location of your plug-in's Java™ classes. During development of your plug-in, this field might contain the directory paths for the directories where your class files reside. In the production version of the registry file, it should identify your JAR file names relative to the iSeries Access for Windows® install path, each preceded by the iSeries Access for Windows substitution variable that represents the install path. |
| JavaMRI | The base names of the JAR files that contain locale-dependent resources for the plug-in. iSeries Navigator will search for each JAR file after first suffixing the name with the appropriate Java language and country identifiers. If no MRI JAR files exist for a given locale, iSeries Navigator will expect the MRI for the base locale (usually US English) to reside in the code JAR files. |