******************************************************************************
     (C) Copyright 2003 Curtis Systems Software P.C. All rights reserved
                    (last update: 2003 August 12)
******************************************************************************
20 or more cssdir examples follow (without output), and then a few more 
examples after these follow WITH output.

cssdir c:\ -Dr:. -s -a -os
  lists all files (if any) that have today's date (timestamp) sorted by 
  ascending size on drive c   

cssdir c:\;d:\;e:\ -Wc:*.c;*.h;*.cpp -Sch:"/Cmain("
  lists all non-hidden or system files having an extension of
  .c or .h or .cpp files on drives c, d, and e that contain
  the text case sensitive string 'main(' and also show summary 
  of matches per file (via default -Scho:1).

cssdir c:\;d:\;e:\ -Wc:*.c;*.h;*.cpp -Sch:"/Cmain(" -Scho:0 -Bf3
  Same as previous example but just give us the bare full file 
  specification of files that have the requested text string.

cssdir -s -a -od /$$bdrv:\ 
  lists all files on the current boot drive sorted by ascending date/time

cssdir -Dr:curweek
  lists all the (non-hidden and/or system) files that have a date of
  Monday through todays' day of the week in the current directory.

cssdir -Dr:cur3week
  same as previous example but go back up to 3 weeks in time.

cssdir -Dr:curmonth
  lists all the (non-hidden and/or system) files that have a date of
  which falls within the current month in the current directory.

cssdir -Dr:cur6month
  lists all the (non-hidden and/or system) files that have a date of
  which falls within the last six calendar months in the current directory.

cssdir -Dr:2002  -a
  lists all the files that have a date in the year 2002 in the
  current directory.

cssdir -Dr:2002-06;2003-01 *.c
  lists all the files that have a date in the month of June of 2002
  or in the month of January of 2003 and matched the dirspec of *.c
  in the current directory.

