| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
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.
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.
Note: This function can also be accessed through option 15 of the Work with Job (WRKJOB) command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FILE | Overridden file name | Name, *ALL, *PRTF | Optional, Positional 1 |
| MRGOVR | Merge overrides | *YES, *NO | Optional |
| LVL | Call level | 1-999, *, *JOB | Optional |
| ACTGRP | Activation group | Character value, * | Optional |
| OUTPUT | Output | Optional |
| Top |
Specifies whether all file overrides, or file overrides for a specific file, are displayed.
| Top |
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.
| Top |
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.
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.
| Top |
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.
| Top |
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
| Top |
Example 1: Displaying Merged Overrides
DSPOVR FILE(REPORTS) MRGOVR(*YES) LVL(3) OUTPUT(*)
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.
Example 2: Displaying File Overrides
DSPOVR FILE(REPORTS) MRGOVR(*NO) LVL(2) OUTPUT(*)
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.
| Top |
*ESCAPE Messages
| Top |