ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/dltovr.htm

157 lines
6.8 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Delete Override (DLTOVR)</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="DLTOVR.Top_Of_Page"></a>
<h2>Delete Override (DLTOVR)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>Conditional
</td>
<td valign="top" align="right">
<a href="#DLTOVR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DLTOVR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DLTOVR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DLTOVR"></a>
<p>The Delete Override (DLTOVR) command deletes one or more file overrides (including message file overrides) that were previously specified in a call level. For each overridden file named in the DLTOVR command, the override specified in the same call level as the DLTOVR command is deleted. When the command is specified interactively or outside a program in a batch job, the file overrides for the call level are deleted; when the command is used in a CL program, the file overrides for that program call level are deleted. A file override is the result of an override file command.
</p>
<p>The DLTOVR command can delete all the file overrides for all the files in the same call level or the file overrides for specified files in the same call level. Only the file overrides in the call level in which the command is specified are deleted. For example, if an override command is specified in one program in a routing step, and then another program is called that also contains override commands, a DLTOVR command specified in the second program can delete only overrides that occur in that program. The DLTOVR command has no effect on the override command that was specified before the program was called. The deleted file overrides have no effect on subsequent uses of the file.
</p>
<p><b>Restrictions:</b>
</p>
<ul>
<li>In a multithreaded job, this command may only be issued from the initial thread.
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DLTOVR.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"><a href="#DLTOVR.FILE"><b>FILE</b></a></td>
<td valign="top">Overridden file</td>
<td valign="top">Single values: *ALL<br>Other values (up to 50 repetitions): <i>Name</i>, *PRTF</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DLTOVR.LVL"><b>LVL</b></a></td>
<td valign="top">Call level</td>
<td valign="top"><b><u>*ACTGRPDFN</u></b>, *, *JOB</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#DLTOVR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DLTOVR.FILE"></a>
<h3>Overridden file (FILE)</h3>
<p>Specifies the names of the overridden files in the call level whose file overrides are deleted.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All the file overrides that exist in the call level where this command is entered are deleted.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<dl>
<dt><b>*PRTF</b></dt>
<dd>The *PRTF file override exists in the call level where this command is entered is deleted.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the names of one or more overridden files for which the overrides in the call level are deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTOVR.LVL"></a>
<h3>Call level (LVL)</h3>
<p>Specifies the call level of the file overrides deleted. There is a one-to-one correspondence between the call stack entries shown on the call stack from the Work with Job (WRKJOB) command and the call level for that call stack entry.
</p>
<p>The first call stack entry name on the call stack (at the top of the list) is the call program or procedure at call level one. The second call stack entry name is the program or procedure at call level two. The last call stack entry name is the program or procedure at the highest call level for the job.
</p>
<dl>
<dt><b><u>*ACTGRPDFN</u></b></dt>
<dd>The call level of the file overrides to be deleted is determined by the activation group of the program that calls this command. When the activation group is the default activation group, the call level of the overrides to be deleted equals the call level of the calling program. When the activation group is not the default activation group, the call level of the overrides to be deleted equals the activation group of the calling program.
</dd>
<dt><b>*</b></dt>
<dd>The call level of the file overrides to be deleted is the call level of the program that called the DLTOVR command processing program. If the DLTOVR command is called through QCMDEXC, the call level is the same level as that of the caller of QCMDEXC.
</dd>
<dt><b>*JOB</b></dt>
<dd>The file overrides scoped to the job are deleted. Only overrides at the job level with OVRSCOPE(*JOB) are deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTOVR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Deleting Call Level Overrides</b>
</p>
<ol>
<li>OVRDBF FILE(A) TOFILE(B)
</li>
<li>OVRPRTF FILE(C) TOFILE(D)
</li>
<li>OVRTAPF FILE(E) TOFILE(F)
<p>:
</p>
</li>
<li>DLTOVR FILE(A C)
</li>
<li>DLTOVR FILE(*ALL)
</li>
</ol>
<p>If the first three override commands had been specified earlier in the call level, the files B, D, and F would override files A, C, and E. The fourth command deletes only the file overrides that affect files A and C. The last command deletes all the file overrides that exist in the call level, which in this case is the command overriding file E, the third command.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTOVR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF180C</b></dt>
<dd>Function &amp;1 not allowed.
</dd>
<dt><b>CPF9841</b></dt>
<dd>Override not found at specified level.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>