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

153 lines
7.2 KiB
HTML
Raw Permalink 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 Pgm Dev Entry (DLTOVRDEVE)</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="DLTOVRDEVE.Top_Of_Page"></a>
<h2>Delete Override Pgm Dev Entry (DLTOVRDEVE)</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="#DLTOVRDEVE.PARAMETERS.TABLE">Parameters</a><br>
<a href="#DLTOVRDEVE.COMMAND.EXAMPLES">Examples</a><br>
<a href="#DLTOVRDEVE.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="DLTOVRDEVE"></a>
<p>The Delete Override Device Entry (DLTOVRDEVE) command deletes one or more program device overrides that were previously specified in a call level.
</p>
<p>For each overridden program device named in the DLTOVRDEVE command, the override specified in the same call level as the DLTOVRDEVE command is deleted. When the command is entered interactively or outside a program in a batch job, the program device overrides for the call level are deleted; when the command is used in a CL program, the program device overrides for that program call level are deleted. A program device override is the result of an override program device command Override Intersystem Communications Function Device Entry (OVRICFDEVE).
</p>
<p>The DLTOVRDEVE command can delete all the program device overrides in the same call level, or it can delete a specific program device override in the same call level. Only the call level in which the command is entered has its program device overrides deleted. For example, if an override command is entered in one program in a routing step, and then another program is called that also contains override commands, a DLTOVRDEVE command entered in the second program can delete only overrides that occurred in that program. The DLTOVRDEVE command has no effect on the override command that was entered before the program was called. The deleted program device override has no effect on subsequent uses of the program device.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVRDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="DLTOVRDEVE.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="#DLTOVRDEVE.PGMDEV"><b>PGMDEV</b></a></td>
<td valign="top">Overridden program device</td>
<td valign="top">Single values: *ALL<br>Other values (up to 50 repetitions): <i>Name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#DLTOVRDEVE.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="#DLTOVRDEVE.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="DLTOVRDEVE.PGMDEV"></a>
<h3>Overridden program device (PGMDEV)</h3>
<p>Specifies the program device overrides being deleted. One or more program device overrides can be specified by name.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>All program device 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><i>name</i></b></dt>
<dd>Specify the names of one or more overridden program devices for which the overrides in the call level are to be deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVRDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="DLTOVRDEVE.LVL"></a>
<h3>Call level (LVL)</h3>
<p>Specifies the call level of the program device overrides to be 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 program device 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 program device 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 program device overrides to be deleted equals the activation group of the calling program.
</dd>
<dt><b>*</b></dt>
<dd>The call level of the program device overrides to be deleted is the call level of the program that called the DLTOVRDEVE command processing program. If the DLTOVRDEVE 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 program device overrides scoped to the job are deleted. Only overrides at the job level with OVRSCOPE(*JOB) specified are deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVRDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTOVRDEVE.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Deleting Program Device Overrides With Calling Program in Default Activation Group</b>
</p>
<p>
<pre>
DLTOVRDEVE PGMDEV(*ALL)
</pre>
</p>
<p>This command deletes all program device overrides that exist in the call level, when the calling program runs in the default activation group. When the calling program runs in an activation group other than the default activation group, the program device overrides that are scoped to that activation group are deleted.
</p>
<p><b>Example 2: Deleting Program Device Overrides With Calling Program in Any Activation Group</b>
</p>
<p>
<pre>
DLTOVRDEVE PGMDEV(*ALL) LVL(*)
</pre>
</p>
<p>This command deletes all program device overrides that exist in the call level, regardless of the activation group the calling program runs in.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#DLTOVRDEVE.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="DLTOVRDEVE.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>CPF1892</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="#DLTOVRDEVE.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>