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

75 lines
4.0 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="I/O operations on a save file" />
<meta name="DC.Relation" scheme="URI" content="rzaiusavefiles.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="sfoperations" />
<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>I/O operations on a save file</title>
</head>
<body id="sfoperations"><a name="sfoperations"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">I/O operations on a save file</h1>
<div><p>The following considerations apply to input and output operations on a
save file: </p>
<ul><li>Records are always read and written sequentially. The records read from
a save file contain sequence and parity information that is validated when
the records are written into another save file. This information ensures that
the records are processed in sequence and have not been changed. <p>You cannot
write a record that has changed since it was retrieved from another save file.
You cannot write a record that is not the next record in sequence. If you
attempt either of these, an escape message is sent to report the error.</p>
</li>
<li>A read of records from the save file can be done only if the entire file
has been written.</li>
<li>The force-end-of-data (FEOD) function is valid for both input and output.
<p>For an input file, FEOD signals end-of-file to the program that does the
operation.</p>
<p>To ensure buffered output records are not lost after an
FEOD operation completes, they are written to the file. For an output file,
buffered output records are not lost even if the job or system fails.</p>
</li>
</ul>
<div class="section"><h4 class="sectiontitle">File-dependent attributes for a save file</h4><ul><li>The following file-dependent attributes apply when the save file is open:
<ul><li>For input operations, the first record returned for a read operation is
the one specified by the parameter POSITION when the file is opened. After
the first record is read, all remaining records are returned sequentially
to the end of the file.</li>
<li>For output operations, new records can be added to the end of records
already in the file (specified using the EXTEND parameter). Each save file
record contains sequencing information used by the system to ensure that a
record is not skipped or written more than once.</li>
<li>If no record length is specified in the high-level language program that
opens the file, a length of 528 bytes is assumed. If the program specifies
a record length value, it must be 528 bytes.</li>
</ul>
</li>
<li>No file-dependent parameters (such as format name) can be specified for
read or write operations with a save file. Any file-dependent parameters specified
are ignored.</li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiusavefiles.htm">Save files</a></div>
</div>
</div>
</body>
</html>