ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzamy_5.4.0.1/50/trb/qshsvctools.htm

65 lines
4.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
<title>The servicetools script</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h4><a name="qshsvctools"></a>The servicetools script</h4>
<p>The servicetools script includes serviceability tools that you can use to help troubleshoot WebSphere Application Server - Express.</p>
<p><strong>Authority</strong></p>
<p>To run this script, your user profile must have *ALLOBJ authority.</p>
<p><strong>Syntax</strong></p>
<p>The syntax of the script is:</p>
<pre>servicetools [ -products <em>product_list</em> [ -instances <em>instance_list</em> ] ]
[ -input <em>input_file</em> ] [ -output <em>output_file</em> ] [ -trace <em>trace_file</em> ]
[ <em>-tools</em> <em>tool_options</em> ]</pre>
<p><strong>Parameters</strong></p>
<p>The parameters of the script are:</p>
<ul>
<li><p><strong>-products</strong>
<br>This is an optional parameter. The value <em>product_list</em> specifies the list of products for which you want to run the tools. If you specify multiple products, separate them with a colon (:). Valid products are WAS50Base, WAS50ND, WAS50Express, WAS40Adv, WAS40AEs, and ALL. If you do not specify this parameter, you must specify the -products parameter for each tool as appropriate.</p>
<p><strong>Note:</strong> Not all tools require that you specify a product. This parameter applies only to those tools that require that you specify a product.</p></li>
<li><p><strong>-instances</strong>
<br>This is an optional parameter. The value <em>instance_list</em> specifies the instance or instances for which you want to run the tools. If you specify multiple instances, separate them with a colon (:). If you do not specify this parameter, the tools run for all of the instances in the products specified by the -products parameter.</p></li>
<li><p><strong>-input</strong>
<br>This is an optional parameter. The value <em>input_file</em> specifies an alternate XML Configuration file for the service tools. By default, the servicetools script uses the validator.xml file that is included in the ServiceTools.jar file.</p></li>
<li><p><strong>-output</strong>
<br>This is an optional parameter. The value <em>output_file</em> specifies a file to which the script writes standard output. If this value is not specified, the script writes the standard output to the display.</p></li>
<li><p><strong>-trace</strong>
<br>This is an optional parameter. The value <em>trace_file</em> specifies a file to which the script writes trace information. If you do not specify this parameter, the script does not generate trace information.</p></li>
<li><p><strong><em>-tools</em></strong>
<br>This parameter specifies the tool or tools that you want to run. The value <em>tools</em> specifies the tool that you want to run. The value <em>tool_options</em> specifies the parameters for the tool. These are the valid values for <em>-tools</em>:</p>
<ul>
<li><p><strong>-checkprereqs</strong>
<br>If you specify this parameter, the script starts the prerequisite validator tool. For information on this tool and its parameters, see <a href="qshprereq.htm">The prerequisite validator tool</a>.</p></li>
<li><p><strong>-portconflict</strong>
<br>If you specify this parameter, the script starts the port validator tool. For information on this tool and its parameters, see <a href="qshportval.htm">The port validator tool</a>.</p></li>
</ul>
<p>You must specify all other parameters before you specify the <em>tools</em> parameter. You must specify the options for each tool after its parameter. You can specify more than one tool when you run the servicetools script. To run multiple tools, use this format:</p>
<pre>servicetools <em>parameters</em> <em>-tool1</em> <em>tool1_options</em> <em>-tool2</em> <em>tool2_options</em></pre></li>
<li><p><strong>-help</strong>
<br>This optional parameter displays the usage statement for the script.</p></li>
</ul>
</body>
</html>