205 lines
12 KiB
HTML
205 lines
12 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="Format of the history log" />
|
||
<meta name="abstract" content="A database file is used to store the messages sent to a log message queue on the system. Because all records in a physical file have the same length and messages sent to a log have different lengths, the messages can span more than one record." />
|
||
<meta name="description" content="A database file is used to store the messages sent to a log message queue on the system. Because all records in a physical file have the same length and messages sent to a log have different lengths, the messages can span more than one record." />
|
||
<meta name="DC.subject" content="history log (QHST), format, QHST (history log) message queue, QHST (history log), message queue, history log (QHST), format table" />
|
||
<meta name="keywords" content="history log (QHST), format, QHST (history log) message queue, QHST (history log), message queue, history log (QHST), format table" />
|
||
<meta name="DC.Relation" scheme="URI" content="systl.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="dsvam.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="hlformat" />
|
||
<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>Format of the history log</title>
|
||
</head>
|
||
<body id="hlformat"><a name="hlformat"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">Format of the history log</h1>
|
||
<div><p>A database file is used to store the messages sent to a log message
|
||
queue on the system. Because all records in a physical file have the same
|
||
length and messages sent to a log have different lengths, the messages can
|
||
span more than one record. </p>
|
||
<p> Each record for a message has three fields: </p>
|
||
<ul><li>System date and time (a character field of length 8). This is an internal
|
||
field. The converted date and time also are in the message.</li>
|
||
<li>Record number (a 2-byte field). For example, the field contains hex <samp class="codeph">0001</samp> for
|
||
the first record, hex <samp class="codeph">0002</samp> for the second record, and so
|
||
on.</li>
|
||
<li>Data (a character field of length 132).</li>
|
||
</ul>
|
||
<p>The third field (data) of the first record has the following format:</p>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="bottom" width="25%" id="d0e59">Contents</th>
|
||
<th align="left" valign="bottom" width="25%" id="d0e61">Type</th>
|
||
<th align="left" valign="bottom" width="25%" id="d0e63">Length</th>
|
||
<th align="left" valign="bottom" width="25%" id="d0e65">Positions in Record</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr><td align="left" valign="top" width="25%" headers="d0e59 ">Job name</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">26</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">11-36</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Converted date and time<sup>1</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">13</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">37-49</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Message ID</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">7</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">50-56</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Message file name</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">10</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">57-66</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Library name</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">10</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">67-76</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Message type<sup>2</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">2</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">77-78</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Severity code</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">2</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">79-80</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Sending program name<sup>3</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">12</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">81-92</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Sending program instruction number<sup>4</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">4</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">93-96</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Receiving program name<sup>3</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">10</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">97-106</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Receiving program instruction number<sup>4</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">4</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">107-110</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Message text length</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Binary</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">2</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">111-112</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Message data length</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Binary</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">2</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">113-114</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Coded character set identifier (CCSID) for
|
||
text or data<sup>5</sup></td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Binary</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">4</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">115-118</td>
|
||
</tr>
|
||
<tr><td valign="top" width="25%" headers="d0e59 ">Sending user profile</td>
|
||
<td valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td valign="top" width="25%" headers="d0e63 ">10</td>
|
||
<td valign="top" width="25%" headers="d0e65 ">119–128</td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="25%" headers="d0e59 ">Reserved</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e61 ">Character</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e63 ">14</td>
|
||
<td align="left" valign="top" width="25%" headers="d0e65 ">129-142</td>
|
||
</tr>
|
||
<tr><td colspan="4" align="left" valign="top" headers="d0e59 d0e61 d0e63 d0e65 "><div class="note"><span class="notetitle">:</span> <dl><dt class="dlterm"><sup>1</sup></dt>
|
||
<dd>The format is: <samp class="codeph">cyymmddhhmmss</samp> <p>where: </p>
|
||
<dl><dt class="dlterm"><samp class="codeph">c</samp></dt>
|
||
<dd>Is the century digit (c=0 if yy ≥ 40, c = 1 if yy < 40)</dd>
|
||
<dt class="dlterm"><samp class="codeph">yymmdd</samp></dt>
|
||
<dd>Is the year, month, and day that the message is sent</dd>
|
||
<dt class="dlterm"><samp class="codeph">hhmmss</samp></dt>
|
||
<dd>Is the hour, minute, and second that the message is sent</dd>
|
||
</dl>
|
||
</dd>
|
||
<dt class="dlterm"><sup>2</sup></dt>
|
||
<dd>This has the same value as the RTNTYPE parameter on the <span class="cmdname">Receive
|
||
Message (RCVMSG)</span> command.</dd>
|
||
<dt class="dlterm"><sup>3</sup></dt>
|
||
<dd>If the sender or receiver is an ILE procedure, the entry in the history
|
||
log contains only the ILE program name. The module name and procedure name
|
||
are not included in the history log.</dd>
|
||
<dt class="dlterm"><sup>4</sup></dt>
|
||
<dd>If the sender or receiver is an ILE procedure, the sending or receiving
|
||
instruction number is 0.</dd>
|
||
<dt class="dlterm"><sup>5</sup></dt>
|
||
<dd>This CCSID applies only to the message data that is defined as *CCHAR
|
||
data if the message is a stored message. The rest of the message data can
|
||
be considered 65 535. Otherwise, this is the CCSID of the immediate message.</dd>
|
||
</dl>
|
||
</div>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<p>The third field (data) of the remaining records has the following format:</p>
|
||
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="all"><thead align="left"><tr><th align="left" valign="bottom" width="33.33333333333333%" id="d0e297">Contents</th>
|
||
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e299">Type</th>
|
||
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e301">Length</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e297 ">Message</td>
|
||
<td align="left" valign="top" width="33.33333333333333%" headers="d0e299 ">Character</td>
|
||
<td align="left" valign="top" width="33.33333333333333%" headers="d0e301 ">Variable<sup>1</sup></td>
|
||
</tr>
|
||
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e297 ">Message data</td>
|
||
<td align="left" valign="top" width="33.33333333333333%" headers="d0e299 ">Character</td>
|
||
<td align="left" valign="top" width="33.33333333333333%" headers="d0e301 ">Variable<sup>2</sup></td>
|
||
</tr>
|
||
<tr><td colspan="3" align="left" valign="top" headers="d0e297 d0e299 d0e301 "><div class="note"><span class="notetitle">:</span> <dl><dt class="dlterm"><sup>1</sup></dt>
|
||
<dd>This length is specified in the first record (positions 111 and 112) and
|
||
cannot exceed 132.</dd>
|
||
<dt class="dlterm"><sup>2</sup></dt>
|
||
<dd>This length is specified in the first record (positions 113 and 114).</dd>
|
||
</dl>
|
||
</div>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<p>A message is never split when a new version of a log is started. The first
|
||
and last records of a message are always in the same QHST log version file.</p>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="systl.htm" title="The history log (QHST) consists of a message queue and a physical file known as a log-version.">QHST history log</a></div>
|
||
</div>
|
||
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
<div><a href="dsvam.htm" title="On the FMT parameter on the Add Message Description (ADDMSGD) command, you can specify substitution variables for either first- or second-level messages.">Define substitution variables</a></div>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html> |