Purpose: The CLOSE command can be used to close a log data set
allocated to the DIF started task. This facility allows examination of the
messages logged to the log data sets.
Syntax:
CLOSE {ddname} [CLEAR] [RESET] [SWAP]
Comments: The LOG parameter on the DEFPROD,
DEFENV, DEFPOOL, and DEFMSG rule
statements allows the product to log messages to data sets allocated to the
DIF started task.
The CLOSE command can be used to force DIF to finish
writing all scheduled messages to the log data set, and then close the file. The file can then
be examined with an editor.
If you wish to clear the data set, the
CLOSE command can be issued with the
CLEAR operand. DIF will close and reopen the data set as
output when the next log message is written. Tip: If
CLEAR is not specified, DIF opens the file with
EXTEND and messages will be appended to the file. The
RESET operand forces the DIF log facility to return
to the original log file on the next open. This operand can be used when log overflow files
have been allocated, and the log facility is currently using an overflow log file. Note: For more information, see “Log and Record Files” on page
4-6 in the Rules Language Programming Guide.
The
SWAP operand forces the DIF log facility to switch
to the next overflow log file for non-GDG logs (i.e., RTMDBA to
RTMDBB). When SWAP is specified for a GDG log file, the
next I/O to the log file routes records to the next generation of the GDG group. Tip: You could add
F DIF,CLOSE logfile SWAP
commands to your automated operations procedures to produce scheduled generations of log
data (i.e., daily log files).
Examples: To close the data sets allocated to the LOGFILE DD
statement, the following console command can be used:
F DIF,CLOSE LOGFILE