ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaiu_5.4.0.1/rzaiurzaiu401.htm

131 lines
7.1 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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="reference" />
<meta name="DC.Title" content="Entry header information" />
<meta name="DC.Relation" scheme="URI" content="rzaiurzaiu004.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="rzaiu401" />
<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>Entry header information</title>
</head>
<body id="rzaiu401"><a name="rzaiu401"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Entry header information</h1>
<div><div class="section"><p>When a Save (SAV) command or the Restore (RST) command
is run, the output can be directed to a stream file or user area. The content
of the output is divided into entries. Each entry in the output has an associated
header. This header contains data that specifies the length of the entry and
the type of the entry. Each type of entry has its own format. This header
information allows the content of the output to be divided into entries that
have specific formats. This enables the data in the output to be parsed. </p>
<p>No
count of the entries is kept, instead, the end of an entry is determined by <em>entry
length</em>. An entry may contain variable length elements. This may result
in the entry being padded. </p>
<p>The number of entries in the output is variable.
Entries will appear one after the other until a trailer entry is reached.
The trailer entry is the last entry in the output.</p>
<p>For each field in
the header, an offset is specified in bytes. This offset is relative to the
base address of the header, or the beginning of the first field in the header.</p>
<p>The
table below shows the format for the header information as it is output by
the SAV or RST commands.</p>
<div class="tablenoborder"><a name="rzaiu401__hdrfmt"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaiu401__hdrfmt" class="singleborder" frame="border" border="1" rules="rows"><caption>Table 1. Entry header information outputSAV and RST commands</caption><thead align="left"><tr class="tablemainheaderbar"><th colspan="2" align="center" valign="bottom" id="d0e35">Offset
(bytes)</th>
<th rowspan="2" align="center" valign="bottom" width="14.157973174366617%" id="d0e37">Type (in bytes)</th>
<th rowspan="2" align="center" valign="bottom" width="17.436661698956783%" id="d0e39">Set by<sup>1</sup></th>
<th rowspan="2" align="left" valign="bottom" width="49.18032786885246%" id="d0e43">Field</th>
</tr>
<tr class="tablemainheaderbar"><th valign="bottom" width="9.612518628912072%" id="d0e46">Decimal</th>
<th valign="top" width="9.612518628912072%" id="d0e48">Hex</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="9.612518628912072%" headers="d0e35 d0e46 ">0</td>
<td align="left" valign="top" width="9.612518628912072%" headers="d0e35 d0e48 ">0</td>
<td align="left" valign="top" width="14.157973174366617%" headers="d0e37 ">BINARY(4)</td>
<td align="center" valign="top" width="17.436661698956783%" headers="d0e39 ">S/R</td>
<td align="left" valign="top" width="49.18032786885246%" headers="d0e43 "><a href="rzaiurzaiu406.htm#rzaiu406__rzaiu424">Entry
type</a> </td>
</tr>
<tr><td align="left" valign="top" width="9.612518628912072%" headers="d0e35 d0e46 ">4</td>
<td align="left" valign="top" width="9.612518628912072%" headers="d0e35 d0e48 ">4</td>
<td align="left" valign="top" width="14.157973174366617%" headers="d0e37 ">BINARY(4)</td>
<td align="center" valign="top" width="17.436661698956783%" headers="d0e39 ">S/R</td>
<td align="left" valign="top" width="49.18032786885246%" headers="d0e43 "><a href="rzaiurzaiu406.htm#rzaiu406__rzaiu423">Entry
length</a> </td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="1" rules="all"><tbody><tr><td align="center" valign="top" width="9.208103130755065%">Note:</td>
<td valign="top" width="9.392265193370166%">&nbsp;</td>
<td valign="top" width="14.3646408839779%">&nbsp;</td>
<td valign="top" width="17.863720073664823%">&nbsp;</td>
<td valign="top" width="49.171270718232044%">&nbsp;</td>
</tr>
<tr><td align="center" valign="top" width="9.208103130755065%">1.</td>
<td colspan="4" valign="top"> <p><span class="uicontrol">Set
by column.</span> The following column values indicate which operations
write the content of the field into the output:</p>
</td>
</tr>
<tr><td valign="top" width="9.208103130755065%">&nbsp;</td>
<td valign="top" width="9.392265193370166%">&nbsp;</td>
<td align="center" valign="top" width="14.3646408839779%"><span class="uicontrol">Value</span></td>
<td colspan="2" valign="top"><span class="uicontrol">Condition</span></td>
</tr>
<tr><td valign="top" width="9.208103130755065%">&nbsp;</td>
<td valign="top" width="9.392265193370166%">&nbsp;</td>
<td align="center" valign="top" width="14.3646408839779%">S</td>
<td colspan="2" valign="top">Save operation
set this field.</td>
</tr>
<tr><td valign="top" width="9.208103130755065%">&nbsp;</td>
<td valign="top" width="9.392265193370166%">&nbsp;</td>
<td align="center" valign="top" width="14.3646408839779%">R</td>
<td colspan="2" valign="top">Restore operation
set this field.</td>
</tr>
<tr><td valign="top" width="9.208103130755065%">&nbsp;</td>
<td valign="top" width="9.392265193370166%">&nbsp;</td>
<td align="center" valign="top" width="14.3646408839779%">S/R</td>
<td colspan="2" valign="top">Either operation
set this field.</td>
</tr>
<tr><td valign="top" width="9.208103130755065%">&nbsp;</td>
<td valign="top" width="9.392265193370166%">&nbsp;</td>
<td align="center" valign="top" width="14.3646408839779%">(blank)</td>
<td colspan="2" valign="top">Not set by either
operation. The associated field is set to zero for numeric fields, blank for
character fields, or empty for variable-length character fields. </td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiurzaiu004.htm">Interpret output from save (SAV) and restore (RST)</a></div>
</div>
</div>
</body>
</html>