DEFRAGMENT.HLB  —  DEFRAGMENT  MONITOR
    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.
Close Help