ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dsplogjs.htm

448 lines
15 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Display Log for Job Scheduler (DSPLOGJS)</title>
</head>
<body bgcolor="white">
<a name="DSPLOGJS.Top_Of_Page"></a>
<h2>Display Log for Job Scheduler (DSPLOGJS)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#DSPLOGJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DSPLOGJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DSPLOGJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DSPLOGJS"></a>
<p>The Display Log for Job Scheduler (DSPLOGJS) command allows you to display or print the Advanced Job Scheduler log. The Advanced Job Scheduler log is a display by date and time of messages that Advanced Job Scheduler has created as a result of processing. The DSPLOGJS command allows you to display or print all or part of the log.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPLOGJS.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.TYPE"><b>TYPE</b></a></td>
<td valign="top">Type</td>
<td valign="top"><b><u>*ALL</u></b>, *RUN, *SUBMIT, *MAINT, *EMAIL, *WORKFLOW</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top" rowspan="7"><a href="#DSPLOGJS.PERIOD"><b>PERIOD</b></a></td>
<td valign="top">Time period for log output</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="7">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Start time and date</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Beginning time</td>
<td valign="top">
<i>Time</i>, <b><u>*AVAIL</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Beginning date</td>
<td valign="top">
<i>Character value</i>, <b><u>*CURRENT</u></b>, *BEGIN</td>
</tr>
<tr>
<td valign="top">Element 2: End time and date</td>
<td valign="top">
<i>Element list</i></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 1: Ending time</td>
<td valign="top">
<i>Time</i>, <b><u>*AVAIL</u></b></td>
</tr>
<tr>
<td valign="top" style="padding-left:10pt">Element 2: Ending date</td>
<td valign="top">
<i>Character value</i>, <b><u>*CURRENT</u></b>, *END</td>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.SEV"><b>SEV</b></a></td>
<td valign="top">Severity</td>
<td valign="top">0-99, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.DETAIL"><b>DETAIL</b></a></td>
<td valign="top">Detail</td>
<td valign="top"><b><u>*BASIC</u></b>, *FULL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#DSPLOGJS.JOB"><b>JOB</b></a></td>
<td valign="top">Job entry</td>
<td valign="top">Single values: *NONE<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Job</td>
<td valign="top">
<i>Generic name, name</i>, <b><u>*ALL</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Group</td>
<td valign="top">
<i>Generic name, name</i>, <b><u>*ALL</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top">Element 3: Group sequence</td>
<td valign="top">
1-99, <b><u>*ALL</u></b>, *NONE</td>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.RMTLOCNAME"><b>RMTLOCNAME</b></a></td>
<td valign="top">Remote location name</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *LCL</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.USER"><b>USER</b></a></td>
<td valign="top">User</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#DSPLOGJS.MSGID"><b>MSGID</b></a></td>
<td valign="top">Message identifier</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DSPLOGJS.TYPE"></a>
<h3>Type (TYPE)</h3>
<p>The type of entry for which you want to review log entries.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Selects all log entries for display.
</dd>
<dt><b>*RUN</b></dt>
<dd>Selects only job run entries for display.
</dd>
<dt><b>*SUBMIT</b></dt>
<dd>Selects only submit job log entries for display.
</dd>
<dt><b>*MAINT</b></dt>
<dd>Selects only maintenance log entries for display.
</dd>
<dt><b>*EMAIL</b></dt>
<dd>Selects only e-mail related log entries for display.
</dd>
<dt><b>*WORKFLOW</b></dt>
<dd>Selects only Work Flow related log entries for display.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.PERIOD"></a>
<h3>Time period for log output (PERIOD)</h3>
<p>Specifies the period of time for which the log entries are selected for the display or report.
</p>
<p><b>Element 1: Start time and date</b>
</p>
<p>Specifies the beginning time and date at or after which log entries are included. Any log entries created before the specified time and date are not included in the display or report.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Beginning time</b>
</p>
<dl>
<dt><b><u>*AVAIL</u></b></dt>
<dd>Any time that is available for the beginning date is included.
</dd>
<dt><b><i>time</i></b></dt>
<dd>Specify the beginning time for the specified beginning date that indicates which log entries are to be included.
<p>The time is specified in 24-hour format and can be specified with or without a time separator:
</p>
<ul>
<li>Without a time separator, specify a string of 4 digits (hhmm) where hh=hours and mm=minutes. Hours and minutes must each be exactly 2 digits (using leading zeros if necessary).
</li>
<li>With a time separator, specify a string of 5 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
</li>
</ul>
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Beginning date</b>
</p>
<dl>
<dt><b><u>*BEGIN</u></b></dt>
<dd>History entries from the beginning of the log entries are included.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>Log entries with a current date creation date and between the specified beginning and ending times (if specified) are included.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the beginning date. The date must be specified in the job date format.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify a number to represent the number of days before the current date that you want to use for the search. An example would be 10. If today's date were 3/12/01 (date format is mm/dd/yy), the Begin date for the Advanced Job Scheduler log would be 3/2/01.
</dd>
</dl>
</dd>
</dl>
<p><b>Element 2: End time and date</b>
</p>
<p>Specifies the ending time and date after which log entries are not included. Any log entries made after the specified time and date are not included in the display or report.
</p>
<dl>
<dt><b></b></dt>
<dd>
<p><b>Element 1: Ending time</b>
</p>
<dl>
<dt><b><u>*AVAIL</u></b></dt>
<dd>Any time that is available for the ending date is included.
</dd>
<dt><b><i>time</i></b></dt>
<dd>Specify the ending time for the specified ending date that indicates which log entries are to be included.
</dd>
</dl>
</dd>
<dt><b></b></dt>
<dd>
<p><b>Element 2: Ending date</b>
</p>
<dl>
<dt><b><u>*END</u></b></dt>
<dd>The log entries to the end of the log information are included in the display or report.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>Log entries whose date is on or before the current date are included in the display or report.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the ending date. The date must be specified in the job date format.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify a number to represent the number of days before the current date that you want to use for the search. An example would be 10. If today's date were 3/22/01 (date format is mm/dd/yy), the End date for the Advanced Job Scheduler log would be 3/12/01.
</dd>
</dl>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.SEV"></a>
<h3>Severity (SEV)</h3>
<p>Specifies the message severity level that you want to include in the report/display. For example, a severity level of 30 would include all messages that are severity level 30 and above.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all severity levels in the display or report.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the severity level associated with log entries that you want to include in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).
</dd>
<dt><b>*PRINT</b></dt>
<dd>The output is printed with the job's spooled output.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.DETAIL"></a>
<h3>Detail (DETAIL)</h3>
<p>Specifies the format used for the printed output.
</p>
<dl>
<dt><b><u>*BASIC</u></b></dt>
<dd>The entries are printed in abbreviated list format.
</dd>
<dt><b>*FULL</b></dt>
<dd>The detail of each entry is printed in an expanded format.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.JOB"></a>
<h3>Job entry (JOB)</h3>
<p>Specifies the name of the job whose log entries you want to display or print. You must specify a job for every job and alternately can specify a group to which the job belongs as well as a sequence number for the job within the group.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>Jobs that have no log entries are displayed.
</dd>
</dl>
<p><b>Element 1: Job</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All jobs that have log entries are displayed.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the jobs whose log entries you want to display. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete job.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job whose log entries you want to display.
</dd>
</dl>
<p><b>Element 2: Group</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All groups to which the specified job or jobs are a member are displayed.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no group associated with the job.
</dd>
<dt><b><i>generic-name</i></b></dt>
<dd>Specify the generic name of the group whose log entries you want to display. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete group.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the group that contains the job whose log entries you want to display.
</dd>
</dl>
<p><b>Element 3: Group sequence</b>
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All job sequences that belong to this group with log entries are displayed.
</dd>
<dt><b>*NONE</b></dt>
<dd>There is no sequence number associated with the job.
</dd>
<dt><b><i>1-99</i></b></dt>
<dd>Specify the sequence number of the job within the group whose log entries you want to display.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.RMTLOCNAME"></a>
<h3>Remote location name (RMTLOCNAME)</h3>
<p>Specifies the remote location and network identification of the system that created the log entry that you want to display.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Selects all log entries for all systems in the network.
</dd>
<dt><b>*LCL</b></dt>
<dd>Selects all log entries for the local system.
</dd>
<dt><b><i>remote-location-name</i></b></dt>
<dd>Specify the name of the remote location associated with the system whose log entries you want to display.
</dd>
<dt><b><i>network-ID.remote-location-name</i></b></dt>
<dd>Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.USER"></a>
<h3>User (USER)</h3>
<p>Specifies the name of the user profile for the log entries that you want to display.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all user profiles in the display or report.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user profile whose log entries you want to include in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DSPLOGJS.MSGID"></a>
<h3>Message identifier (MSGID)</h3>
<p>Specifies the message identifier for the log entries that you want to display.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Include all message identifiers in the display or report.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the message identifier whose log entries you want to include in the display or report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DSPLOGJS.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DSPLOGJS PERIOD((*AVAIL *BEGIN) (*AVAIL *END))
JOB(JOB02)
</pre>
</p>
<p>This command displays Job Scheduler log entries from the beginning of the log to the end of the log for JOB02.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DSPLOGJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#DSPLOGJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>