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

75 lines
3.3 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 showlog script</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h5><a name="qshshowlog"></a>The showlog script</h5>
<p>The showlog script displays the contents the <a href="trbserviceintro.htm">IBM
Service log</a>. For information on running Qshell scripts, see <a href="../admin/qshadm.htm">Configure
Qshell to run WebSphere Application Server - Express scripts</a>.</p>
<p><strong>Authority</strong></p>
<p>To run this script, your user profile must have *ALLOBJ authority.</p>
<p><strong>Usage</strong></p>
<p>To display the IBM Service log, follow these steps:</p>
<ol>
<li>
<p>On the CL command line, run the STRQSH (Start Qshell) command.</p>
</li>
<li>
<p>Run the cd command to change to the directory that contains the script:</p>
<pre>cd /QIBM/ProdData/WebASE/ASE5/bin</pre>
</li>
<li>
<p>Run the showlog script:</p>
<pre>showlog -instance <em>instance</em> <em>binaryfile</em></pre>
<p>where <em>instance</em> is the name of your application server instance
and <em>binaryfile</em> is the name of the IBM Service log file that you
want to view.</p>
</li>
</ol>
<p><strong>Syntax</strong></p>
<p>The syntax of the showlog script is:</p>
<pre>showlog -instance <em>instance</em> <em>binaryfile</em> [ <em>outputfile</em> ]</pre>
<p><strong>Parameters</strong></p>
<p>The parameters of the showlog script are:</p>
<ul>
<li>
<p><strong><em>-instance</em></strong><br>
This is a required parameter. The value <em>instance</em> specifies the
instance for which you want to display the IBM service log. </p>
</li>
<li>
<p><strong><em>binaryfile</em></strong> <br>
This is a required paramter. The value <em>binaryfile</em> specifies the
of the IBM Service log file. If you do not specify a fully qualified file
name, the script searches for the specified file in the /QIBM/UserData/WebASE/ASE5/<em>instance</em>/logs
directory, where <em>instance</em> is the name of your instance. </p>
<p><strong>Note:</strong> The QEJBSVR user profile must have *R authority
to the specified file.</p>
</li>
<li>
<p><strong><em>outputfile</em></strong> <br>
This is an optional parameter. The value <em>outputfile</em> specifies
the name of the file to which the script writes the formatted contents
of the IBM service log. If you do not specify a fully qualified file name,
the script creates the output file in the current working directory. By
default, showlog writes results to standard out. </p>
<p><strong>Note:</strong> The QEJBSVR user profile must have *RW authority
to the directory to contain the output file.</p>
</li>
</ul>
<p><strong>Example</strong></p>
<pre>showlog -instance myinst /QIBM/UserData/WebASE/ASE5/myAppSvr/logs/activity.log
/home/myprofile/formatted_activity.log</pre>
<p>This example writes the formatted contents of the activity.log file for the
myAppSvr instance to the file formatted_activity.log in the /home/myprofile
directory.</p>
</body>
</html>