120 lines
7.3 KiB
HTML
120 lines
7.3 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="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> |