CL Command Reference - DSPOVR
CL Command List > DSPOVR Reference
Description:
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.
Examples:
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.