cssdir -Te2 -Dr:today
  lists all the (non-hidden and/or system) files that have a date of
  today in the current directory and show the time field in the
  HH:MM:SS format (cmd.exe's dir does not show the seconds field)!

cssdir . f:\ -Fcrc:y -Fc -Xcrc:.zip;.rar
  lists all the (non-hidden and/or system) files that reside in the current
  directory and in the root directory of the F drive while also computing 
  their crc (-Fcrc:y) and displaying their corresponding computed crc (-Fc) 
  and skips computing any files found that have suffixes of '.zip' or '.rar'
   
cssdir -Sr:2000000,$ f:\ -Wc:*.zip;*.rar;*.gz -s -os
   lists all the (non-hidden and/or system) files with an extension of .zip,
   .rar, or .gz anywhere on drive f which are 2000000 or greater in size
   (bytes) and sorts them in ascending size order.

cssdir c: -s -o-gsf -a
   lists all the files and the subdirectories of the current working directory
   on drive c, listing the files sorted by ascending size and then by 
   full filename specification, following by directories sorted by their
   full filename/directory specification.

cssdir c:\ d:\ e:\ -s -o*dups-asc -Fcrc:y -Fc -Ecrc:y -Ec -Of:c:\tmp\dupsCDE
   -X:c:\tmp\dupsCDE   

   (remember to set environment variable cssdirTMP to a scratch working
   directory before running this example or use the -Tdir: option) lists all
   potential duplicate files that span over drives c, d, and e, and output the
   results to the data file c:\tmp\dupsCDE, exclude the c:\tmp\dupsCDE from
   this analysis. [Please note depending on the drive sizes and contents this
   could take a while to finish. On approx one gigabyte boot partitions with
   about 14000 files and 850meg of data it takes about 5 minutes with a 1.2ghz
   amd processor, On a faster machine with 1733mhz (2100+) amd with 46000+
   files and over 5 gig of data I have seen it take under 10.5 minutes.] In
   the listing of possible duplicates include the CRC of the files data (-Fc)
   and include a files ea CRC (-Ec).

cssdir c:\basetree1 g:\basetree1 -s -a -Uf: -Uq
   lists all the unique files that exist between c:\basetree1 and 
   c:\basetree2 and their subdirectories and show which fields are unique.

cssdir c:\basetree1 g:\basetree1 -s -a -Uf:-D -Uq2
   lists all the unique files that exist between c:\basetree1 and c:\basetree2
   and their subdirectories ignoring timestamps in the determination of
   uniqueness, and place the unique field on the left of the listing (-Uq2)
   just before the -De field.
   
cssdir @dirspecs -Fcrc:y -Fc -Ey
   lists all the files that match the directory specifications while also 
   doing CRC computations and include those Calcuations in the listing, number
   them as well. The directory specifications are read from the dirspecs file
   found in the current directory, 1 dirspec per line. PRO license required.

cssdir c:\ -s -o*summary -List:/1
   lists the summary of drive c with all the total options fields with a
   setting of one, this include easizes totals, file size totals, archive 
   bits totals, free space on drive c, and a number of other totals.

cssdir c:\*.zip -s -o*summary
   lists the summary totals for files with the extension .zip on drive c.

cssdir c:\ -s -a -List:/oS;/oen/Fn2/Ff3
   produces two lists for all files on drive c, first listing will be sorted 
   by ascending filesize, the second will be sorted first by file extension
   and then by filename and includes the filename extension format which is
   aligned by filename and then aligned by file extension following by full
   file specification.

cssdir -Dumpo:a -a -on
   dumps all active option settings and all files in the current directory
   sorted by their filenames.

cssdir -s | more
   lists files (including subdirectories) and pipe to the paging program more

cssdir -s 2>&1 |more
   same as above but also paginate stderr: as most users would expect.

cssdirm -s
   same as above but use the included rexx shortcut script

examples with output:
*********************
[F:\os2]cssdir f:\os2\tr* -Fcrc:y -Fc
*** cssdir ver 1.01 Pro Copyright (c) 2003 Curtis Systems Software P.C. ***
searching for entries in <"F:\os2\tr*">
11-15-00  7:39p         56064 F70FA9E4         49 trace.exe
11-15-00  3:45p        232067 1E83ABF0       5583 tracefmt.exe
10-06-00  9:10p         29930 3E3C76D6          0 traceget.exe
 9-05-00  4:55p          4026 4B33DC92          0 TRADEMK.ICO
11-15-00  7:35p         34185 32148B7D          0 TREE.COM
10-06-00  9:01p          2448 557DBCA2          0 trfgrn.ico
10-06-00  9:01p          2448 0BD1F271          0 trfred.ico
10-06-00  9:10p         42054 5478CC55         49 trspool.exe
*              NumEntries:               8
*            SumFileSizes:          403222 bytes
*      free space drive F:      1029718528 bytes; 49.1% Free; 'ECOMSTATION  '

[F:\os2]set cssdirtmp=g:\tmp

[F:\os2]cssdir f:\os2\tr* -Fcrc:y -Fc -Ec -Ecrc:y
*** cssdir ver 1.01 Pro Copyright (c) 2003 Curtis Systems Software P.C. ***
searching for entries in <"F:\os2\tr*">
11-15-00  7:39p        56064 F70FA9E4         49 232FC863 trace.exe
11-15-00  3:45p       232067 1E83ABF0       5583 7E27878F tracefmt.exe
10-06-00  9:10p        29930 3E3C76D6          0        0 traceget.exe
 9-05-00  4:55p         4026 4B33DC92          0        0 TRADEMK.ICO
11-15-00  7:35p        34185 32148B7D          0        0 TREE.COM
10-06-00  9:01p         2448 557DBCA2          0        0 trfgrn.ico
10-06-00  9:01p         2448 0BD1F271          0        0 trfred.ico
10-06-00  9:10p        42054 5478CC55         49 232FC863 trspool.exe
*              NumEntries:               8
*            SumFileSizes:          403222 bytes
*      free space drive F:      1029718528 bytes; 49.1% Free; 'ECOMSTATION  '

[F:\os2]cssdir f:\os2\tr* -Fcrc:y -Fc -Ec -Ecrc:y -Ll -Ff3
*** cssdir ver 1.01 Pro Copyright (c) 2003 Curtis Systems Software P.C. ***
searching for entries in <"F:\os2\tr*">
  Date    Time      FileSize  FileCrc     EaSize   EaCrc  file specification
11-15-00  7:39p        56064 F70FA9E4         49 232FC863 F:\os2\trace.exe
11-15-00  3:45p       232067 1E83ABF0       5583 7E27878F F:\os2\tracefmt.exe
10-06-00  9:10p        29930 3E3C76D6          0        0 F:\os2\traceget.exe
 9-05-00  4:55p         4026 4B33DC92          0        0 F:\os2\TRADEMK.ICO
11-15-00  7:35p        34185 32148B7D          0        0 F:\os2\TREE.COM
10-06-00  9:01p         2448 557DBCA2          0        0 F:\os2\trfgrn.ico
10-06-00  9:01p         2448 0BD1F271          0        0 F:\os2\trfred.ico
10-06-00  9:10p        42054 5478CC55         49 232FC863 F:\os2\trspool.exe
*              NumEntries:               8
*            SumFileSizes:          403222 bytes
*      free space drive F:      1029718528 bytes; 49.1% Free; 'ECOMSTATION  '

[F:\]cssdir -o*summary f:\ -s -List:/1/Di3  -a
** cssdir ver 1.01c PRO Copyright (c) 2003 Curtis Systems Software P.C. **
searching for entries in <"F:\">
*[BEG -List:/1/Di3]*
++[  1a] <"F:\">
*[ 
'-List:/o:*SUMMARY/Uf:KDSCZBA/Ufao:ADSHR/Lp/Sl/Lh/Ll/Ab/Hb/Rb/Sb/Cb/Nd/Nf/Ne/
Ns/Ef/Se/Sf/Ts/Di3' ]*
*      archive   bit set entries:    15230
*      hidden    bit set entries:       26
*      readonly  bit set entries:      246
*      system    bit set entries:       27
*      all bits cleared  entries:       25
*          Numdirectories:            1736
*                NumFiles:           15450
*              NumEntries:           17186
*       non 0 EasizeFiles:            4431
*              SumEasizes:         9285956 bytes
*            SumFileSizes:      1051986612 bytes
*              TotalSizes:      1061272568 bytes
*      free space drive F:      1011088896 bytes; 48.2% Free; 'ECOMSTATION  '
*         size of drive F:      2097414144 bytes; 51.8% Used; E7C9-A014

[F:\]cssdir -ogs     f:\ -s -aH -Te0 -De0
*** cssdir ver 1.01 Pro Copyright (c) 2003 Curtis Systems Software P.C. ***
searching for entries in <"F:\">
        <DIR>          0 hide
        <DIR>        325 os2\ARCHIVES\03\DESKTOP\Templates\Folder!1
        <DIR>        381 Nowhere
        <DIR>        325 Desktop\Templates\Folder!1
        <DIR>        325 os2\ARCHIVES\CURRENT\DESKTOP\Templates\Folder!1
        <DIR>        325 os2\ARCHIVES\01\DESKTOP\Templates\Folder!1
        <DIR>        325 os2\ARCHIVES\02\DESKTOP\Templates\Folder!1
        <DIR>        325 os2\ARCHIVES\0x\DESKTOP\Templates\Folder!1
        <DIR>        325 os2\ARCHIVES\0x\DESKTOP\eCS System\Templates\Folder!1
            0          0 os2\OS2.!!!
            0          0 os2\L97CORRT.!!!
            0          0 MMOS2\LTCACHE.!!!
            0          0 MMOS2\MMCLSSET.!!!
            0          0 MMOS2\MMPM.!!!
            0          0 IBMLAN\NETPROG\NETMSG.!!!
            0          0 os2\L97USER.!!!
            0          0 os2\OS2SYS.!!!
          354          0 WP ROOT. SF
          660          0 io32.sys
         1024          0 os2\system\RAS\ERRSAV.DAT
         5606          0 WiseMachine.fit
        15005          0 os2dump
        21504          0 VirtualPC\WIN\Application Data\Connectix\Virtual 
PC\VPCKeyboard.dll
        44544          0 OS2LDR
        51132          0 OS2BOOT
       850253         54 OS2KRNL
*              NumEntries:              26
*            SumFileSizes:          990082 bytes
*      free space drive F:      1029718528 bytes; 49.1% Free; 'ECOMSTATION  '

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