94 lines
5.2 KiB
HTML
94 lines
5.2 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 log considerations" />
|
|
<meta name="abstract" content="The following information gives suggestions to apply to using job logs." />
|
|
<meta name="description" content="The following information gives suggestions to apply to using job logs." />
|
|
<meta name="DC.subject" content="job log, suggestions when using" />
|
|
<meta name="keywords" content="job log, suggestions when using" />
|
|
<meta name="DC.Relation" scheme="URI" content="jblog.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/oa1.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="jlcon" />
|
|
<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 log considerations</title>
|
|
</head>
|
|
<body id="jlcon"><a name="jlcon"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Job log considerations</h1>
|
|
<div><p>The following information gives suggestions to apply to using job
|
|
logs.</p>
|
|
<ul><li>To change the output queue for all jobs on the system, use the OUTQ or
|
|
DEV parameter on the <span class="cmdname">Change Printer File (CHGPRTF)</span> command
|
|
to change the file QSYS/QPJOBLOG. The following are two examples using each
|
|
of the parameters: <pre>CHGPRTF FILE(QSYS/QPJOBLOG)
|
|
DEV (USRPRT)
|
|
|
|
or
|
|
|
|
CHGPRTF FILE(QSYS/QPJOBLOG)
|
|
OUTQ(USROUTQ)</pre>
|
|
</li>
|
|
<li>To change the QPJOBLOG printer file to use output queue QEZJOBLOG, use
|
|
the Operational Assistant cleanup function. When you want to use automatic
|
|
cleanup of the job logs, the printer files must be directed to this output
|
|
queue.</li>
|
|
<li>To specify the output queue to which a job's job log is written, make
|
|
sure that file QPJOBLOG has OUTQ(*JOB) specified. You can use the OUTQ parameter
|
|
on any of the following commands: BCHJOB, CRTJOBD, CHGJOBD, or CHGJOB. The
|
|
following is an example: <pre>CHGJOB OUTQ(*JOB)</pre>
|
|
<p>If you change the default OUTQ at the beginning of the job,
|
|
all spooled files are affected. If you change it just before job completion,
|
|
only the job log is affected. You cannot use the <span class="cmdname">Override with Printer
|
|
File (OVRPRTF)</span> command to affect the job log.</p>
|
|
</li>
|
|
<li>If the output queue for a job cannot be found, no job log is produced.</li>
|
|
<li>To hold all job logs, specify HOLD(*YES) on the CHGPRTF command for the
|
|
file QSYS/QPJOBLOG. The job logs are then released to the writer when the <span class="cmdname">Release
|
|
Spooled File (RLSSPLF)</span> command is run. The following is an example:
|
|
<pre>CHGPRTF FILE(QSYS/QPJOBLOG)
|
|
HOLD(*YES)</pre>
|
|
</li>
|
|
<li>If the system abnormally ends, the start prompt allows the system operator
|
|
to specify whether the job logs are to be printed for any jobs that were active
|
|
at the time of the abnormal end.</li>
|
|
<li>To delete a job log, use the <span class="cmdname">Delete Spooled File (DLTSPLF)</span> command
|
|
or the Delete option on the output queue display.</li>
|
|
<li>If you used the USRDTA parameter on the <span class="cmdname">Change Print File (CHGPRTF)</span> command
|
|
to change the user data value for the QSYS/QPJOBLOG file, the value specified
|
|
will not be shown on the Work with Output Queue or Work with All Spooled Files
|
|
displays. The value shown in the user data column is the job name of the
|
|
job whose job log has printed.</li>
|
|
<li>If job logs are being analyzed by programming technique, use the <span class="apiname">QMHCTLJL</span> API
|
|
to direct the job log to the database file(s). The format of the records
|
|
in the database file is guaranteed while the printed format is not. If new
|
|
fields need to be added to a job log record, they are added at the end of
|
|
the record so existing programs will continue to work. Query features provided
|
|
by the system can be used directly on the files.</li>
|
|
</ul>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="jblog.htm" title="Each job has an associated job log.">Job log</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../apis/oa1.htm">Operational Assistance APIs</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |