In the case of the DISPLAY commands DISPLAY DEPRECATED, DISPLAY EXPENSIVE, DISPLAY MESSAGES and DISPLAY DBCOUNTERS the results are written to an intermediate SAM file which is displayed on the screen by means of a SHOW-FILE command which is issued internally by the UDS monitor.
When the results are displayed, you are in the output of the SHOW-FILE command and can use the convenient scroll and search functions of SHOW-FILE to evaluate the results. You terminate the DISPLAY command by entering END. You then quit the SHOW-FILE command, and UDSMON returns to its mask mode.
Link names of the intermediate files:
The intermediate file can be a permanent or temporary file and is addressed via the following link names:
$UDSDD in the case of DISPLAY DEPRECATED$UDSDE in the case of DISPLAY EXPENSIVE$UDSDM in the case of DISPLAY MESSAGES$UDSDC in the case of DISPLAY DBCOUNTERS
If no file is assigned via these link names, UDSMON creates a temporary file with the following names:
#UDSMON.DEPRECATED
#UDSMON.EXPENSIVE
#UDSMON.DBH.MESSAGES
#UDSMON.DBCOUNTERS
where # is the temporary flag and can be changed to @ using the BS2000 system parameter TEMPFILE.
Only if the use of temporary files is not possible on the BS2000 system (BS2000 system parameter TEMPFILE=’NO’) does UDSMON create a permanent file with the following names:
UDSMON.DEPRECATED.tsn.date
UDSMON.EXPENSIVE.tsn.date
UDSMON.DBH.MESSAGES.tsn.date
UDSMON.DBCOUNTERS.tsn.date
Use of the intermediate files:
With each DISPLAY DEPRECATED, DISPLAY EXPENSIVE, DISPLAY MESSAGES and DISPLAY DBCOUNTERS command, UDSMON checks whether an intermediate file with the corresponding name is already assigned. If no such file exists, UDSMON creates a new intermediate file and addresses it using temporarily the relevant link name.
In the case of a DISPLAY EXPENSIVE, DISPLAY MESSAGES, or DISPLAY DBCOUNTERS command UDSMON opens the intermediate files in EXTEND mode if an intermediate file with the relevant link name is already assigned. In this case the files are updated. If multiple DISPLAY MESSAGES commands are issued in a monitor run, only the DBH messages which have been added since the previous command are supplemented. If no intermediate file with link names is assigned in the case of the DISPLAY EXPENSIVE, DISPLAY MESSAGES or DISPLAY DBCOUNTERS command or a new file name is recognized, the intermediate file is opened with OUTPUT mode.
In the case of the DISPLAY DEPRECATED command the intermediate file is opened in OUTPUT mode and consequently overwritten with each new DISPLAY command.
The intermediate files are only opened while a DISPLAY command is being processed. As a result you have many different options to intervene until another DISPLAY command is issued, e.g. you can rename the file, copy or also delete it if, in the case of updated files, the previous edition is no longer required.
DISPLAY commands, which write the result to an intermediate file, can also be entered as START commands. These commands are then noted and executed immediately after the START command. However, in this case no internal SHOW-FILE call is executed after the intermediate file has been written to.
Example of an output to an intermediate file
=== UDSMON: DISPLAY DBCOUNTERS ============================================ DB-CONFNAME : FPADB DATE: 2019-01-29 TIME: 09:26:07 DATABASE NAME DML LOG READ PHYS READ LOG WRITE PHYS WRITE FPADB 5 40 23 14 8 DBSTAT 0 26 20 2 2 === UDSMON: END OF DISPLAY DBCOUNTERS =====================================