122 lines
6.0 KiB
HTML
122 lines
6.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="reference" />
|
||
|
|
<meta name="DC.Title" content="Record-level access" />
|
||
|
|
<meta name="abstract" content="" />
|
||
|
|
<meta name="description" content="" />
|
||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rla" />
|
||
|
|
<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>Record-level access</title>
|
||
|
|
</head>
|
||
|
|
<body id="rla"><a name="rla"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Record-level access</h1>
|
||
|
|
<div><p></p>
|
||
|
|
<div class="section"><p>The record-level access classes provide the ability to do the
|
||
|
|
following:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><ul><li>Create an iSeries™ physical
|
||
|
|
file specifying one of the following: <ul><li>The record length</li>
|
||
|
|
<li>An existing data description specifications (DDS) source file</li>
|
||
|
|
<li>A RecordFormat object</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Retrieve the record format from an iSeries physical or logical file, or
|
||
|
|
the record formats from an iSeries multiple format logical file. <div class="note"><span class="notetitle">Note:</span> The
|
||
|
|
record format of the file is not retrieved in its entirety. The record formats
|
||
|
|
retrieved are meant to be used when setting the record format for an AS400File
|
||
|
|
object. Only enough information is retrieved to describe the contents of
|
||
|
|
a record of the file. Record format information, such as column headings
|
||
|
|
and aliases, is not retrieved.</div>
|
||
|
|
</li>
|
||
|
|
<li>Access the records in an iSeries file sequentially, by record number, or
|
||
|
|
by key.</li>
|
||
|
|
<li>Write records to an iSeries file.</li>
|
||
|
|
<li>Update records in an iSeries file sequentially, by record number, or by
|
||
|
|
key.</li>
|
||
|
|
<li>Delete records in an iSeries file sequentially, by record number, or by
|
||
|
|
key.</li>
|
||
|
|
<li>Lock an iSeries file
|
||
|
|
for different types of access.</li>
|
||
|
|
<li>Use commitment control to allow a Java™ program to do the following: <ul><li>Start commitment control for the connection.</li>
|
||
|
|
<li>Specify different commitment control lock levels for different files.</li>
|
||
|
|
<li>Commit and rollback transactions.</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>Delete iSeries files.</li>
|
||
|
|
<li>Delete a member from an iSeries file.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><div class="note"><span class="notetitle">Note:</span> The record-level access classes do not support logical join
|
||
|
|
files or null key fields.</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The following classes perform these functions:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><ul><li>The <a href="rla400.htm#rla400">AS400File</a> class is the abstract
|
||
|
|
base class for the record-level access classes. It provides the methods for
|
||
|
|
sequential record access, creation and deletion of files and members, and
|
||
|
|
commitment control activities.</li>
|
||
|
|
<li>The <a href="rlakey.htm#rlakey">KeyedFile</a> class represents
|
||
|
|
an iSeries file
|
||
|
|
whose access is by key.</li>
|
||
|
|
<li>The <a href="rlaseq.htm#rlaseq">SequentialFile</a> class represents
|
||
|
|
an iSeries
|
||
|
|
file whose access is by record number.</li>
|
||
|
|
<li>The <a href="rla400fd.htm#rla400fd">AS400FileRecordDescription</a> class
|
||
|
|
provides the methods for retrieving the record format of an iSeries file.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The record-level access classes require an <a href="as400obj.htm#as400obj"> AS400</a>
|
||
|
|
object that represents the system that has the database files. Using the record-level
|
||
|
|
access classes causes the AS400 object to connect to the iSeries. See <a href="mngcon.htm#mngcon"> managing connections</a> for information about
|
||
|
|
managing connections.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The record-level access classes require the integrated file system
|
||
|
|
path name of the data base file. See <a href="ifspath.htm#ifspath"> integrated
|
||
|
|
file system path names</a> for more information.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>The record-level access classes use the following:</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><ul><li>The <a href="dtadrfmt.htm#dtadrfmt">RecordFormat</a> class to describe
|
||
|
|
a record of the database file</li>
|
||
|
|
<li>The <a href="dtadrec.htm#dtadrec">Record</a> class to provide access
|
||
|
|
to the records of the database file</li>
|
||
|
|
<li>The <a href="dtadldrw.htm#dtadldrw">LineDataRecordWriter</a> class
|
||
|
|
to write a record in line data format</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p>These classes are described in the <a href="dtad.htm#dtad">data
|
||
|
|
conversion</a> section.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><p><strong><span class="synph" id="rla__rlaexamples"><a name="rla__rlaexamples"><!-- --></a><span class="kwd"></span></span>Examples</strong></p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><ul><li>The <a href="rlsequentialaccexample.htm#rlsequentialaccexample">sequential
|
||
|
|
access example</a> shows how to access an iSeries file sequentially.</li>
|
||
|
|
<li>The <a href="rlreadfileexample.htm#rlreadfileexample">read file example</a> shows
|
||
|
|
how to use the record-level access classes to read an iSeries file.</li>
|
||
|
|
<li>The <a href="rlkeyedfileexample.htm#rlkeyedfileexample">keyed file
|
||
|
|
example</a> shows to to use the record-level access classes to read records
|
||
|
|
by key from an iSeries
|
||
|
|
file.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|