211 lines
12 KiB
HTML
211 lines
12 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: Exit programs section of the setup.ini" />
|
||
|
|
<meta name="abstract" content="The final portion of the setup file contains sections that identify the programs that are to be run on the client workstation before or after an install, upgrade or an uninstall." />
|
||
|
|
<meta name="description" content="The final portion of the setup file contains sections that identify the programs that are to be run on the client workstation before or after an install, upgrade or an uninstall." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxsetup.htm" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzakxexitprogramfiles" />
|
||
|
|
<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: Exit programs section of the setup.ini</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakxexitprogramfiles"><a name="rzakxexitprogramfiles"><!-- --></a>
|
||
|
|
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Example: Exit programs section of the setup.ini</h1>
|
||
|
|
<div><p>The final portion of the setup file contains sections that identify
|
||
|
|
the programs that are to be run on the client workstation before or after
|
||
|
|
an install, upgrade or an uninstall.</p>
|
||
|
|
<p>Below are examples of the syntax used in these exit programs sections to
|
||
|
|
identify and run programs on the client workstation before or after an install,
|
||
|
|
an upgrade, or an uninstall.</p>
|
||
|
|
<p>Example 1 - Optional program to be called before files are installed.
|
||
|
|
This is only run during an initial install.</p>
|
||
|
|
<pre>[PreInstallProgram]
|
||
|
|
Program=whatever.exe
|
||
|
|
CmdLine=
|
||
|
|
CheckReturnCode=
|
||
|
|
Wait= </pre>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25%" id="d0e21">Field in [PreInstallProgram]</th>
|
||
|
|
<th valign="top" width="75%" id="d0e23">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="25%" headers="d0e21 ">Program</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e23 ">Required. Only the file name is used if a path is specified. The program
|
||
|
|
must reside in the plug-in's <vendor>.<component> path in the installation
|
||
|
|
source.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e21 ">CmdLine</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e23 ">Optional. Whatever commands are required by the specific program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e21 ">CheckReturnCode</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e23 ">Optional. Default is <samp class="codeph">N</samp>. Installation of this plug-in
|
||
|
|
will not continue if this is set to <samp class="codeph">Y</samp> and the return is non-zero.
|
||
|
|
A message will not be displayed if the program returns a non-zero return code,
|
||
|
|
but a message will be logged in the INSTLOG.TXT</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e21 ">Wait</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e23 ">Optional. Wait for program to terminate before continuing to execute.
|
||
|
|
The default is <samp class="codeph">Y</samp>. If <samp class="codeph">CheckReturnCode=Y</samp>,
|
||
|
|
then <samp class="codeph">Wait=Y</samp> is used no matter what is specified here.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>Example 2 - Optional program to be called after files are installed. This
|
||
|
|
is only run during an initial install.</p>
|
||
|
|
<pre>[PostInstallProgram]
|
||
|
|
Program=whatever.exe
|
||
|
|
CmdLine=
|
||
|
|
CheckReturnCode=
|
||
|
|
Wait= </pre>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25%" id="d0e71">Field in [PostInstallProgram]</th>
|
||
|
|
<th valign="top" width="75%" id="d0e73">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="25%" headers="d0e71 ">Program</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e73 ">Required. Only the file name is used if a path is specified. The program
|
||
|
|
must reside in the plug-in's <vendor>.<component> directory on the PC.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e71 ">CmdLine</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e73 ">Optional. Whatever commands are required by the specific program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e71 ">CheckReturnCode</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e73 ">Optional. The same values are supported for the <samp class="codeph">PostInstallProgram</samp> as
|
||
|
|
are supported in the <samp class="codeph">PreInstallProgram</samp>, however, since the
|
||
|
|
plug-in is already installed at this point, the <samp class="codeph">CheckReturnCode</samp> value
|
||
|
|
is not as significant.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e71 ">Wait</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e73 ">Optional. Wait for program to terminate before continuing to execute.
|
||
|
|
Again, the same values are supported for the <samp class="codeph">PostInstallProgram</samp>as
|
||
|
|
are for the <samp class="codeph">PreInstallProgram</samp>, however, since the plug-in
|
||
|
|
is already installed at this point, the <samp class="codeph">CheckReturnCode</samp> value
|
||
|
|
is not as significant.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>Example 3 - Optional program to be called before files are uninstalled.</p>
|
||
|
|
<pre>[UninstallProgram]
|
||
|
|
Program=whatever.exe
|
||
|
|
CmdLine=
|
||
|
|
CheckReturnCode=
|
||
|
|
Wait= </pre>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25%" id="d0e124">Field in [UninstallProgram]</th>
|
||
|
|
<th valign="top" width="75%" id="d0e126">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="25%" headers="d0e124 ">Program</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e126 ">Required. Only the file name is used if a path is specified. The program
|
||
|
|
must reside in the plug-in's <vendor>.<component> directory on the PC.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e124 ">CmdLine</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e126 ">Optional. Whatever commands are required by the specific program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e124 ">CheckReturnCode</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e126 ">Optional. Default is <samp class="codeph">N</samp>. If the <samp class="codeph">CheckReturnCode</samp> value
|
||
|
|
is set to <samp class="codeph">Y</samp>, the uninstall of the plug-in will not continue
|
||
|
|
if the return value is non-zero. A message will not be displayed if the program
|
||
|
|
returns a non-zero return code, but a message will be logged in the INSTLOG.TXT</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e124 ">Wait</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e126 ">Optional. Wait for program to terminate before continuing to execute.
|
||
|
|
The default is <samp class="codeph">Y</samp>. If <samp class="codeph">CheckReturnCode=Y</samp>,
|
||
|
|
then <samp class="codeph">Wait=Y</samp> is used no matter what is specified here. </td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>Example 4 - Optional program to be called before files are upgraded.</p>
|
||
|
|
<pre>[PreUpgradeProgram]
|
||
|
|
Program=whatever.exe
|
||
|
|
CmdLine=
|
||
|
|
CheckReturnCode=
|
||
|
|
Wait=</pre>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25%" id="d0e177">Field in [PreUpgradeProgram]</th>
|
||
|
|
<th valign="top" width="75%" id="d0e179">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="25%" headers="d0e177 ">Program</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e179 ">Required. Only the file name is used if a path is specified. The program
|
||
|
|
must reside in the plug-in's <vendor>.<component> path in the installation
|
||
|
|
source.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e177 ">CmdLine</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e179 ">Optional. Whatever commands are required by the specific program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e177 ">CheckReturnCode</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e179 ">Optional. Default is <samp class="codeph">N</samp>. Installation of this plug-in
|
||
|
|
will not continue if this is set to <samp class="codeph">Y</samp> and the return is non-zero.
|
||
|
|
A message will not be displayed if the program returns a non-zero return code,
|
||
|
|
but a message will be logged in the INSTLOG.TXT</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e177 ">Wait</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e179 ">Optional. Wait for program to terminate before continuing to execute.
|
||
|
|
The default is <samp class="codeph">Y</samp>. If <samp class="codeph">CheckReturnCode=Y</samp>,
|
||
|
|
then <samp class="codeph">Wait=Y</samp> is used no matter what is specified here.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<p>Example 5 - Optional program to be called after files have been upgraded.</p>
|
||
|
|
<pre>[PostUpgradeProgram]
|
||
|
|
Program=whatever.exe
|
||
|
|
CmdLine=
|
||
|
|
CheckReturnCode=
|
||
|
|
Wait= </pre>
|
||
|
|
|
||
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th valign="top" width="25%" id="d0e227">Field in [PostUpgradeProgram]</th>
|
||
|
|
<th valign="top" width="75%" id="d0e229">Description</th>
|
||
|
|
</tr>
|
||
|
|
</thead>
|
||
|
|
<tbody><tr><td valign="top" width="25%" headers="d0e227 ">Program</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e229 ">Required. Only the file name is used if a path is specified. The program
|
||
|
|
must reside in the plug-in's <vendor>.<component> path in the installation
|
||
|
|
source.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e227 ">CmdLine</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e229 ">Optional. Whatever commands are required by the specific program.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e227 ">CheckReturnCode</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e229 ">Optional. The same values are supported for the <samp class="codeph">PostUpgradeProgram</samp> as
|
||
|
|
are supported in the <samp class="codeph">PreUpgradeProgram</samp>, however, since the
|
||
|
|
plug-in is already installed at this point, the <samp class="codeph">CheckReturnCode</samp> value
|
||
|
|
is not as significant.</td>
|
||
|
|
</tr>
|
||
|
|
<tr><td valign="top" width="25%" headers="d0e227 ">Wait</td>
|
||
|
|
<td valign="top" width="75%" headers="d0e229 ">Optional. Wait for program to terminate before continuing to execute.
|
||
|
|
The default is <samp class="codeph">Y</samp>. If <samp class="codeph">CheckReturnCode=Y</samp>,
|
||
|
|
then <samp class="codeph">Wait=Y</samp> is used no matter what is specified here.</td>
|
||
|
|
</tr>
|
||
|
|
</tbody>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakxsetup.htm" title="Your plug-in's setup.ini file provides the installation wizard with the information needed to install an iSeries Navigator plug-in on a client workstation. It also provides information that allows the Check Service Level program to determine when the plug-in needs to be upgraded or serviced.">Setup.ini file</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<img src="./deltaend.gif" alt="End of change" /></body>
|
||
|
|
</html>
|