397 lines
15 KiB
HTML
397 lines
15 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">
|
||
|
|
<title>Display Log (DSPLOG)</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</head>
|
||
|
|
<body bgcolor="white">
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<a name="DSPLOG.Top_Of_Page"></a>
|
||
|
|
<h2>Display Log (DSPLOG)</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="#DSPLOG.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#DSPLOG.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#DSPLOG.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="DSPLOG"></a>
|
||
|
|
<p>The Display Log (DSPLOG) command shows the system history log (QHST). The history log contains information about the operation of the system and system status.
|
||
|
|
</p>
|
||
|
|
<p>The display contains the messages sent to the log, the date and time the message was sent, and the name of the job that sent it.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="DSPLOG.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="#DSPLOG.LOG"><b>LOG</b></a></td>
|
||
|
|
<td valign="top">Log</td>
|
||
|
|
<td valign="top"><b><u>QHST</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="7"><a href="#DSPLOG.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, Positional 2</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>Date</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>Date</i>, <b><u>*CURRENT</u></b>, *END</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#DSPLOG.OUTPUT"><b>OUTPUT</b></a></td>
|
||
|
|
<td valign="top">Output</td>
|
||
|
|
<td valign="top"><b><u>*</u></b>, *PRINT, *PRTWRAP, *PRTSECLVL</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="4"><a href="#DSPLOG.JOB"><b>JOB</b></a></td>
|
||
|
|
<td valign="top">Jobs to display</td>
|
||
|
|
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 5 repetitions): <i>Qualified job name</i></td>
|
||
|
|
<td valign="top" rowspan="4">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Jobs to display</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: User</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 3: Number</td>
|
||
|
|
<td valign="top">000000-999999</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#DSPLOG.MSGID"><b>MSGID</b></a></td>
|
||
|
|
<td valign="top">Message identifier</td>
|
||
|
|
<td valign="top">Single values: <b><u>*ALL</u></b><br>Other values (up to 100 repetitions): <i>Name</i></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="DSPLOG.LOG"></a>
|
||
|
|
<h3>Log (LOG)</h3>
|
||
|
|
<p>Specifies the log on the system that is shown.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>QHST</u></b></dt>
|
||
|
|
<dd>The system history log QHST is shown.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPLOG.PERIOD"></a>
|
||
|
|
<h3>Time period for log output (PERIOD)</h3>
|
||
|
|
<p>Specifies the period of time for which the logged message data is shown. This parameter contains two element lists of two elements each. A value or *N must be specified for an element if a subsequent element value will be specified in order to maintain its position in the parameter value sequence. If PERIOD is not specified, the following values are assumed:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PERIOD((*AVAIL *CURRENT) (*AVAIL *CURRENT))
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Start time and date</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 1: Starting time</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the starting time at which or after which the data must have been logged. Any entries logged before the specified time and date are not shown.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Any logged data that is available for the specified starting date is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-time</i></b></dt>
|
||
|
|
<dd>Specify the starting time for the specified starting date that indicates the logged data to be shown. The time is specified in 24-hour format and can be specified with or without a time separator:
|
||
|
|
<ul>
|
||
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (<b>hhmm</b> or <b>hhmmss</b>) where <b>hh</b> = hours, <b>mm</b> = minutes, and <b>ss</b> = seconds. Hours, minutes, and seconds must each be exactly 2 digits. Use leading zeros if necessary. Valid values for <b>hh</b> range from 00 through 23. Valid values for <b>mm</b> and <b>ss</b> range from 00 through 59.
|
||
|
|
</li>
|
||
|
|
<li>With a time separator, specify a string of 5 or 8 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: Starting date</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the starting date on which or after which the data must have been logged. Any entries logged before the specified date are not shown.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The logged data for the current day and between the specified starting and ending times (if specified) is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BEGIN</b></dt>
|
||
|
|
<dd>The logged data from the beginning of the log is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>start-date</i></b></dt>
|
||
|
|
<dd>Specify the starting date with or without date separators. The date must be entered in the date format that this job uses, as specified in the date format job attribute. If date separators are used then they need to be the same as the date separator that this job uses, as specified in the date separator job attribute.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: End time and date</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The values specified for the ending date and time are ignored if the output is shown on the display. That is, all data in the log that was logged on or after the specified starting date and time can be shown, regardless of the ending date and time specified.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 1: Ending time</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the ending time before which the data must have been logged.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*AVAIL</u></b></dt>
|
||
|
|
<dd>Any logged data that is available for the specified ending date is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-time</i></b></dt>
|
||
|
|
<dd>Specify the ending time for the specified ending date that determines the logged data to be printed. See <b>start-time</b> for the formats in which time can be entered.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Element 2: Ending date</b>
|
||
|
|
</p>
|
||
|
|
<p>One of the following is used to specify the ending date before which or on which the data must have been logged.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURRENT</u></b></dt>
|
||
|
|
<dd>The current day is the last day for which logged data is shown.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*END</b></dt>
|
||
|
|
<dd>The last day on which data was logged is the last day for which the logged data is shown. If *END is specified, an ending time value other than *AVAIL is ignored.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>end-date</i></b></dt>
|
||
|
|
<dd>Specify the ending date with or without date separators. The date must be entered in the date format that this job uses, as specified in the date format job attribute. If date separators are used then they need to be the same as the date separator that this job uses, as specified in the date separator job attribute.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>If no output is received after you run the DSPLOG command with *PRINT specified, the dates of some message data may be out of sequence. To print the data in this case, specify:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
PERIOD((*AVAIL *BEGIN)(*AVAIL *END)).
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPLOG.OUTPUT"></a>
|
||
|
|
<h3>Output (OUTPUT)</h3>
|
||
|
|
<p>Specifies whether the output from the command is shown at the requesting display station or printed with the job's spooled output.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*</u></b></dt>
|
||
|
|
<dd>Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRINT</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output. Only one line of message text will be printed for each message. This will be the first 105 characters of the first level message text.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRTWRAP</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output. If the message does not fit on one line, additional lines are printed to accommodate up to 2000 characters of the first level message text.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*PRTSECLVL</b></dt>
|
||
|
|
<dd>The output is printed with the job's spooled output. Both the first and second level text of the message are printed. Up to 2000 characters of first level text and 6000 characters of second level text will be printed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>When the output is printed, two or more lines are printed for each message. The last line contains the following information:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Qualified job name of the job that sent the message. This consists of the following three fields:
|
||
|
|
<ul>
|
||
|
|
<li>Job name
|
||
|
|
</li>
|
||
|
|
<li>User name
|
||
|
|
</li>
|
||
|
|
<li>Job number
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>The date and time the message was sent.
|
||
|
|
</li>
|
||
|
|
<li>The name of the user profile that the thread was running under when the message was sent.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPLOG.JOB"></a>
|
||
|
|
<h3>Jobs to display (JOB)</h3>
|
||
|
|
<p>Specifies the jobs (if any) for which messages in the log are shown. The messages for the specified jobs are shown only if they were logged in the period of time specified in this command.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>No job name is used to indicate which messages are shown.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>qualified-job-name</i></b></dt>
|
||
|
|
<dd>Specify the names of up to five jobs that are to have their logged messages shown. A job name can be qualified with up to three elements. For example:
|
||
|
|
<ul>
|
||
|
|
<li>job-name
|
||
|
|
</li>
|
||
|
|
<li>user-name/job-name
|
||
|
|
</li>
|
||
|
|
<li>job-number/user-name/job-name
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>If a job name is not qualified, all jobs by that name in the log will have their messages shown.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="DSPLOG.MSGID"></a>
|
||
|
|
<h3>Message identifier (MSGID)</h3>
|
||
|
|
<p>Specifies up to 100 message identifiers (if any) of the logged messages that are shown. These messages are shown only if they were logged in the period of time specified for the <b>Time period for log output (PERIOD)</b> parameter and in the jobs specified for the <b>Jobs to display (JOB)</b> parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*ALL</u></b></dt>
|
||
|
|
<dd>All logged messages, regardless of their identifiers, are shown if they meet the previous job and time specifications.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Other values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>message-identifier</i></b></dt>
|
||
|
|
<dd>Specify the identifiers of messages that are shown.
|
||
|
|
<p>To display specific generic types of messages, specify the 3-character code that identifies the message file followed by all zeros. For example, CPF0000 specifies that all CPF messages that meet the specifications of the previous parameters are shown. If an identifier is specified as pppnn00, any message beginning with the specified five characters (pppnn) can be shown. Refer to the description of the MSGID parameter in the Add Message Description (ADDMSGD) command for more information on message identifiers.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="DSPLOG.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Displaying Logged Messages for Current Date</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DSPLOG LOG(QHST)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command shows all the logged messages (and their associated data) that are available in the history log for the current date.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Displaying Logged Messages for September 1988</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
DSPLOG JOB(MYJOB) PERIOD((*AVAIL 090199) (*AVAIL 093099))
|
||
|
|
MSGID(CPF0000)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command displays all CPF messages, in the history log for MYJOB, that were logged during September 1999.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="DSPLOG.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2403</b></dt>
|
||
|
|
<dd>Message queue &1 in &2 not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2447</b></dt>
|
||
|
|
<dd>No entries exist in current version of log.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2478</b></dt>
|
||
|
|
<dd>Not authorized to requested version of log.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2480</b></dt>
|
||
|
|
<dd>Requested version of log damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2519</b></dt>
|
||
|
|
<dd>Error occurred while processing message ID list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2537</b></dt>
|
||
|
|
<dd>Too many records written to file &2 in &3.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9845</b></dt>
|
||
|
|
<dd>Error occurred while opening file &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9846</b></dt>
|
||
|
|
<dd>Error while processing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF9847</b></dt>
|
||
|
|
<dd>Error occurred while closing file &1 in library &2.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#DSPLOG.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|