247 lines
10 KiB
HTML
247 lines
10 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>Display Override (DSPOVR)</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="DSPOVR.Top_Of_Page"></a>
|
|
<h2>Display Override (DSPOVR)</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="#DSPOVR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#DSPOVR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#DSPOVR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="DSPOVR"></a>
|
|
<p>The Display Override (DSPOVR) command displays file overrides at any active call level for a job. All file overrides, or file overrides for a specific file name, can be displayed.
|
|
</p>
|
|
<p>The file overrides can be merged before being displayed. A merged file override is the result of combining all overrides for a file from call level one to the specified call level, producing the override which is applied when the file is opened at the specified call level.
|
|
</p>
|
|
<p>A call level is associated with each call stack entry in the call stack. Calling a program or procedure adds another call stack entry to the call stack. When a program or procedure is called using the TFRCTL (Transfer Control) command, the call stack entry replaces a call stack entry that is already on the call stack; a new call level number is not created.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>This function can also be accessed through option 15 of the Work with Job (WRKJOB) command.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="DSPOVR.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="#DSPOVR.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Overridden file name</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *PRTF</td>
|
|
<td valign="top">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPOVR.MRGOVR"><b>MRGOVR</b></a></td>
|
|
<td valign="top">Merge overrides</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPOVR.LVL"><b>LVL</b></a></td>
|
|
<td valign="top">Call level</td>
|
|
<td valign="top">1-999, <b><u>*</u></b>, *JOB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPOVR.ACTGRP"><b>ACTGRP</b></a></td>
|
|
<td valign="top">Activation group</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#DSPOVR.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="DSPOVR.FILE"></a>
|
|
<h3>Overridden file name (FILE)</h3>
|
|
<p>Specifies whether all file overrides, or file overrides for a specific file, are displayed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All the file overrides from call level one to the specified call level are displayed.
|
|
</dd>
|
|
<dt><b>*PRTF</b></dt>
|
|
<dd>The *PRTF file override, which exists in the call level where this command is entered, is displayed.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the file for which all the file overrides, from call level one to the specified call level, are displayed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPOVR.MRGOVR"></a>
|
|
<h3>Merge overrides (MRGOVR)</h3>
|
|
<p>Specifies whether the file overrides are merged. Only those parameters on the overrides of the same type as the last override used for the merged override are used in determining the effective override for the specified call level.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The file overrides displayed are merged.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>The file overrides displayed are not merged.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPOVR.LVL"></a>
|
|
<h3>Call level (LVL)</h3>
|
|
<p>Specifies the call levels of the file overrides displayed. There is a one-to-one correspondence between the call stack entries displayed on the call stack from the WRKJOB command and the call level for that call stack entry.
|
|
</p>
|
|
<p>The first call stack entry name displayed on the call stack (at the top of the list) is the program or procedure at call level one. The second call stack entry name displayed is the program or procedure at call level two. The last call stack entry name displayed is the program or procedure at the highest call level for the job.
|
|
</p>
|
|
<ul>
|
|
<li>If a merged file override is displayed, file overrides from call level one to the specified call level contribute to the creation of the merged file override.
|
|
</li>
|
|
<li>If *NO is specified on the <b>Merge overrides (MRGOVR)</b> parameter and *ALL is specified on the <b>File being overridden (FILE)</b> parameter, all file overrides (and the call levels at which they were found) from call level one to the specified call level are displayed.
|
|
</li>
|
|
<li>If *NO is specified on the <b>Merge overrides (MRGOVR)</b> parameter, and a file override name is specified on the <b>File being overridden (FILE)</b> parameter, all file overrides for the file specified (and the call levels at which they were found) from call level one to the specified call level are displayed.
|
|
</li>
|
|
</ul>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The call level of the file override displayed is the call level of the program that called the DSPOVR command processing program. If this command is started by a call to QCMDEXC, the call level is the same call level as the caller of QCMDEXC. Overrides at call level numbers greater than 999 are not displayed.
|
|
</dd>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>Only overrides at the job level with OVRSCOPE(*JOB) specified are displayed.
|
|
</dd>
|
|
<dt><b><i>1-999</i></b></dt>
|
|
<dd>Specify the specific call levels of the file overrides to display. A specific call level is used to display file overrides at call levels lower than the call level at which the user is running.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPOVR.ACTGRP"></a>
|
|
<h3>Activation group (ACTGRP)</h3>
|
|
<p>Specifies the level overrides to display for an activation group. When MRGOVR(*YES) is specified, the activation group level overrides are processed after all call level overrides that are greater than or equal to the call level of the oldest procedure in the activation group are processed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The level overrides from the requester's activation group will be displayed.
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the activation group that specifies activation group level overrides.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="DSPOVR.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPOVR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Displaying Merged Overrides</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPOVR FILE(REPORTS) MRGOVR(*YES) LVL(3) OUTPUT(*)
|
|
</pre>
|
|
</p>
|
|
<p>This command produces a display showing the merged override for the file REPORTS at call level 3 with text descriptions of each keyword and parameter. Applicable overrides at call levels 1, 2 and 3 are used to form the merged override.
|
|
</p>
|
|
<p><b>Example 2: Displaying File Overrides</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
DSPOVR FILE(REPORTS) MRGOVR(*NO) LVL(2) OUTPUT(*)
|
|
</pre>
|
|
</p>
|
|
<p>This command displays all file overrides for the file REPORTS up to call level 2. It produces a display showing the file name, the call level for which the override was requested, the type of override, and the override parameters. If no file overrides are found for the file up to and including the specified call level, escape message CPF9842 is sent.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="DSPOVR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF180C</b></dt>
|
|
<dd>Function &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF1892</b></dt>
|
|
<dd>Function &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF9842</b></dt>
|
|
<dd>Overrides not found for file &1.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9850</b></dt>
|
|
<dd>Override of printer file &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF9851</b></dt>
|
|
<dd>Overflow value for file &1 in &2 too small.
|
|
</dd>
|
|
<dt><b>CPF9852</b></dt>
|
|
<dd>Page size too narrow for file &1 in &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#DSPOVR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|