256 lines
8.5 KiB
HTML
256 lines
8.5 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Change Save File (CHGSAVF)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CHGSAVF.Top_Of_Page"></a>
|
|
<h2>Change Save File (CHGSAVF)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CHGSAVF.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGSAVF.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGSAVF.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGSAVF"></a>
|
|
<p>The Change Save File (CHGSAVF) command changes the attributes of the specified save file. The changes become a permanent part of the file and are kept until the file is either changed or deleted.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have object operational (*OBJOPR) and object management (*OBJMGT) authorities to the save file.
|
|
</li>
|
|
<li>You must have read (*READ) authority for the library where the save file is located.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGSAVF.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGSAVF.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Save file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Save file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGSAVF.MAXRCDS"><b>MAXRCDS</b></a></td>
|
|
<td valign="top">Maximum records</td>
|
|
<td valign="top">1-2146762800, <b><u>*SAME</u></b>, *NOMAX</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSAVF.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSAVF.WAITFILE"><b>WAITFILE</b></a></td>
|
|
<td valign="top">Maximum file wait time</td>
|
|
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *IMMED, *CLS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGSAVF.SHARE"><b>SHARE</b></a></td>
|
|
<td valign="top">Share open data path</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGSAVF.FILE"></a>
|
|
<h3>Save file (FILE)</h3>
|
|
<p>Specifies the save file whose attributes are to be changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Save file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the save file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the thread is used to locate the save file. If no current library entry exists in the library list, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the save file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSAVF.MAXRCDS"></a>
|
|
<h3>Maximum records (MAXRCDS)</h3>
|
|
<p>Specifies the maximum number of records the save file can contain. The number of bytes of space in the save file is estimated at 8192 + (512 x the number of records in the save file). There is room for approximately two thousand 512-byte records in 1 megabyte of space. If you wanted to ensure that the save file would not exceed approximately 20 megabytes you would specify 40000 records (20 megabytes x 2000 records/megabyte).
|
|
</p>
|
|
<p>If the current number of records in the save file is greater than the maximum, an error message is sent and the save file does not change.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>The maximum amount of data that a save file can contain is approximately 1 terabyte. A message appears when the file is full.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The maximum number of records specified in the save file does not change.
|
|
</dd>
|
|
<dt><b>*NOMAX</b></dt>
|
|
<dd>The maximum value of 2146762800 records is used.
|
|
</dd>
|
|
<dt><b><i>1-2146762800</i></b></dt>
|
|
<dd>Specify the maximum number of records that the save file can contain.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSAVF.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The text (if any) does not change.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSAVF.WAITFILE"></a>
|
|
<h3>Maximum file wait time (WAITFILE)</h3>
|
|
<p>Specifies the number of seconds that the program waits for the file resources to be allocated when the file is opened. If the file resources cannot be allocated within the specified wait time, an error message is sent to the program.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The wait time does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>The program does not wait. Immediate allocation of file resources is required.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CLS</b></dt>
|
|
<dd>The job default wait time is used as the wait time for the file resources to be allocated.
|
|
</dd>
|
|
<dt><b><i>1-32767</i></b></dt>
|
|
<dd>Specify the number of seconds to wait for file resources to be allocated.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGSAVF.SHARE"></a>
|
|
<h3>Share open data path (SHARE)</h3>
|
|
<p>Specifies whether the open data path (ODP) is shared with other programs in the same routing step. When an ODP is shared, the programs accessing the file share facilities such as the file status and the buffer.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value specified in the save file does not change.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The ODP is not shared with other programs in the routing step. A new ODP for the file is created and used every time a program opens the file.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The same ODP is shared with each program in the job that also specifies *YES when it opens the file.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGSAVF.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: File Resources Allocated Immediately</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGSAVF FILE(ONLINE) WAITFILE(*IMMED)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the save file named ONLINE so that when it is opened the file resources must be available immediately, or an error message is sent. No other files are changed.
|
|
</p>
|
|
<p><b>Example 2: Changing Maximum Number of Records</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGSAVF FILE(ONLINE) MAXRCDS(20000)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the save file named ONLINE so that it can have up to 20,000 records (approximately 10 megabytes).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGSAVF.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF7304</b></dt>
|
|
<dd>File &1 in &2 not changed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGSAVF.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|