94 lines
6.1 KiB
HTML
94 lines
6.1 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="Close a database file" />
|
||
|
|
<meta name="abstract" content="When your program completes processing a database file member, it should close the file. Closing a database file disconnects your program from the file." />
|
||
|
|
<meta name="description" content="When your program completes processing a database file member, it should close the file. Closing a database file disconnects your program from the file." />
|
||
|
|
<meta name="DC.subject" content="database file, closing, methods, file, database" />
|
||
|
|
<meta name="keywords" content="database file, closing, methods, file, database" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbafoprocess.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rbafosfile.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/clof.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rclrsc.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="../books/sc415606.pdf" />
|
||
|
|
<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="rbafotermpr" />
|
||
|
|
<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>Close a database file</title>
|
||
|
|
</head>
|
||
|
|
<body id="rbafotermpr"><a name="rbafotermpr"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Close a database file</h1>
|
||
|
|
<div><p>When your program completes processing a database file member,
|
||
|
|
it should close the file. Closing a database file disconnects your program
|
||
|
|
from the file.</p>
|
||
|
|
<p>The close operation releases all record locks and all file member locks,
|
||
|
|
forces all changes made through the open data path (ODP) to auxiliary storage,
|
||
|
|
then destroys the ODP. (When a shared file is closed but the ODP remains open,
|
||
|
|
the functions differ) </p>
|
||
|
|
<div class="p">To
|
||
|
|
close a database file in a program, use one of the following methods: <ul><li class="liexpand">High-level language close statements <p>Most high-level languages allow
|
||
|
|
you to specify that you want to close your database files. For more information
|
||
|
|
about how to close a database file in a high-level language program, see your
|
||
|
|
high-level language topic collection.</p>
|
||
|
|
</li>
|
||
|
|
<li class="liexpand">Close File (CLOF) command <p>You can use the CLOF command to close database
|
||
|
|
files that were opened using either the Open Database File (OPNDBF) or Open
|
||
|
|
Query File (OPNQRYF) command. </p>
|
||
|
|
</li>
|
||
|
|
<li class="liexpand">Reclaim Resources (RCLRSC) command <p>The RCLRSC command releases all
|
||
|
|
locks (except, under commitment control, locks on records that were changed
|
||
|
|
but not yet committed), forces all changes to auxiliary storage, then destroys
|
||
|
|
the ODP for that file. You can use the RCLRSC command to allow a calling program
|
||
|
|
to close the files of a called program. (For example, if the called program
|
||
|
|
returns to the calling program without closing its files, the calling program
|
||
|
|
can then close the files of the called program.) However, the normal way of
|
||
|
|
closing files in a program is with the high-level language close operation
|
||
|
|
or through the CLOF command. For more information about resource reclamation
|
||
|
|
in the integrated language environment, see the ILE Concepts book.</p>
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>If a job ends normally (for example, a user signs off) and all the files
|
||
|
|
associated with that job were not closed, the system automatically closes
|
||
|
|
all the remaining open files associated with that job, forces all changes
|
||
|
|
to auxiliary storage, and releases all record locks for those files. If a
|
||
|
|
job ends abnormally, the system also closes all files associated with that
|
||
|
|
job, releases all record locks for those files, and forces all changes to
|
||
|
|
auxiliary storage.</p>
|
||
|
|
<p>When a process is trying to lock a file that is held by another process,
|
||
|
|
the Close database file exit program is called. This exit is called in the
|
||
|
|
process that is holding the lock.</p>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbafoprocess.htm" title="These topics discuss how to make your database files process more efficiently on the i5/OS operating system, how to open, manipulate, and close database files, and how to monitor and manage error messages related to your database files.">Process database files</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rbafosfile.htm" title="By default, the database management system lets one file be read and changed by many users at the same time. However, you can share the database files in the same job or activation group through the SHARE parameter.">Share database files in the same job or activation group</a></div>
|
||
|
|
<div><a href="../rbam6/rbam6clmain.htm">Control language (CL)</a></div>
|
||
|
|
<div><a href="../books/sc415606.pdf" target="_blank">ILE Concepts PDF</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relref"><strong>Related reference</strong><br />
|
||
|
|
<div><a href="../cl/clof.htm">Close File (CLOF) command</a></div>
|
||
|
|
<div><a href="../cl/rclrsc.htm">Reclaim Resources (RCLRSC) command</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|