******************************************************************************
  (C) Copyright 2003-2004 Curtis Systems Software P.C. All rights reserved
                    (last update: 2004 Jul 19a)
******************************************************************************
file: exam_ss.txt

This files contains examples for the snapshot compare mode of cssdir.
The snapshot compare mode, /Sscm requires a PRO cssdir license

CSSDIR /Sscm examples follow (without output), 

Examples that have an appended suffix such as a letter of the alphabet, 
probably are dependent on the user running the previous ones with 
the same number.

1.) cssdir /$snapshotlist$/ C:\ /s > sspf
   invoke cssdir and take a "snapshot" of drive C saving results to sspf

1a) dir > c:\newfile1
   make a change on drive c:\
   
   cssdir /$snapshotlist$/ C:\ /s > ssnf
   invoke cssdir and take a "snapshot" of drive C saving results to ssnf

1b.) cssdir /Sscm
   run cssdir with defaults, which will compare snapshot files
   ssnf to sspf

2.) cssdir /$snapshotlist$/ /$$bdrv$/:\ /s /Of:bdrv2.ss
   take a snapshot of active bootdrive and save to bdrv2.ss

2a) after some time has occurred and/or you have made some changes to
   your active boot drive, continue

   cssdir /$snapshotlist$/ /$$bdrv$/:\ /s /Of:bdrv1.ss
   take another snapshot of your active boot drive but save to bdrv1.ss

2b) cssdir /Sscm /BD /Ssnf:bdrv1.ss /Sspf:bdrv2.ss
   compare your newests snapshot bdrv1.ss to a previous snapshot bdrv2.ss

2c) cssdir /Sscm /BD /Ssnf:bdrv1.ss /Sspf:bdrv2.ss /Lfc /Lfb /Lfd0 /Lft0 /Lrll
   same as 2b but also show files crc and eaCrc but not date and time
   and label the column fields

2d) cssdir /Sscm /BD /00 /Ssnf:bdrv1.ss /Sspf:bdrv2.ss /Lff3
   same as 2b but only list the full filespecs

3.) rerun example #1 but substitute in a drive that is about to go through
   a bunch of changes, after those changes rerun example #1 but substitute
   ssnf in for sspf

3a) cssdir /Sscm /00 /Lxlo:xf /Lfx /Lff3
   lists differences between ssnf and sspf, number the files and list only
   their full filespec

3b) cssdir /Sscm /00 /Lxlo:xuf /Lfx /Lfu /Lff3
   same as 3a but include why the file was different (or unique)

3c) ds /00 /Lxlo:xuf /Lfx /Lfu /Lff3
   use REXX script 'ds' shortcut for 'cssdir /Sscm'
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)
   and (REXX is available)
   if you did NOT activate shortCuts,
   in this and the following examples substitute 'cssdir /Sscm' for 'ds'

3d) ds /Vn:0 /Ve:0 /Lxlo:xuf /Lfx /Lfu /Lff3
   similar to 3c
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

3e) ds /00 /Lxlo:xsuf /Lfx /Lfu /Lff3 /Lrll
   similar to 3c but add size and label columns
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

3f) ds /00 /Lxlo:xsuf /Lfx /Lfu /Lff3 /Lrll /Dumpo:y/c
   same as 3e but also show options that are set
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

3g) ds /BD /Lxspc:1
   show any previous (changed) files info as well if its different
   (good for visual comparisons)
   note delta column (/Lfp) if shown for all old snapshot changed 
   files will have '***' in them
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

3h) ds /BD /Lxspc:1 /Lfp3
   same as 3g but show delta size and percentages on differences
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

4) ds /$sscStdReport$/
   use symbolic from cssdir.cfg and generate multiple reports
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

4a) ds /$sscStdReport$/ /Of:sscRep./m
   same as 4 but keep reports in separate files beginning with 'sscRep.'
   (note to run this example multiple times you will have to append
   and 'O' to overwrite existing files that start with sscRep. or
   change the basefile name)
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

4b) ds /$sscStdReportACDbare$/ /Of:sscRep./m
   same as 4a but generate file names only in 3 of the files
   see default cssdir.cfg for notes on /$sscStdReportACDbare$/
   (note some files may have no non-blank output, i.e.
    no new files, no deleted files, and/or no changed files to be
    listed in sscRep.1, sscRep.2 and/or sscRep.3, respectfully.)
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

4c) ds /$sscReportB$/
   number diffs, show delta bytes change/percentages, 
   unique fields, hintstr, full filespec
   'ds' is available if you chose to activate shortCuts (see shtCuts\readme)

other notes
 if you have more than a screenful try 'dsm' for 'ds' which pipes
 output through 'more'
 'dsm' is available if you chose to activate shortCuts (see shtCuts\readme)
 (and have REXX available)

 if you are getting differences that involve lower case letters in the
 /Lfu column such as 'c' and 'b', you may want to see options
 /Lxxbo: and /Lxxco: to ignore such differences in some of your 
 snapshot compares, you may also want to snapshot when those files
 are not inaccessible (not in use or locked down by the operating system).

******************************************************************************
  (C) Copyright 2003-2004 Curtis Systems Software P.C. All rights reserved.
******************************************************************************
