ibm-information-center/dist/eclipse/plugins/i5OS.ic.dbp_5.4.0.1/rbafoocons.htm

105 lines
7.6 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="Open considerations for sequential-only processing" />
<meta name="abstract" content="The considerations apply for opening files when sequential-only processing is specified. If the system determines that sequential-only processing is not allowed, a message is sent to the program to indicate that the request for sequential-only processing is not being accepted; however, the file is still opened for processing." />
<meta name="description" content="The considerations apply for opening files when sequential-only processing is specified. If the system determines that sequential-only processing is not allowed, a message is sent to the program to indicate that the request for sequential-only processing is not being accepted; however, the file is still opened for processing." />
<meta name="DC.subject" content="opening, database file, sequential-only processing, sequential-only processing, open considerations" />
<meta name="keywords" content="opening, database file, sequential-only processing, sequential-only processing, open considerations" />
<meta name="DC.Relation" scheme="URI" content="rbafoseqop.htm" />
<meta name="DC.Relation" scheme="URI" content="rbafoopnqf.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="rbafoocons" />
<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>Open considerations for sequential-only processing</title>
</head>
<body id="rbafoocons"><a name="rbafoocons"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Open considerations for sequential-only processing</h1>
<div><p>The considerations apply for opening files when sequential-only
processing is specified. If the system determines that sequential-only processing
is not allowed, a message is sent to the program to indicate that the request
for sequential-only processing is not being accepted; however, the file is
still opened for processing. </p>
<div class="p"> <ul><li>If the program opened the member for output only, and if SEQONLY(*YES)
was specified (number of records was not specified) and either the opened
member is a logical member, a uniquely keyed physical member, or there are
other access paths to the physical member, SEQONLY(*YES) is changed to SEQONLY(*NO)
so the program can handle possible errors (for example, duplicate keys, conversion
mapping, and select/omit errors) at the time of the output operation. If you
want the system to run sequential-only processing, change the SEQONLY parameter
to include both the *YES value and number of records specification.</li>
<li>Sequential-only processing can be specified only for input-only (read)
or output-only (add) operations. If the program specifies update or delete
operations, sequential-only processing is not allowed by the system.</li>
<li>If a file is being opened for output, it must be a physical file or a
logical file based on one physical file member.</li>
<li>Sequential-only processing can be specified with commitment control only
if the member is opened for output-only.</li>
<li>If sequential-only processing is being used for files opened with commitment
control and a rollback operation is performed for the job, the records that are
in the job's storage area during the rollback operation are not written to
the system storage area and never appear in the journal for the commitment
control transaction. If no records were ever written to the system storage
area prior to a rollback operation being performed for a particular commitment
control transaction, the entire commitment control transaction is not reflected
in the journal.</li>
<li>For output-only, the number of records specified to be moved as a unit
and the force ratio are compared and automatically adjusted as necessary.
If the number of records is larger than the force ratio, the number of records
is reduced to equal the force ratio. If the opposite is true, the force ratio
is reduced to equal the number of records.</li>
<li>If the program opened the member for output only, and if SEQONLY(*YES)
was specified (number of records was not specified), and duplicate or insert
key feedback has been requested, SEQONLY(*YES) will be changed to SEQONLY(*NO)
to provide the feedback on a record-by-record basis when the records are inserted
into the file.</li>
<li>The number of records in a block will be changed to one if all of the
following conditions are true: <ul><li>The member was opened for output-only processing.</li>
<li>No override operations are in effect that have specified sequential-only
processing.</li>
<li>The file being opened is a file that cannot be extended because its increment
number of records was set to zero.</li>
<li>The number of bytes available in the file is less than the number of bytes
that fit into a block of records.</li>
</ul>
</li>
</ul>
</div>
<div class="p">The following considerations apply when sequential-only processing is not
specified and the file is opened using the Open Query File (OPNQRYF) command.
If these conditions are satisfied, a message is sent to indicate that sequential-only
processing will be performed and the query file is opened. <ul><li>If the OPNQRYF command specifies the name of one or more fields on the
group field (GRPFLD) parameter, or OPNQRYF requires group processing.</li>
<li>If the OPNQRYF command specifies one or more fields, or *ALL on the UNIQUEKEY
parameter.</li>
<li>If a view is used with the DISTINCT option on the SQL SELECT statement,
then SEQONLY(*YES) processing is automatically performed.</li>
</ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbafoseqop.htm" title="If your program processes a database file sequentially for input only or output only, you might be able to improve performance using the sequential-only processing (SEQONLY) parameter on the Override with Database File (OVRDBF) or the Open Database File (OPNDBF) command.">Sequential-only processing of database files</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbafoopnqf.htm" title="The Open Query File (OPNQRYF) command is a control language (CL) command that allows you to perform many data processing functions on database files. These topics discuss how to create a query using the OPNQRYF command, how to specify parameters for its major functions, and how to use it with your high-level language program.">Use Open Query File (OPNQRYF) command</a></div>
</div>
</div>
</body>
</html>