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

120 lines
7.3 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="Free storage when saving" />
<meta name="abstract" content="Free storage when saving explains how to use the STG parameter to remove an object from your server after you save it. This only works with a limited number of commands." />
<meta name="description" content="Free storage when saving explains how to use the STG parameter to remove an object from your server after you save it. This only works with a limited number of commands." />
<meta name="DC.Relation" scheme="URI" content="rzaiurzaiu290.htm" />
<meta name="DC.Relation" scheme="URI" content="../apis/qsavstgf.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="rzaiu108" />
<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>Free storage when saving</title>
</head>
<body id="rzaiu108"><a name="rzaiu108"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Free storage when saving</h1>
<div><p>Free storage when saving explains how to use the STG parameter
to remove an object from your server after you save it. This only works with
a limited number of commands.</p>
<p>Normally, saving an object does not remove it from the server. However,
you can use the storage (STG) parameter on some save commands to free some
of the storage that is used by saved objects.</p>
<p>If you specify STG(*FREE), the object description and search values remain
on the server. The server deletes the contents of the object. You can perform
operations such as moving and renaming an object whose storage you freed.
However, you must restore the object to use it.</p>
<p>You can use the STG(*FREE) parameter for the object types in the following
table:</p>
<div class="tablenoborder"><a name="rzaiu108__frstgt"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaiu108__frstgt" width="100%" frame="hsides" border="0" rules="none"><caption>Table 1. Object types that
support freeing storage</caption><thead align="left"><tr><th align="left" valign="bottom" width="50.173611111111114%" id="d0e29">Object Type</th>
<th align="left" valign="bottom" width="49.82638888888889%" id="d0e31">Description</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 "><img src="./delta.gif" alt="Start of change" />*FILE<sup>1,2</sup><img src="./deltaend.gif" alt="End of change" /></td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Database files</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*STMF<sup>3</sup></td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Stream files</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*JRNRCV<sup>4</sup></td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Journal receivers</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*PGM<sup>5</sup></td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Programs</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*DOC</td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Documents</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*SQLPKG</td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">SQL packages</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*SRVPGM</td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Service programs</td>
</tr>
<tr><td align="left" valign="top" width="50.173611111111114%" headers="d0e29 ">*MODULE</td>
<td align="left" valign="top" width="49.82638888888889%" headers="d0e31 ">Modules</td>
</tr>
<tr><td colspan="2" align="left" valign="top" headers="d0e29 d0e31 "> <dl><dt class="dlterm"><sup>1</sup></dt>
<dd>When you free a database file, the server frees the storage that is occupied
by the data portion of the object, but the object description remains on the
server. If you save a database file that has already been freed and free its
storage, the server does not save the object description and you receive the
following message: <pre>CPF3243 Member xxx already saved with storage freed</pre>
If
you install the Media and Storage Extensions product on your server, and you
save a database file and free its storage, the server saves the object description.</dd>
<dt class="dlterm"><sup>2</sup></dt>
<dd>The server does not free the storage occupied by logical file access paths.</dd>
<dt class="dlterm"><sup>3</sup></dt>
<dd>You can free storage for *STMF objects, but not during a save operation.
Free the storage for *STMF objects with the Save Storage Free "Qp0lSaveStgFree()
API". <p>You can save an *STMF object whose storage has already been freed,
but you must restore the *STMF object before you can use it.</p>
</dd>
<dt class="dlterm"><sup>4</sup></dt>
<dd>You can free storage for a journal receiver if it is detached and all
previous journal receivers are deleted or have their storage freed.</dd>
<dt class="dlterm"><sup>5</sup></dt>
<dd>Do not specify STG(*FREE) for a program that is running. This causes the
program to end abnormally. For Integrated Language
Environment<sup>®</sup> (ILE) programs, the program does not end abnormally. The
server sends a message that indicates that the server did not save the ILE
program.</dd>
</dl>
</td>
</tr>
</tbody>
</table>
</div>
<p>You can also specify STG(*DELETE) on the Save Document Library Object (SAVDLO)
command. This deletes any filed documents after the server saves them. This
includes the object description, the document description, the search values,
and the document contents.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiurzaiu290.htm" title="Read this information before you save anything on your server.">Before you save anything...</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../apis/qsavstgf.htm">Qp0lSaveStgFree()</a></div>
</div>
</div>
</body>
</html>