!=============================================================================!
!  DIVISION   I	:				     HELP MODULE DECLARATION  !
!=============================================================================!
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 01 :					 INITIAL VERSION      !
!      -----------------------------------------------------------------      !
!									      !
!      Help Library	 : ACC_HELP:STAFFHELP.HLB			      !
!      File Specification: ACCSRC_ACC:[HELP.SYSTEM.STAFF]FRAGMENTATION.HLP    !
!      Author		 : Marlys A. Nelson				      !
!      Initial version	 : 01.00.00 27-MAY-1985	VMS 4.1			      !
!									      !
!      -----------------------------------------------------------------      !
!      SECTION 02 :				    MODIFICATION HISTORY      !
!      -----------------------------------------------------------------      !
!									      !
!									      !
!=============================================================================!
!  DIVISION  II	:				  HELP MODULE SPECIFICATIONS  !
!=============================================================================!
!									      !
!      Key 1 (Command name)............	FRAGMENTATION			      !
!	 Key 2 ........................	Parameters			      !
!	 Key 2 ........................	Qualifiers			      !
!	 /qualifier ...................	  /FULL				      !
!	 /qualifier ...................   /OUTPUT			      !
!									      !
!=============================================================================!
!  DIVISION III	:					       SPECIAL NOTES  !
!=============================================================================!
!									      !
!									      !
!=============================================================================!
!
!
!=============================================================================!
! Key 1								FRAGMENTATION !
!=============================================================================!
!
1 FRAGMENTATION
FRAGMENTATION  reports on the degree of fragmentation of the specified
disk device.

Format:

      FRAGMENTATION[/qualifiers] device

FRAGMENTATION  will  always report the following information about the
specified disk device:

  1. Total disk space (in blocks)
  2. Total free disk space (in blocks)
  3. Total number of disk space fragments
  4. The size of the smallest disk free space fragment
  5. The number of fragments equaling the smallest fragment size
  6. The size of the largest disk free space fragment
  7. The number of fragments equaling the largest fragment size

If the full fragmentation report  is  selected  (/FULL  qualifier),  a
chart  is  printed  which details the size and count of every fragment
located on the disk.

FRAGMENTATION  must  be  set up as a DCL command.  This can be done by
entering the following command:

    $ SET COMMAND ACC_SYSTEMCLD:FRAGMENTATION.CLD

This command can  be  entered  interactively  prior  to  entering  the
FRAGMENTATION  command.   You  can also include the command as part of
your  LOGIN.COM  file,  thereby  making  the   FRAGMENTATION   command
available always.

FRAGMENTATION reads the disk file  [000000]BITMAP.SYS.   It  does  not
consider  information  the  system maintains internally regarding disk
space.  Hence,  the  information  reported  by  FRAGMENTATION  is  not
completely  accurate at all times.  It does provide general guidelines
useful in evaluating disk fragmentation.  The information reported  by
FRAGMENTATION is most accurate immediately following a system boot.

At this time,  FRAGMENTATION  will  only  work  correctly  with  disks
configured  with  a  cluster  size  of 1.  Each bit in the bitmap file
represents one disk unit of storage.  This storage unit is defined  as
the  number  of  disk blocks in a cluster.  Hence, FRAGMENTATION works
for a cluster size of 1 - where one bit represents one disk block.
!
!=============================================================================!
! Key 2								   Parameters !
!=============================================================================!
!
2 Parameters
device

  Specifies the disk device for  which  to  report  the  fragmentation
  information.   This parameter is required.  It may be specified as a
  logical name (USERDISC1 or USERDISC2) or as a physical  device  name
  (DRA0: or DUA0:).
!
!=============================================================================!
! Key 2								   Qualifiers !
!=============================================================================!
!
2 Qualifiers
!
! qualifier
!
/FULL

  /FULL

  Requests a complete chart detailing all free space fragments located
  on the disk drive.  The chart shows the size, in  disk  blocks,  and
  the number of fragments of that specific size.

!
! qualifier
!
/OUTPUT

  /OUTPUT[=filespec]

  Specifies  the  name  of  the  file  into  which  the   results   of
  FRAGMENTATION  are to be written.  If not specified, the results are
  written to the file FRAGMENTATION.LIS.
!
!=============================================================================!
!							   END OF HELP MODULE !
!=============================================================================!
