VMS Help  —  DEFRAGMENT  SHOW
    The SHOW subcommand displays information about the fragmentation
    state of the given volume and information from the scheduling
    database.

    Format

      DEFRAGMENT SHOW  { script-name|volume-name } [ /QUALIFIERS ]

1  –  Parameters

 script-name|volume-name

    The parameter for the SHOW subcommand is either a script name
    or a volume name, or it can be omitted if the /ALL qualifier
    is used. If a script name is supplied or if the /PARAMETERS
    qualifier is specified, the SHOW command queries the scheduling
    database and displays this information. 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 (/VOLUME required), the SHOW
    command displays information about the fragmentation state of
    the specified volume. If a list of names is provided, the list
    cannot contain both script and volume names.

2  –  Restrictions

    o  If showing a script or volume, do not use the /ALL qualifier

    o  If it is a volume, then you must use the /VOLUME qualifier

3  –  Qualifiers

3.1    /ALL

       /ALL
       /NOALL (default)

          The /ALL qualifier is used when showing information
          from the scheduling database. It displays information
          about all scripts and parameters in the scheduling
          database. If /ALL is used, the script-name parameter
          is not allowed.

3.2    /COMMAND_LINE

       /COMMAND_LINE
       /NOCOMMAND_LINE (default)

          The /COMMAND_LINE qualifier is used when showing
          information from the scheduling database. It
          formats the output of the SHOW subcommand as a valid
          DEFRAGMENT command line. Thus, all the data in the
          scheduling database can be extracted into a file (
          /ALL/COMMAND_LINE/OUTPUT=file.ext).

3.3    /DEVICE

       /DEVICE=(device_spec[,device_spec])...

          The /DEVICE qualifier selects only those scripts
          that match the script name provided on the command
          line and that target any devices named with this
          qualifier.

3.4    /FILE_LIST

       /FILE_LIST=(min_extents)
       /FILE_LIST=(VOL_MAP_WINDOW + 1) (default)

          The /FILE_LIST qualifier is used when showing the
          fragmentation state of a volume. It lists all files
          on the volume that have min_extents or more extents
          (fragments). By default, the number of file window
          mapping pointers set for the volume (INITIALIZE
          {volume}/WINDOW=n) plus one is used. This value lists
          all files that require at least one window turn to
          completely map.

3.5    /FREE_LIST

       /FREE_LIST
       /NOFREE_LIST (default)

          The /FREE_LIST qualifier is used when showing the
          fragmentation state of the volume. It lists the
          location and size of all of the freespace extents
          on the volume.

3.6    /HISTOGRAM

       /HISTOGRAM
       /NOHISTOGRAM (default)

          The /HISTOGRAM qualifier is used when showing the
          fragmentation state of a volume. It generates two
          histograms. The first plots the number of files
          against the number of extents per file and provides
          information about how many files are fragmented and
          how badly they are fragmented. The second histogram
          plots the number of freespace extents (holes) against
          the size of these freespace extents. It provides
          information about how many freespace extents are on
          the volume and their sizes.

3.7    /LOCATION

       /LOCATION=[file-spec[,...]]
       /NOLOCATION

          The /LOCATION qualifier is used when showing the
          fragmentation state of the volume. It prints the
          extents (fragments) associated with all specified
          files. If no files are specified, the /LOCATION
          qualifier appends location information to all files
          listed with the /FILE_LIST qualifier. The supplied
          file-spec may contain wildcards in place of the
          directory, file name, extension, or version fields.

3.8    /NAMES

       /NAMES

          The /NAMES qualifier lists only the first line of
          the usual show output. The first line of the script
          includes the name of the script, whether the script
          is enabled or disabled, and the target device for the
          script.

3.9    /NODE

       /NODE=(node-name[,...])
       /NONODE (default)

          The /NODE qualifier selects only those scripts
          that match the script name provided on the command
          line and that match any of the node specifications
          provided with this qualifier.

          When used with the /PARAMETERS qualifier, the /NODE
          qualifier displays CPU_LIMIT, IO_LIMIT, and PROCESS_
          LIMIT information for specified nodes only. If
          the /NODE qualifier is not used, the /PARAMETERS
          qualifier displays this information for all nodes in
          the scheduling database.

3.10    /OUTPUT

       /OUTPUT={file-spec}
       /OUTPUT=SYS$OUTPUT (default)

          The /OUTPUT qualifier may be used when showing
          the volume fragmentation state or when showing
          information from the scheduling database. It directs
          the output of the SHOW subcommand to a file. By
          default, output is directed to SYS$OUTPUT.

3.11    /PARAMETERS

       /PARAMETERS
       /NOPARAMETERS (default)

          The /PARAMETERS qualifier is used when showing
          information from the scheduling database. It
          displays the CPU_LIMIT, IO_LIMIT and PROCESS_LIMIT
          settings for all nodes in the scheduling database
          (unless specific nodes are designated with the /NODE
          qualifier). By default, these settings are not shown.

3.12    /RUNNING

       /RUNNING

          The /RUNNING qualifier shows scripts that are
          currently running.

3.13    /STATISTICS

       /STATISTICS
       /NOSTATISTICS (default)

          The /STATISTICS qualifier is used when showing the
          volume fragmentation state. It provides a summary of
          the file and free space fragmentation for the volume.

3.14    /VOLUME

       /VOLUME
       /NOVOLUME (default)

          The /VOLUME qualifier must be used to show the
          fragmentation state of a volume. It indicates that
          any parameter supplied on the command line is a
          volume name instead of a script name. The /VOLUME
          qualifier is incompatible with any of the qualifiers
          used to show database information except the /OUTPUT
          qualifier.

4  –  Examples

    The following examples show how to SHOW limits using the SHOW
    subcommand and its qualifiers.

    1.

    $ DEFRAGMENT SHOW/PARAMETERS

    In this example, the current values of CPU_LIMIT, IO_LIMIT and
    PROCESS_LIMIT for all nodes in the scheduling database are shown.

    2.

    $ DEFRAGMENT SHOW MY_SCRIPT/OUTPUT=OUTPUT.TXT

    In this example, information associated with MY_SCRIPT is
    displayed. No parameter information is displayed. Output is
    directed to a file called OUTPUT.TXT.

    3.

    $ DEFRAGMENT SHOW MY_SCRIPT/COMMAND_LINE/PARAMETERS

    In this example, information associated with MY_SCRIPT is
    displayed. The current values of CPU_LIMIT, IO_LIMIT and PROCESS_
    LIMIT for all nodes in the scheduling database are also shown.
    The format for the information is a valid DEFRAGMENT command
    line. Output is directed to the user's SYS$OUTPUT device.

    4.

    $ DEFRAGMENT SHOW DISK$ONE/VOLUME/HISTOGRAM

    In this example, the volume fragmentation report includes the
    summary statistics (/STATISTICS is default) and histograms for
    both file fragmentation and freespace fragmentation. The report
    is sent to the SYS$OUTPUT device.
Close Help