      DFSee version 6.06 16-04-2004  (c) 1994-2003: Jan van Wijk
 =========================[ www.dfsee.com ]==========================

_______________________________________________________________________________

C O N T E N T S:
_______________________________________________________________________________

   Command reference    = overview of JFS specific commands
   Detailed description = description for every command


  Note: All generic commands can be found in DFSCMDS.TXT, for example:

        ALLOC,  CHECK,  CLONE,  RESIZE,  RECOVER,  SAVETO,  SCAN,  WIPE

_______________________________________________________________________________

C O M M A N D   R E F E R E N C E:
_______________________________________________________________________________

JFS specific commands

Active filesystem : JFS, specific commands are:

 ALLOC     [+|-] = Display allocation map for JFS, more [+] or less [-] detail
 BL              = Translate and display 'this' LSN as a block number
 BL block  [cmd] = Translate specified block-number to LSN, display using 'cmd'
 DIRTY [d|c|m|#] = Display/set DIRTY, CLEAN, MOUNT status or numeric value #
 SYNC       1|2  = Sync superblock, copy from 1st or from 2nd instance
 FIXBOOT         = Create JFS boot sector from superblock, template and p-table
 SUPER           = Display the filesystem SUPERBLOCK sector


 For an up-to-date list of commands, use the '?' command

 JFS specific sector types  (see ??? command)

             's' = JFS  superblock

             For an up-to-date list, use the '???" command
_______________________________________________________________________________

D E T A I L E D   D E S C R I P T I O N:
_______________________________________________________________________________

ALLOC  [+]      = Show aggregate allocation bitmaps, compact or [+] verbose

 Purpose:       Show usage and the distribution of data over the volume.

 Parameters:    none

 Output:        none yet


 Remarks:       To be implemented
_______________________________________________________________________________

 DIRTY [d|c|m|#] = Display/set DIRTY, CLEAN, MOUNT status or numeric value #

 Purpose:       Modify the JFS volume's 'dirty' state

 Parameters:    state   optional   'clean' will set it clean (no CHKDSK)
                                   'mount' will set it to be cleanly mounted
                                   'dirty' will force CHKDSK on reboot
                                    (unless clean shutdown done afterwards)

 Output:        'superblock written' confirmation

 Remarks:       A volume is normally marked 'dirty' by the OS on the first
                write access to it, and set 'clean' on successful shutdown.
                This means a system crash will cause a CHKDSK on reboot
                It is most useful from boot-diskettes (DOS or OS/2)

 Usage:         Below is an example of the actual usage text

                Usage: dirty  clean | dirty | decimal-value   [1|2]

                      0 = FS unmounted and clean
                      1 = FS mounted cleanly
                      2 = FS is dirty
                      4 = recovery failed (logredo())
                      8 = extendfs() in progress

                      4 & 8 can be combined with others

                  [1|2] : Update 1st or 2nd superblock only (default is both)

                JFS SB1 status is : 1 = Mounted cleanly
_______________________________________________________________________________

 FIXBOOT         = Create JFS bootsector from superblock, template and p-table

 Purpose:       Fix corrupted bootsector for a JFS partition

 Parameters:    none

 Output:        Progress and confirmation info

 Remarks:       This will create a valid bootsector based on OS/2 version 4.5
                bootsector code and size-info from the partition table and/or
                the 1st superblock structure at relative sector 0x40.

                The partition-table info (type and size) must still be valid,
                or a valid superblock must be present.
_______________________________________________________________________________

 SYNC       1|2  = Sync superblock, copy from 1st or from 2nd instance

 Purpose:       Synchronize the two copies of the JFS superblock

 Parameters:    from    mandatory  direction of the sync operation

 Output:        'superblock written' confirmation

 Remarks:       This should only be needed in very rare cases

 Usage:         Below is an example of the actual usage text

                Usage: sync   1 | 2

                   1 = sync 1st copy at 0x40 to 2nd at 0x78
                   2 = sync 2nd copy at 0x78 to 1st at 0x40
_______________________________________________________________________________

SUPER           = Display the filesystem SUPERBLOCK sector

 Purpose:       Display the contents of the JFS superblock

 Parameters:    none

 Output:        Most important fields of the superblock

_______________________________________________________________________________

