98 lines
5.9 KiB
HTML
98 lines
5.9 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="Disable held optical file support" />
|
|
<meta name="abstract" content="i5/OS is shipped with held optical file support enabled. If desired, you may disable it by using the Change Optical Attributes (CHGOPTA) command." />
|
|
<meta name="description" content="i5/OS is shipped with held optical file support enabled. If desired, you may disable it by using the Change Optical Attributes (CHGOPTA) command." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzam4heldoptfiles.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="rzam4disablhldoptsupt" />
|
|
<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>Disable held optical file support</title>
|
|
</head>
|
|
<body id="rzam4disablhldoptsupt"><a name="rzam4disablhldoptsupt"><!-- --></a>
|
|
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Disable held optical file support</h1>
|
|
<div><p>i5/OS™ is
|
|
shipped with held optical file support enabled. If desired, you may disable
|
|
it by using the Change Optical Attributes (CHGOPTA) command.</p>
|
|
<p> When held optical file support is disabled, a held file is not created
|
|
when a file fails to be archived to optical disk. When using this option,
|
|
it is up to the user application to manage recovery procedures for files that
|
|
fail to be archived. Consider the following scenarios:</p>
|
|
<p><strong>Scenario 1</strong></p>
|
|
<p>The application opens an optical file for a write operation, and then writes
|
|
data to the file. When you attempt to close the file, it fails because the
|
|
optical disk is full.</p>
|
|
<dl><dt class="dlterm">Held file support enabled</dt>
|
|
<dd>The file is still open, but becomes held. The file closes when the job
|
|
ends if it never closes successfully before the job ends. The file will remain
|
|
held until it is released. </dd>
|
|
</dl>
|
|
<dl><dt class="dlterm">Held file support disabled</dt>
|
|
<dd>The file is still open, but is not held. The file closes when the job
|
|
ends if it never closed successfully before the job ends. The file will not
|
|
become held, and all resources (virtual optical file) associated with the
|
|
held file will then be freed up.</dd>
|
|
</dl>
|
|
<p><strong>Scenario 2</strong></p>
|
|
<p>The application opens an optical file for write, and then writes data to
|
|
the file. The application then issues a Force Buffered Data API to ensure
|
|
the data is safe on nonvolatile storage. The iSeries™ server then loses power.</p>
|
|
<dl><dt class="dlterm">Held File Support Enabled </dt>
|
|
<dd>After the internal program load (IPL) of the iSeries server is completed the file
|
|
exists as a held optical file. All data that was successfully forced to disk
|
|
is recoverable. In other words, when you save the held file to optical storage,
|
|
all data written before the Force buffered data request will be saved.</dd>
|
|
</dl>
|
|
<dl><dt class="dlterm">Held File Support Disabled</dt>
|
|
<dd>After the IPL of the iSeries server is completed, the file does not exist
|
|
as a held optical file. All data written to this file on the previous open
|
|
instance is lost. The force data request had no effect.</dd>
|
|
</dl>
|
|
<p>It is important to note that when held optical file support is disabled,
|
|
forcing data to nonvolatile storage is meaningless. This is because data is
|
|
written to optical storage after the file closes successfully. The Force buffered
|
|
data function will force the data to the i5/OS disk, and you can use the held optical
|
|
file to recover the data after a power loss. Held files are the only mechanism
|
|
to recover data forced to nonvolatile storage after a power loss or other
|
|
unexpected error. Held file support is needed to recover any data from an
|
|
open instance that closes unsuccessfully. This effects the following application
|
|
program interfaces.</p>
|
|
<ul><li>Force Buffered Data HFS API (QHFFRCSF)<p>This API is allowed when held
|
|
file support is disabled but it will have no effect.</p>
|
|
</li>
|
|
<li>Synchronize File Changes IFS API fsync() <p>This API is allowed when held
|
|
file support is disabled but it will have no effect.</p>
|
|
</li>
|
|
<li>Synchronous write-through flag on Open Stream File HFS API (QHFOPNSF)<p>This
|
|
value is allowed, but will be treated as an asynchronous write-through flag.</p>
|
|
</li>
|
|
</ul>
|
|
<p>Use the CHGOPTA CL command to enable, disable or determine the current
|
|
status of held optical file support. After held optical file support is disabled,
|
|
it remains disabled for all optical users. You must enable held file support
|
|
for it to become active again.</p>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzam4heldoptfiles.htm" title="If the optical file system is unable to update the optical disk during a close function, the operation fails and the file is marked as held.">Held optical files</a></div>
|
|
</div>
|
|
</div>
|
|
<img src="./deltaend.gif" alt="End of change" /></body>
|
|
</html> |