95 lines
7.4 KiB
HTML
95 lines
7.4 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="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="Job logs" />
|
||
|
|
<meta name="abstract" content="A job log contains information related to requests entered for a job. A job log has two forms, a pending form and a spooled form." />
|
||
|
|
<meta name="description" content="A job log contains information related to requests entered for a job. A job log has two forms, a pending form and a spooled form." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksconcepts.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakshowjoblogscreated.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksaboutjoblogpending.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksjoblogserverabout.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksjoblogdispchar.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksinteractjoblogs.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksqhistlog.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzaksaboutspoolfile.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../experience/spool_expreport.htm" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2004-2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004-2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzaksjoblogs" />
|
||
|
|
<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>Job logs</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzaksjoblogs"><a name="rzaksjoblogs"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Job logs</h1>
|
||
|
|
<div><p>A job log contains information related to requests entered for
|
||
|
|
a job. A job log has two forms, a pending form and a spooled form.</p>
|
||
|
|
<p>In its pending form, a job log for a completed job can change as other
|
||
|
|
jobs (the subsystem, the system operator, and so on) interact with the completed
|
||
|
|
job. In its spooled form, a job log is a snapshot (a moment in time) and does
|
||
|
|
not change (such as spooled files that are created by the Display Job Log
|
||
|
|
(<span class="cmdname">DSPJOBLOG</span>) command, or created after the job completes
|
||
|
|
its activity). </p>
|
||
|
|
<p>Each job has an associated job log that can contain the following information
|
||
|
|
for the job:</p>
|
||
|
|
<div class="p"><ul><li>The commands in the job</li>
|
||
|
|
<li>The commands in a CL program (if the CL program was created with the LOG(*YES)
|
||
|
|
option or with the LOG(*JOB) option and a Change Job (<span class="cmdname">CHGJOB</span>)
|
||
|
|
command was run with the LOGCLPGM(*YES) option)</li>
|
||
|
|
<li>All messages (the message and help text for the message) sent to the requester
|
||
|
|
and not removed from the program message queues</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>At the end of the job, the job log can be written to the spooled file QPJOBLOG
|
||
|
|
so that it can be printed. However, producing a job log doesn't necessarily
|
||
|
|
mean printing it or creating a spooled file. (For example, the Control Job
|
||
|
|
Log QMHCTLJL API can be used to specify that the job log is to be written
|
||
|
|
to an outfile at the end of job.)</p>
|
||
|
|
<p><img src="./delta.gif" alt="Start of change" />You can reduce the number of job logs produced and reduce the
|
||
|
|
contention for resources (such as output queues). This reduces the resource
|
||
|
|
consumption caused by producing job logs. <img src="./deltaend.gif" alt="End of change" /></p>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<ul class="ullinks">
|
||
|
|
<li class="ulchildlink"><img src="./delta.gif" alt="Start of change" /><strong><a href="rzakshowjoblogscreated.htm">How job logs are created</a></strong><img src="./deltaend.gif" alt="End of change" /><br />
|
||
|
|
Release V5R4 brings job logs into the "on demand" world. The job logs are available when needed, but no work is done to produce job logs for which there is no need.</li>
|
||
|
|
<li class="ulchildlink"><img src="./delta.gif" alt="Start of change" /><strong><a href="rzaksaboutjoblogpending.htm">Job log pending</a></strong><img src="./deltaend.gif" alt="End of change" /><br />
|
||
|
|
The job log pending state has been available for many years. When a job's job log attribute is *PND, no job log is produced. With the release of V5R4 enhancements have been made to both iSeries Navigator and the character-based interface so that you can now control how and under what circumstances the job log for a specific job will be produced.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaksjoblogserverabout.htm">Job log server</a></strong><br />
|
||
|
|
Typically the job log server writes a job's job log to a spooled file. You can route the job log to a printer or to an outfile, (if specified to do so by using the QMHCTLJL, Control job log API), however this is not the recommended method for producing job logs.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaksjoblogdispchar.htm">Job log characteristics</a></strong><br />
|
||
|
|
The iSeries™ Navigator
|
||
|
|
provides you with a user friendly, easy to read interface from which you can
|
||
|
|
view job logs and the job log's messages. You can also view job logs by using
|
||
|
|
the character based interface.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaksinteractjoblogs.htm">Interactive job logs</a></strong><br />
|
||
|
|
The IBM-supplied job descriptions QCTL, QINTER, and QPGMR all have a log level of LOG(4 0 *NOLIST); therefore all messages help text are written to the job log. However, the job logs are not printed if the job ends normally unless you specify *LIST on the SIGNOFF command.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaksqhistlog.htm">QHST History Log</a></strong><br />
|
||
|
|
The history (QHST) log consists of a message queue and a physical file known as a log-version. Messages sent to the log message queue are written by the system to the current log-version physical file.</li>
|
||
|
|
<li class="ulchildlink"><strong><a href="rzaksaboutspoolfile.htm">Spooled files</a></strong><br />
|
||
|
|
A spooled file holds output data until it can be printed. The spooled file collects data from a device until a program or device is able to process the data. A program uses a spooled file as if it were reading from or writing to an actual device. This is input and output spooling.</li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaksconcepts.htm" title="Whether you are new to work management or have been using work management tools for years, you will find something useful in the Concepts section of the Work management topic collection.">Concepts</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
||
|
|
<div><a href="../experience/spool_expreport.htm">Spool Performance Considerations</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|