121 lines
7.4 KiB
HTML
121 lines
7.4 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="Setting up sample Visual Basic plug-ins" />
|
||
|
|
<meta name="abstract" content="The sample Visual Basic (VB) plug-in adds a folder to the iSeries Navigator hierarchy that provides a list of i5/OS libraries, and illustrates how to implement properties and actions on those library objects." />
|
||
|
|
<meta name="description" content="The sample Visual Basic (VB) plug-in adds a folder to the iSeries Navigator hierarchy that provides a list of i5/OS libraries, and illustrates how to implement properties and actions on those library objects." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxinstrunsmpleplug.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxvbdiroffiles.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxvbdiroffiles.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="http://www.ibm.com/eserver/iseries/access/toolkit/opnav_plugins.htm" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzakxinstrunsmpvb" />
|
||
|
|
<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>Setting up sample Visual Basic plug-ins</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakxinstrunsmpvb"><a name="rzakxinstrunsmpvb"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Setting up sample Visual Basic plug-ins</h1>
|
||
|
|
<div><p>The sample Visual Basic (VB) plug-in adds a folder to the iSeries™ Navigator
|
||
|
|
hierarchy that provides a list of i5/OS<sup>®</sup> libraries, and illustrates
|
||
|
|
how to implement properties and actions on those library objects.</p>
|
||
|
|
<p>In addition to installing the plug-in code, the sample plug-in includes
|
||
|
|
a Readme.txt file, and two registry files, one for use during development,
|
||
|
|
and another for distribution with the retail version. See the sample VB plug-in
|
||
|
|
directory of files for detailed description of all the files included with
|
||
|
|
the VB plug-in.</p>
|
||
|
|
<p>In order to get the sample VB plug-in running on your PC, you must complete
|
||
|
|
the following steps:</p>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><tbody><tr><td valign="top" width="12.5%">Download the VB plug-in</td>
|
||
|
|
<td valign="top" width="87.5%">Download the executable file vbopnav.exe. When you run the file it
|
||
|
|
will extract all the files associated with the plug-in. Make a new directory,
|
||
|
|
c:\VBSample, and copy all the files into it. If you create a different directory,
|
||
|
|
you will have to modify registry file to specify the correct location for
|
||
|
|
the plug-in.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.5%">Create the VB project</td>
|
||
|
|
<td valign="top" width="87.5%">Open vbsample.vpb in Visual Basic. In the reference dialog, select <strong>IBM<sup>®</sup> iSeries Access
|
||
|
|
for Windows<sup>®</sup> ActiveX
|
||
|
|
Object Library</strong>, and <span class="uicontrol">iSeries Navigator Visual Basic Plug-in
|
||
|
|
Support</span>.<div class="note"><span class="notetitle">Note:</span> If either of these references do not appear in your
|
||
|
|
References dialog, select Browse and look for cwbx.dll and cwbunvbi.dll in
|
||
|
|
the iSeries Access
|
||
|
|
for Windows shared
|
||
|
|
directory. The IBM iSeries Access
|
||
|
|
ActiveX Object Library contains OLE automation objects that the sample application
|
||
|
|
requires to make remote command calls to the iSeries server. The iSeries Navigator
|
||
|
|
Visual Basic Plug-in Support contains classes and interfaces required to create
|
||
|
|
a Visual Basic Plug-in. directory.</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.5%">Build the ActiveX server DLL</td>
|
||
|
|
<td valign="top" width="87.5%">Select <span class="uicontrol">Make</span> from the Visual Basic file menu
|
||
|
|
to build the DLL. If it doesn't compile and link, locate and fix the errors,
|
||
|
|
and then rebuild the DLL.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.5%">Build the resource library</td>
|
||
|
|
<td valign="top" width="87.5%"> <ol><li>Open Microsoft<sup>®</sup> Developer Studio, open the File menu,
|
||
|
|
select Open Workspace and then select the <span class="uicontrol">VBSample\win32</span> directory.</li>
|
||
|
|
<li>In <span class="uicontrol">Files of Type</span>:, specify <span class="uicontrol">Makefiles</span> (*.mak)</li>
|
||
|
|
<li>Select vbsmpmri.mak and click <span class="uicontrol">Open</span>.</li>
|
||
|
|
<li>Open the Build menu and select Rebuild All to compile and link the DLL.</li>
|
||
|
|
</ol>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> You do not have to create this DLL on your own. The sample includes
|
||
|
|
a resource DLL that contains the translatable text strings and other locale-dependent
|
||
|
|
resources for the plug-in is included with the sample. Even if your plug-in
|
||
|
|
supports only one language, your plug-in code must load its text strings and
|
||
|
|
locale-specific resources from this resource library.</div>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.5%">Register the plug-in</td>
|
||
|
|
<td valign="top" width="87.5%">Double-click the file vbsmpdbg.reg in order to register the plug-in.
|
||
|
|
If you did not use the directory c:\VBSample, edit the registry file, and
|
||
|
|
replace all occurrences of "c:\\VBSample\\" with the fully-qualified path
|
||
|
|
to the plug-in code. You must use double back slashes in the path.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="12.5%">Run the plug-in in iSeries Navigator</td>
|
||
|
|
<td valign="top" width="87.5%">Start iSeries Navigator,
|
||
|
|
and click on the "+" next to an iSeries server to expand the tree. iSeries Navigator
|
||
|
|
will detect the changes to the registry, and prompt you to scan the iSeries server
|
||
|
|
in order to verify that it is capable of supporting the new plug-in. After
|
||
|
|
completing the scan, iSeries Navigator will display the new plug-in in
|
||
|
|
the tree hierarchy.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><strong><a href="rzakxvbdiroffiles.htm">Sample VB plug-in directory of files</a></strong><br />
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakxinstrunsmpleplug.htm" title="The Programmer's Toolkit supplies sample plug-ins in each of the supported programming languages.">Install and run sample plug-ins</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzakxvbdiroffiles.htm">Sample VB plug-in directory of files</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
|
|
<div><a href="http://www.ibm.com/eserver/iseries/access/toolkit/opnav_plugins.htm" target="_blank">Download the executable file vbopnav.exe</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|