158 lines
7.5 KiB
HTML
158 lines
7.5 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>Monitor the application server jobs with iSeries commands</title>
|
||
|
|
</head>
|
||
|
|
<BODY>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
<h3>Monitor the application server jobs with iSeries commands</h3>
|
||
|
|
<p>This topic describes the jobs used by an application server and how you can
|
||
|
|
monitor jobs by using iSeries command language (CL) commands.</p>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
<p>Each application server instance consists of one or more jobs. These jobs
|
||
|
|
run in the QASE5 subsystem. The job name is the first 10 characters of
|
||
|
|
the application server name. If the first 10 characters do not provide
|
||
|
|
a valid iSeries job name, the application server runtime creates a valid
|
||
|
|
job name. If the runtime cannot create a valid job name for the application
|
||
|
|
server, the application server will not start.</p>
|
||
|
|
<p>The application server provides the runtime environment for server-side
|
||
|
|
Java components. The application server plug-in interfaces with the Web
|
||
|
|
server to handle client requests for server-side resources and route them
|
||
|
|
to their application server for processing.</p>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<p>If using the IBM Developer Kit for Java JDBC driver for database access,
|
||
|
|
your instance uses one or more QSQSRVR jobs that run in the QSYSWRK subsystem.
|
||
|
|
To determine what QSQSRVR job your application server job is using, view
|
||
|
|
the server job log. For each JDBC connection obtained, the message SQL7908
|
||
|
|
with message text similar to the following:</p>
|
||
|
|
<pre>Job 163707/QUSER/QSQSRVR used for SQL server mode processing.</pre>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<p>If you are using the IBM Toolbox for Java JDBC driver for database access,
|
||
|
|
your instance uses one or more QZDASOINIT jobs that run in subsystem QUSRWRK.</p>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<p>Depending on which Web server you are using to serve Web resources, your
|
||
|
|
instance uses jobs from the Web server instance:</p>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
<p><strong>IBM HTTP Server (powered by Apache) </strong> <br>
|
||
|
|
Each HTTP Server (powered by Apache) instance consists of two or more
|
||
|
|
jobs that run in the QHTTPSVR subsystem. The name of each job is
|
||
|
|
the same as the name of the HTTP Server instance. The application
|
||
|
|
server plug-in code runs in the second job listed for HTTP Server
|
||
|
|
(powered by Apache) instance.</p>
|
||
|
|
</li>
|
||
|
|
<li><strong>Domino Web Server </strong> <br>
|
||
|
|
Each Domino Web Server instance has a corresponding subsystem in which
|
||
|
|
the jobs for the instance run. The subsystem for the first Web server
|
||
|
|
instance created is DOMINO001, the subsystem for the second Web server
|
||
|
|
instance created is DOMINO002, and so on. The application server plug-in
|
||
|
|
code runs in the job named HTTP in the subsystem in which your Web
|
||
|
|
server instance is running.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><strong>i5/OS command language (CL) commands for monitoring</strong></p>
|
||
|
|
<p>Use iSeries CL commands to monitor jobs that run in your application server
|
||
|
|
environment. You can view the job logs, display message details, and view spooled
|
||
|
|
files associated with the jobs. The job logs and associated spooled files for
|
||
|
|
the jobs can contain valuable information for determining the root of a problem.</p>
|
||
|
|
<p>This table lists some iSeries commands that you can use to monitor application
|
||
|
|
server jobs:</p>
|
||
|
|
<table width="75%" border="1" cellpadding="3" cellspacing="1">
|
||
|
|
<tr>
|
||
|
|
<th align="left" valign="top"><strong>Task</strong></th>
|
||
|
|
<th align="left" valign="top"><strong>iSeries command and description</strong></th>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">Work with active application server jobs</td>
|
||
|
|
<td align="left" valign="top"><p>For application server jobs that run in
|
||
|
|
the QASE5 subsystem:</p>
|
||
|
|
<p><code>WRKACTJOB SBS(QASE5)</code></p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">Work with all jobs with a specific name</td>
|
||
|
|
<td align="left" valign="top"><p>This command lists all jobs, active or not,
|
||
|
|
named <em> job_name</em>. The jobs are listed by date, most recent first:</p>
|
||
|
|
<p><code>WRKJOB JOB(<em>job_name)</em></code></p>
|
||
|
|
<p>This command is very useful when an application server ends abnormally
|
||
|
|
or fails to start successfully. For example, if an application server
|
||
|
|
started then ended immediately, you could do the following with the job
|
||
|
|
log:</p>
|
||
|
|
<ul>
|
||
|
|
<li>Run the command <code>WRKJOB JOB(SERVER1)</code>.</li>
|
||
|
|
<li>Specify option <strong>1</strong> on the option line next to the
|
||
|
|
first job listed that has a status of OUTQ.</li>
|
||
|
|
<li>Specify option <strong>4</strong> (Work with spooled files) on the
|
||
|
|
command line of the Work with Job screen.</li>
|
||
|
|
<li>Specify option <strong>5</strong> next to the QPJOBLOG spooled file
|
||
|
|
to view the contents.</li>
|
||
|
|
</ul>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">Work with a specific job</td>
|
||
|
|
<td align="left" valign="top"><p>This command displays the Work with Job
|
||
|
|
screen for the specified job:</p>
|
||
|
|
<p><code>WRKJOB JOB(<em>job_number/job_user/job_name</em>)</code></p>
|
||
|
|
<p>This command is useful when you know the fully qualified job information
|
||
|
|
for the job.</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">View the job log for an active application
|
||
|
|
server job</td>
|
||
|
|
<td align="left" valign="top"><ol>
|
||
|
|
<li>Run the following command:
|
||
|
|
<ul>
|
||
|
|
<li><code>WRKJOB SBS(QASE5)</code></li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Specify option <strong>5</strong> (Work with) in the option line
|
||
|
|
next to the active job whose job log you want to view.</li>
|
||
|
|
<li>In the Work with Job display, specify option <strong>10</strong> (Display
|
||
|
|
job log, if active or on job queue).</li>
|
||
|
|
<li>Press the <strong>F10</strong> key to display all messages.</li>
|
||
|
|
<li>In the job log, position the cursor on a message for which you want
|
||
|
|
to display extended message information.</li>
|
||
|
|
<li>Press the <strong>F1</strong> (Help) key.</li>
|
||
|
|
</ol>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">Work with application server jobs that run
|
||
|
|
under the QEJBSVR user profile</td>
|
||
|
|
<td align="left" valign="top"><code>WRKUSRJOB USER(QEJBSVR)</code></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">Delete spooled files for QEJBSVR user profile</td>
|
||
|
|
<td align="left" valign="top"><code>DLTSPLF FILE(*SELECT) SELECT(QEJBSVR)</code></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td align="left" valign="top">View the spooled files for a job</td>
|
||
|
|
<td align="left" valign="top"><ol>
|
||
|
|
<li>Run the following command:
|
||
|
|
<ul>
|
||
|
|
<li><code>WRKJOB SBS(QASE5)</code></li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Specify option <strong>8</strong> (Work with Spooled Files) in the
|
||
|
|
option line next to the active job whose job log you want to view.</li>
|
||
|
|
<li>Specify option <strong>5</strong> (Display) in the option line next
|
||
|
|
to the spooled file you want to view.</li>
|
||
|
|
</ol>
|
||
|
|
<p>You can view ended jobs by using the Work with User Jobs (<code>WRKUSRJOB</code>)
|
||
|
|
or Work with Job (<code>WRKJOB</code>) commands.</p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|