The MONITOR subcommand invokes the monitor function to illustrate the progress of ongoing defragmentation processes. Format DEFRAGMENT MONITOR { script-name|volume-name } [ /QUALIFIERS ]
1 – Parameters
script-name|volume-name The parameter for the MONITOR subcommand is either a script name or a volume name for Defrag PLUS. You can use wildcards in the script-name specification. Use an asterisk (*) to take action on all scripts on the VMScluster system. Use a percent sign (%) to match a single character in the script-name specification. If a volume name is supplied, then you must use the /VOLUME qualifier to tell Defrag PLUS the parameter is a volume name, rather than a script name.
2 – Restrictions
o If a volume name is entered as a parameter, the /VOLUME qualifier must be used.
3 – Qualifiers
3.1 /CONTINUOUS
/CONTINUOUS (default) NOCONTINUOUS The /CONTINUOUS qualifier invokes a continuous monitor display. Entering Ctrl/C, Ctrl/Y, or Ctrl /Z terminates this display. Using /NOCONTINUOUS indicates the monitor process should provide a snapshot display and then exit to the DCL prompt.
3.2 /VOLUME
/VOLUME (default) /NOVOLUME The /VOLUME qualifier indicates that a volume name instead of a script name is present on the command line. The /VOLUME qualifier must be used when a volume name is provided as a parameter to the MONITOR subcommand.
4 – Examples
The following examples show how to invoke the monitor. 1. $ DEFRAGMENT MONITOR MY_SCRIPT/NOVOLUME In this example, the monitor function displays ongoing run-time statistics for the defragmentation process associated with MY_ SCRIPT. It also displays an approximate free-space map of the target volume. The display continues until interrupted with a Ctrl/C, Ctrl/Y, or Ctrl/Z because the /CONTINUOUS qualifier is present by default. 2. $ DEFRAGMENT MONITOR DISK$ONE/NOCONTINUOUS In this example, the defragmentation process executing against DISK$ONE is monitored. Since the /NOCONTINUOUS qualifier was specified, the monitor function samples the defragmentation process statistics and the free space on DISK$ONE one time before exiting to the DCL prompt.