ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/trb/trbmntrjobsiseries.htm

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><a name="trbmntrjobsiseries"></a>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 QASE51 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>OS/400 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 QASE51 subsystem:</p>
<pre>WRKACTJOB SBS(QASE51)</pre>
</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>
<pre>WRKJOB JOB(<em>job_name)</em></pre>
<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 <pre>WRKJOB JOB(SERVER1)</pre>.</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>
<pre>WRKJOB JOB(<em>job_number/job_user/job_name</em>)</pre>
<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><pre>WRKJOB SBS(QASE51)</pre></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"><pre>WRKUSRJOB USER(QEJBSVR)</pre></td>
</tr>
<tr>
<td align="left" valign="top">Delete spooled files for QEJBSVR user profile</td>
<td align="left" valign="top"><pre>DLTSPLF FILE(*SELECT) SELECT(QEJBSVR)</pre></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><pre>WRKJOB SBS(QASE51)</pre></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 (<tt>WRKUSRJOB</tt>)
or Work with Job (<tt>WRKJOB</tt>) commands.</p>
</td>
</tr>
</table>
</body>
</html>