ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakx_5.4.0.1/rzakxpriregkeyex.htm

144 lines
8.3 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Example: Primary registry key" />
<meta name="abstract" content="The primary registry key defines a set of fields that specify global information for the plug-in. This information is required." />
<meta name="description" content="The primary registry key defines a set of fields that specify global information for the plug-in. This information is required." />
<meta name="DC.Relation" scheme="URI" content="rzakxsmpcplusreg.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakxsmpvbreg.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakxpriregkeyex" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Example: Primary registry key</title>
</head>
<body id="rzakxpriregkeyex"><a name="rzakxpriregkeyex"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Example: Primary registry key</h1>
<div><p>The primary registry key defines a set of fields that specify global
information for the plug-in. This information is required.</p>
<pre>;--------------------------------------------------------------------
; 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"</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" id="d0e17">Primary Registry key field</th>
<th valign="top" id="d0e19">Field Description</th>
</tr>
</thead>
<tbody><tr><td valign="top" headers="d0e17 ">Type</td>
<td valign="top" headers="d0e19 ">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.</td>
</tr>
<tr><td valign="top" headers="d0e17 ">NLS</td>
<td valign="top" headers="d0e19 ">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.</td>
</tr>
<tr><td valign="top" headers="d0e17 ">NameID</td>
<td valign="top" headers="d0e19 ">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.</td>
</tr>
<tr><td valign="top" headers="d0e17 ">DescriptionID</td>
<td valign="top" headers="d0e19 ">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.</td>
</tr>
<tr><td valign="top" headers="d0e17 ">MinimumIMPIRelease</td>
<td valign="top" headers="d0e19 "> <p>A 6-character string that identifies the minimum release of i5/OS<sup>®</sup> 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."</p>
<p>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."</p>
</td>
</tr>
<tr><td valign="top" headers="d0e17 ">MinimumRISCRelease</td>
<td valign="top" headers="d0e19 "> <p>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."</p>
<p>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."</p>
</td>
</tr>
<tr><td valign="top" headers="d0e17 ">ProductID</td>
<td valign="top" headers="d0e19 "> <p>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."</p>
<p>Multiple comma-separated product
IDs may be specified if multiple IDs exist for the same product.</p>
</td>
</tr>
<tr><td valign="top" headers="d0e17 ">ServerEntryPoint</td>
<td valign="top" headers="d0e19 ">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.</td>
</tr>
<tr><td valign="top" headers="d0e17 ">JavaPath</td>
<td valign="top" headers="d0e19 ">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<sup>®</sup> install
path, each preceded by the iSeries Access for Windows substitution variable that represents
the install path.</td>
</tr>
<tr><td valign="top" headers="d0e17 ">JavaMRI</td>
<td valign="top" headers="d0e19 ">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.</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakxsmpcplusreg.htm" title="The sample plug-includes two registry files: SAMDBG.REG, a windows-readable registry file for use during development and SAMPRLS.REG, a registry file for distribution on the iSeries server.">Customize the C++ registry values</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="rzakxsmpvbreg.htm" title="The sample plug-includes two registry files: VBSMPDBG.REG, a windows-readbale registry file for use during development and VBSMPRLS.REG, a registry file for distribution on the iSeries server.">Customize the VB plug-in registry values</a></div>
</div>
</div>
</body>
</html>