******************************************************************************
   (C) Copyright 2003-2006 Curtis Systems Software P.C. All rights reserved.
               (last update: 2006 Nov)
******************************************************************************
Manual for Snapshot compare mode features of CSSDIR 
  OS/2/eComStation version 3.25 GA and Windows 1.03 GA
(for non snapshot compare mode cssdir features see cssdirMainManual)
                
Table of Contents
(A.) Cssdir Snapshot compare mode Section:
(B.) Examples comparing snapshots with CSSDIR Section:
(C.) Brief    Options help Section:
(D.) Detailed Options help Section:
(E.) Options Summary Alpha Sorted Table Section:
(F.) other snapshot compare mode notes Section:
******************************************************************************

(A.) Cssdir Snapshot compare mode Section:
******************************************
The snapshot compare mode of cssdir is currently available to professional 
license holders of cssdir at no additional charge (this may change in the 
future). This facility provides a way to detect all file changes that have 
occurred to filesystems that cssdir can gather data on with regards to a 
file's contents, EAs (OS/2 and eComstation), attributes, size, date last 
updated, etc.

Many of the same options that are available during cssdir normal mode (non 
snapshot compare mode NSCM) are also available in the snapshot compare mode 
(/Sscm), some are identical while others are not. There are also a number of 
new options that only apply in the /Sscm (snapshot compare mode). In many 
cases the reader is directed to reference the other documentation 
(cssdirMainManual) for a more complete description of options that are 
similar if not identical between cssdir modes of operation.

To get access to cssdir's snapshot compare mode and its online help with 
cssdir.exe, One must have a professional license and then invoke cssdir with 
the option /Sscm. This option must come immediately after the cssdir program 
name. In this mode cssdir.exe will compare any two compatible snapshot cssdir 
produced files. The generation of those files need to contain specific 
formatted output for cssdir's snapshot compare mode to operate properly. 
Cssdir will then find any file changes that occurred between one snapshot and 
another snapshot. The symbolic definition /$snapshotlist$/ in cssdir.cfg 
provides all the necessary option settings to produce a valid snapshot file 
for later comparison with the /Sscm cssdir option. For example if you would 
like to snapshot your active boot drive, one would invoke the following 
command:
cssdir /$snapshotlist$/ /$$bdrv$/:\ /s > bdrv1.ss

At a later time one would re-invoke the above command but would give a 
different output file name, such as bdrv2.ss instead of bdrv1.ss. After doing 
this one could find all the differences (if any) between the two snapshots by 
invoking:
cssdir /Sscm /Ssnf:bdrv2.ss /Sspf:bdrv1.ss

This would produce a default listing of all the file differences between the 
two snapshot files bdrv2.ss and bdrv1.ss. Cssdir /Sscm has a multitude of 
options which allows the user to also filter out as much information as they 
would like and also define what and how each file's related field should be 
displayed.

The snapshot mode cssdir is a very flexible baseline utility which can 
determine exactly what files have changed including file attributes and even 
Eas (OS/2 and eComstation). The user can also produce a list of bare filespecs 
that can be fed into an archiving utility (such as zip or infozip). Much of 
the flexibility of the normal mode cssdir program (in non snapshot compare 
mode) is also available in the snapshot compare mode (/Sscm). This includes 
the functionality of multiple reports in one invocation, multiple reports to 
separate files with very flexible and similar file fields layout (/Lxlo:) user 
adjustments.

System admins should really appreciate the /Sscm feature and other available 
options in the snapshot compare mode of cssdir.

(B.) Examples comparing snapshots with CSSDIR Section:
******************************************************
See the included examples. Trying 
out some of the examples while referencing this document is probably the 
fastest way to utilize CSSDIR's snapshot flexible compare facility.
******************************************************************************

(C.) Brief    Options help Section:
***********************************
Below lists the basic online help for cssdir's snapshot compare mode which is 
reproducible for CSSDIR, by invoking 'cssdir /Sscm /h' or 'cssdir /Sscm /?'. 
For more eXtended online help use '/hx' or '/?x' instead of '/h' and '/?'.


[start inserted cssdir /h follows]
(also same for windows version 1.02)
$Help for cssdir 3.2 Copyright (c) 2003-04 Curtis Systems Software P.C.
usage follows: cssdir /Sscm [options]

 option   default    decription
 /hx                display eXtended help
 /h                 display help
 /?x                alternative way to display eXtended help
 /?                 alternative way to display help
 -hx                alternative way to display eXtended help
 -h                 alternative way to display help

 **** NORA - non OverRideAble options (1 setting per CSSDIR invocation) ****
 /00                zero normal output options;
 /BD                initialize cssdir options to out-of-the-Box Defaults
 /Ce     [0]        Combine stderr to stdout; useful for 'more' 1,2,3
 /Crlp:  []         compare request list primary 
 /Crls:  []         compare request list secondary
 /Dumpo: [N]        dump options /Sscm settings Y/N
 /Of:    [stdout:]  outFile[/ANOMTY] A=append N=new O=overwrite M=mult T=time 
 /Pt     [0]        ProcessTime rec 1=tot 2=gather(if applicable) 3=1+2 4=all
 /Ssnf:  [ssnf]     new      snapshot file (input); compare against /Sspf:
 /Sspf:  [sspf]     previous snapshot file (input); compare against /Ssnf:
 /Ve:    [2]        verbose level 0=off 1=basic 2=SYM translation 3=DefArgs ..
 /Vn:    [1]        display version 0=off 1=basic 2=all

 **** /List: and LORA* (/List: OverRideAble options) ****
 /List:  [/*]       list of orders
          ** /List: displayable field (Lf) options **
          (/Lxlo: ='master' on/off switch of Lf options, see below)
 /Lfa    [8]        Attribute
 /Lfb    [0]        eaCrc            
 /Lfc    [0]        fileCrc          
 /Lfd    [1]        Date             1=yyyy-mm-dd 2=1
 /Lff    [3]        FileSpec         1=relFSpec 3=fullSpec
 /Lfh    [1]        hintString       0, 1=[SHC] <4chars> 8=1
 /Lfm    [1]        dir flag         1=trailing \ 2=.\ and \.\ trailing   
 /Lfn    [0]        fileName         1=1st 30 chars + '/' 6=1
 /Lfp    [1]        Show delta filesize 1=regular 2=percentage 3=1+2
 /Lfr    [0]        Reference Num    1=refNum+, 2=1
 /Lfs    [1]        fileSize         1=with <DIR> +, 3=1
 /Lft    [1]        Time             1=hh:mm:ss  ; 2=1
 /Lfu    [1]        Unique file      1=on
 /Lfx    [3]        number entry     1=8digits 2=7dig 3=6dig 4=5dig 5=4dig 6= 
 /Lfz    [1]        EaSize           1=regular +,; 2=1
          ** /List: displayable record (Lr) options **
 /Lrlh   [0]        ListingHead      1=head 2=tail 3=both
 /Lrll   [3]        listingLabel     1=head 2=tail 3=both
 /Lrlp   [0]        ListOptionProc   1=head 2=tail 3=both
 /Lrsl   [0]        shorthandList    ; list codes for basePath of dirSpec     
 /Lrtbeg:[]         listTitle        ; for multiple lines; !=cr/lf
 /Lrtend:[]         ending listTitle ; for multiple lines; !=cr/lf
 /Lrto   [0]        snapshot totals  0=off 1=all recs 2=1+force /Lxspc: style
          ** /List: other (Lx) options **
 /Lxcf:  []         snapshot compare fields '/Lxcf:' = /Lxcf:DAZBSCK        
 /Lxlo:  [XDTSPCZBAURNHFM] Lf layout  /Lxlo:[ABCDFHMNPRSTUXZ]
  /Lxmf:  []         Lora miscFlags   [23456] 2=ignore dir2dir dates ....      
 /Lxsrdd:[*]        snapshot delta list size direction *=all -=neg+0 +=pos+0
 /Lxsrds:[ALL]      snapshot delta size range
 /Lxsrdp:[OFF]      snapshot delta %chg range
 /Lxspc: [0]        show prev change record(from /Sspf:); 0=off 1=show
 /Lxuff: []         UniqFile Visible filter [KDSCZBA-*$]
 /Lxut:  [ACD]      unique type [ACD] A=add(new) C=changed D=delete
 /Lxxao: []         ignore /Lfa specific attributes [ADHRSTCOE#] | *ALL
 /Lxxbo: []         exclude /Lfb negative value records [1234]
 /Lxxco: []         exclude /Lfc negative value records [12345]
 /Lxxso: []         exclude /Lfs negative value records [1]
 /Lxxzo: []         exclude /Lfz negative value records [1]

 **** Environment variables of interest: ****
 cssdirDefArgsSscm  ;used for your default /Sscm options preferences
 cssdirCfg          ;used for your powerful symbolic user definable strings
 cssdirSymProcessing; '=Show' to show Symbolic processing

 **** default /Lxlo:XDTSPCZBAURNHFM (Layout of horizontal fields)  ****
 desc: ### dat tim siz chg fcr esz ecr att  uq rn  fn   hs fil '\'
  opt: Lfx Lfd Lft Lfs Lfp Lfc Lfz Lfb Lfa Lfu Lfr Lfn Lfh Lff Lfm
 sets:  7   2   2   2   4   2   2   2   5   2   2   2   3   3   3

 ** Visit us and purchase at www.curtisSystemsSoftware.com **
 Current registered license=PRO. Thank You! Need another license or licenses
 to stay legal and to help pay for the significant investment in producing
 this product and for future enhancements and support? Quantity discounts
 available. Suggestions and constructive comments welcome at above website.
 Copyright (c) 2003-04 Curtis Systems Software P.C. All Rights Reserved.
[end inserted cssdir /h]
******************************************************************************
 
(D.) Detailed Options help Section:
***********************************
The following describes in detail all of the options available when invoking 
the CSSDIR program in /Sscm (snapshot compare mode). Some options may also be 
overridden within the context of the /List: option. LORA* [(L)ist 
(O)ver(R)id(A)ble options)] are such options and include: /Lrtbeg: /Lrtend: 
/Lxcf: /Lxlo: /Lxmf: /Lxspc: /Lxsrdd: /Lxsrdp: /Lxsrds: /Lxuff: /Lxut: /Lxxao: 
/Lxxbo: /Lxxco: /Lxxso: /Lxxzo: /Lfa /Lfb /Lfc /Lfd /Lff /Lfh /Lfm /Lfn /Lfp 
/Lfr /Lfs /Lft /Lfu /Lfx /Lfz /Lrlh /Lrll /Lrlp /Lrsl and /Lrto.

Note: in the following individual option descriptions the format follows: 
first the option name is listed followed by [in brackets] its default setting 
and then a lengthy description. Also note the option themselves are case 
sensitive, you will get an error if you try to use /LFA instead of /Lfa. Most 
options start with a leading uppercase letter and are followed by all 
lowercase letter(s) and perhaps a colon. 

option   default    description
/hx                display eXtended help
/h                 display help
same as /hx and /h in cssdir in non snapshot compare mode, NSCM.

/?x                same as /hx and -hx
/?                 same as /h  and -h

** NORA- non OverRideAble options (1 setting per CSSDIR /Sscm invocation) **
----------------------------------------------------------------------------
/00                zero normal output options; need subsequent opts for non
                   error output ... Currently All /Lf and /Lr options are
                   set to '0' or blank; as well as /Ve: /Vn:

/BD                initialize cssdir options to out-of-the-Box Defaults

/Ce     [0]        Combine stderr to stdout; 
Same as cssdir in NSCM.

/Crlp:  []         compare request list primary
If this option is blank, all request lists in /Ssnf: are compared to all 
request lists in /Sspf: request lists. One can also set this to do specific 
request lists, syntax is: /Crlp:<shc>[,branch;[<shc>][,branch ...]]. 

Example 1: /Crlp:1a;2a;4c;  
Would have cssdir compare only request lists between /Ssnf: file and /Sspf: 
file that had short hand codes <shc>: 1a followed by 2a followed by 4c.

Example 2: /Crlp:1a,os2;2a;  
Would have cssdir compare only request lists between /SSnf: file and /Sspf: 
file that had short hand codes <shc>: 1a with all branches that began with os2,
 followed by all branches that started with 2a. Please note that the <shc> is 
case sensitive, while the branches are not. To find out what short hand code 
lists are available one could invoke cssdir /Sscm /Lrsl  or view/edit the 
specific snapshot files and look for lines beginning with 'sl>'. Also see 
option /Lxmf:4

/Crls:  []   compare request list secondary
If this option is blank then /Crlp: totally dictates what will be compared 
between /Ssnf: and /Sspf:. However if /Crlp: is non blank and /Crls: is 
defined then the number of list(s) in /Crls: must match the number of list(s) 
in /Crlp:. When /Crls: is defined then the corresponding element in /Crlp: is 
compared against it. i.e.
cssdir /Sscm /Crlp:1a;2b;  /Crls:2a;3c /Ssnf:snapshot1 /Sspf:snapshot2
Would mean to compare 1a of snapshot1 to 2a of snapshot2 followed by a 
comparison of 2b of snapshot1 to 3c of snapshot2, all other request lists (if 
any) are ignored.

cssdir /Sscm /Crlp:1a,branchA; /Crls:3d,branchW; /Ssnf:ssA /Sspf:ssB
Would mean to compare 1a with branchA of ssA to 3d with branchW of ssB. Also 
see option /Lxmf:4

/Dumpo: [N]        dump options settings Y=yes N=no 
Similar to cssdir in NSCM, but limited to just suboptions Y or N.

/Of:    [stdout:]  outFile[/ANOMTY]                                          
same as cssdir in NSCM, see cssdirMainManual

/Pt     [0]        ProcessTime record
same as cssdir in NSCM.

/Ssnf:  [ssnf]     snapshot NEWer file to compare /Sspf: file too.

/Sspf:  [sspf]     snapshot Previous(older) file to compare /Ssnf: file too.

/Ve:    [2]        verbose level 0=off 1=basic 2=more 3= still more ....
Similar to cssdir in NSCM.

/Vn:    [1]        display version 
Similar to cssdir in NSCM.

**** /List: and LORA* options ****
----------------------------------
/List:  [/*]       list of orders
Similar to cssdir NSCM, with many similar and new suboptions.

** LORA* displayable field (Lf) options **
------------------------------------------
/Lfa    [1]        LORA* Attribute        1=8 3=dirlike(ashr) 7=hexcode ...
Similar to cssdir NSCM corresponding option.
1=8 in NSCM
7=7 in NSCM (hexcode 8 hex chars)
3=3 in NSCM (dir /v like)
8=8 in NSCM (hexcode:TadshrTCOEVLNP#)

/Lfb    [0]        LORA* EaCrc field
Similar to cssdir NSCM.

/Lfc    [0]        LORA* FileCrc field
Similar to cssdir NSCM.

/Lfd    [1]        LORA* Date Field  1=yyyy-mm-dd  2=1
Similar to cssdir NSCM.

/Lff    [3]        LORA* FileSpec field
Similar to cssdir NSCM, with less suboptions
  1=relative fileSpec
  3=full fileSpec (with drvLtr: or UNC)

/Lfh    [1]        LORA* hintString       
Similar to cssdir NSCM, with less suboptions, only SHC is supported. 
1=[SHC] <4chars> 8=1

/Lfm    [1]        LORA* directory flag
Same as cssdir NSCM. However if '\' was already appended, /Lfm0 will not 
remove them. /Lfm1 and /Lfm2 will not add additional '\' or '.\' if already 
appended, /Lfm2 will append '.\' as needed

/Lfn    [0]        LORA* FileName (no path included) field 
Similar to cssdir NSCM, with less suboptions
 1= limits filename + extension to 30 chars, if filename had to be chopped to 
fit an asterisk is used; also append a '/' at end of this field. 6=same as 1.

/Lfp    [1]       LORA* Show delta filesize 1=bytesize diff 2=percentage 3=1+2
'/Lfp1' or just '/Lfp' displays the delta change field in bytes between 
snapshots for a given file, /Lfp2 displays the percentage of change from old 
snapshot (/Sspf:) to new snapshot (/Ssnf:). /Lfp3=1+2.

/Lfr    [0]        LORA* RefNum field; 
Similar to cssdir NSCM, with less suboptions. 1= ref number +, and 2= 1.

/Lfs    [1]        LORA* FileSize field 
Similar to cssdir NSCM, with less suboptions. 1=regular +, 3=1
 
/Lft    [1]        LORA* Time field 
Similar to cssdir NSCM, with less suboptions, 1=hh:mm:ss 2=1

/Lfu    [1]        LORA* Unique file field
Similar to cssdir NSCM.
The contents of the differences between snapshots have the following meaning:
a leading 'n>' means its from the /Ssnf: file
a leading 'p>' means its from the /Sspf: file
a 'S' means existing files size has changed
a 'C' means existing files crc  has changed
a 'c' means existing files crc was not computed but match both snapshots 
a 'Z' means existing files eaSize has changed
a 'D' means existing files date/time has changed
a 'A' means existing files attribute(s) have changed 
      (for finer control on attributes see /Lxxao:.)
a 'B' means existing files eaCrc has changed
a 'b' means existing files eaCrc was not computed but match both snapshots
a (+file) means the file is new in the /Ssnf: snapshot file
a (-file) means the file is deleted in the /Ssnf: snapshot file

Note: if existing file differs only with 'c' or 'b' one could eliminate it 
being listed, see /Lxxbo: and /Lxxco: options. Also see /Lxxso: and /Lxxzo:.

/Lfx    [3]     LORA* entry Field 1=8digits 2=7dig 3=6dig 4=5dig 5=4dig 6=3dig
Same as cssdir NSCM.

/Lfz    [1]        LORA* EaSize field
Similar to cssdir NSCM.

Please note all options described above that start with /Lf will not be 
displayed if the master on/off switch /Lxlo: (described below) does NOT ALSO 
include them. Similar to cssdir NSCM.

** LORA* displayable record (Lr) options **
-------------------------------------------
/Lrlh   [0]        LORA* ListingHead  record 
same as cssdir NSCM.

/Lrll   [3]        LORA* listingLabel record 
same as cssdir NSCM.

/Lrlp   [0]        LORA* ListOptionProc   record(s) 
same as cssdir NSCM.

/Lrsl   [0]        LORA* shorthandList records
Similar to cssdir NSCM.

/Lrtbeg:[]         LORA* listTitle
same as cssdir NSCM.

/Lrtend:[]         LORA* ending listTitle
same as cssdir NSCM.

/Lrto   [0]        snapshot totals  0=off 1=all recs 2=1+force /Lxspc: style
A number of Total records. Such output records will have records that start 
with 'to>'. /Lrto2 means force longer format of displaying results that also 
factor in additional previous data records that may be included if /Lxspc:1 is 
set ...Note: /Lrto1 will take on /Lrto2 format if /Lxspc:1 is set.

** LORA* other (Lx and o) options **
------------------------------------
/Lxcf:  []         snapshot compare fields '/Lxcf:' = /Lxcf:DAZBSCK
This option decides which fields should be compared in determining if the file 
has changed between the two specified snapshots (/Ssnf: and /Sspf:).
         D compare relpath named files date
         A compare relpath named files attrib
         Z compare relpath named files easize
         B compare relpath named files eacrc
         S compare relpath named files size
         C compare relpath named files CRC
         K compare relpath named files CaseSensitiveName
         - ignore specified following field
use /Lxcf:-D-S-C-Z-B-A for unique filenames only. Add -K to also exclude 
filename case only differences. if /Lxcf:A is active, also see /Lxxao: to 
ignore specific attributes.

/Lxlo:  [XDTSPCZBAURNHFM] Lf layout  /Lxlo:[ABCDFHMNPRSTUXZ]
'/Lxlo:' (by itself) effectively turns off all /Lf options.
Similar to cssdir NSCM. One difference between NSCM and snapshot compare mode 
is that P in snapshot compare mode represents delta size change field, see 
/Lfp above.

/Lxmf:  []         Lora miscFlags   [23456]
2=ignore dir2dir dates
3=ignore file2file dates
4=turn off warnings when /Crlp: /Crls:are not found
5=ignore dir2dir   eaSize and eaCrc      
6=ignore file2file eaSize and eaCrc
Options 2 and 3 give some finer control instead of user resorting to ignoring
all dates with /Lxcf:-D, if /Lxcf:D dir2file or file2dir are still compared.
Options 5 and 6 give some finer control instead of user resorting to ignoring  
 all eaSize and eaCrc with /Lxcf:-Z-B, if /Lxcf:ZB dir2file or file2dir are 
still compared.


/Lxsrdd:[*]        snapshot delta list size direction *=all -=neg+0 +=pos+0
This can limit the files to be displayed by the direction of their delta 
change. '+' would not filter out any if their change was non-negative 
(includes positive values plus zero). '-' would not filter out any if their 
change was non-positive (includes negative values plus zero). And '*' doesn't 
do any special filtering out and is the default.
 
/Lxsrds:[ALL]      snapshot delta size range
This options allows the user to restrict files to display that have changed in 
size (bytes) within a specific range. i.e. /Lxsrds:100000,$. Means to include 
files that have changed by at least 100000 bytes.

/Lxsrdp:[OFF]      snapshot delta %chg range
This option allows the user to restrict files to display that have changed by 
a certain absolute percentage. Format is: minimum percentage to max 
percentage.
i.e to limit the files that have changed in size by at least 50% use:
/Lxsrdp:50,$. For files that have changed by at least 75% and have a minimum 
bytes size change of 25,000 use: /Lxsrdp:25000,75,$.

/Lxspc: [0]        show prev change record(from /Sspf:); 0=off 1=show
Set this option to 1 to display the corresponding "changed" old file (from 
/Sspf: snapshot file) in the listing.

/Lxuff: []         UniqFile Visible filter [KDSCZBA-*$]
    '/Lxuff:' is alias for /Lxuf:KDSCZBA  
    K visible if files CaseSensitiveName diff
    D visible if files date              diff
    S visible if files size              diff
    C visible if files CRC               diff
    Z visible if files easize            diff
    B visible if files eacrc             diff
    A visible if files attrib            diff
    - ignore specified following field              
    * means specified following field is a don't care
    $ means one of the fields marked by a preceding '$' must have field
      difference to be listed
Use /Lxuff:-D-S-C-Z-B-A for unique filenames only. Use -K to also exclude if 
case of filename (and extension) portion is different. To list only files that 
have (if any) kase and/or attribute and/or date/time difference use 
/Lxuff:$D$A-Z-B-S-C$K or the handy symbolic defined in cssdir.cfg 
/$kdaAnyOnly$/. /Lxuff: is basically a secondary filter to /Lxcf:, this allows 
more flexibility than just have /Lxcf:, especially when using the '$' above.

/Lxut:  [ACD]      unique type [ACD] A=add(new) C=changed D=delete
This option limits which snapshot differences should not be filtered out.
To get only new files that appeared in /Ssnf:, use /Lxut:A  to get only 
deleted
files use /Lxut:D. To get all use /Lxut:ACD  which is the default. To get only 
files that have changed use /Lxut:C.

/Lxxao: []         ignore /Lfa specific attributes [ADHRSTCOEVLNP#] | *ALL
By default cssdir /Sscm will display all not already filtered out records that 
have a certain file attributes. You may set all attribute bits you wish to 
ignore. Set /Lxxao:x (where x is one or more of the following 
chars:ADHRSTCOEVLNP#) to filter out such files if the file record is only 
being displayed for that attribute difference or those attributes 
difference(s) alone. This option is only referenced when used in conjunction 
with /Lxuff:A. '/Lxxao:' resets this option (ignores none).
    A ignore Archive   bit
    D ignore Directory bit
    S ignore System    bit
    H ignore Hidden    bit
    R ignore Readonly  bit
    T ignore temporary  bit  (don't care os/2, eCS)
    C ignore compressed bit  (don't care os/2, eCS)
    O ignore offline    bit  (don't care os/2, eCS)
    E ignore encrypt    bit  (don't care os/2, eCS)
    V ignore device     bit  (don't care os/2, eCS)
    L ignore sparse     bit  (don't care os/2, eCS)
    P ignore reparsePt  bit  (don't care os/2, eCS)
    N ignore notContIdx bit  (don't care os/2, eCS)
    # ignore other      bit(s)
    *ALL means to compare 32 bit word as well, (don't exclude any bits either)
If one uses '/Lxxao:A' then the archive bit is ignored in determining if a 
file is unique however the directory attribute bit (D), the system attribute 
bit (S), the hidden attribute bit (H) and the readonly attribute bits (R) are 
still considered in determining if a file is different and to be listed.

/Lxxbo: []         exclude /Lfb negative value records [1234]
By default cssdir /Sscm will display all not already filtered out records that 
have a negative value for a file's eaCRC (which indicates it was not obtained, 
see /Ecrc: and /Lfb option in cssdirMainManual /Lfb for the negative value 
meanings). Set /Lxxco:x (where x is 1,2,3, and/or 4) to filter this out if the 
record is only being displayed for that reason or those reason(s) alone. 
'/Lxxbo:' resets this option (excludes none).

/Lxxco: []         exclude /Lfc negative value records [12345]
By default cssdir /Sscm will display all not already filtered out records that 
have a negative value for a file's crc (which indicates it was not obtained, 
see /Fcrc: and /Lfc option in cssdirMainManual /Lfc  for the negative value 
meanings). Set /Lxxco:x (where x is 1,2,3,4, and/or 5) to filter this out if 
the record is only being displayed for that reason or those reason(s) alone. 
'/Lxxco:' resets this option (excludes none).

/Lxxso: []         exclude /Lfs negative value records [1]
By default cssdir /Sscm will display all not already filtered out records that 
have a negative value for a file's size (which indicates it could not be 
obtained). Set /Lxxso:1 to filter this out if the record is only being 
displayed for that reason alone. '/Lxxso:' resets this option (excludes none).

/Lxxzo: []         exclude /Lfz negative value records [1]
By default cssdir /Sscm will display all not already filtered out records that 
have a negative value for a file's easize (which indicates it could not be 
obtained). Set /Lxxzo:1 to filter this out if the record is only being 
displayed for that reason alone. '/Lxxzo:' resets this option (excludes none).

**** other related info ****
----------------------------
**** default /Lxlo:XDTSPCZBAURNHFM (Layout of horizontal fields)  ****
 desc: ### dat tim siz chg fcr esz ecr att  uq rn  fn   hs fil '\'
  opt: Lfx Lfd Lft Lfs Lfp Lfc Lfz Lfb Lfa Lfu Lfr Lfn Lfh Lff Lfm
 sets:  7   2   2   2   4   2   2   2   5   2   2   2   3   3   3

All fields can be turned on or off, or reOrdered. Use option '/Lrll' to label 
the fields and '/Lxlh' to show what options are active. See snapshot
examples.

special (shortcut) options available for the '/List:' option
/*   process order with current global settings

/=   set current options to previous order settings, if there is no previous
     order than set them to the current global settings

/1   set all of the following List options to have a setting of one: includes
    /1F (below), and /Lrlh /Lrll /Lrlp /Lrsl /Lrto.
    
/0   same as /1 but reset (set those options to have a setting of zero)

/BD  initialize cssdir options to out-of-the-Box Defaults for Lora options.

/1F  set all of the List field (Lf prefix) options to setting of 1, They are:
     /Lfa /Lfb /Lfc /Lfd /Lff /Lfh /Lfm /Lfn /Lfp /Lfr /Lfs /Lft /Lfu /Lfx 
     /Lfz
   
/0F  same as /1F but reset (set those options to have a setting of zero)
******************************************************************************

(E.) Options Summary Alpha Sorted Table Section:
***********************************************
In the following Option table:
A leading '*' denotes options can be used globally as well as specifically 
with the '/List:' option also known as a LORA* option. Each such option can be 
assigned a new global default (by simply using the option outside the /List: 
option) and then specifically overridden within the '/List:' option. For 
instance on the command line you might issue: 
'cssdir /Lff1 /Lfs1' 
To specifically override the default for a given option; Use the option in 
conjunction with the '/List:' option and place the given option immediately 
(with no spaces) against the /List: option.i.e. '/List:/*;/Lfs3', would use 
all the other defaults but would now override '/Lfs1' with a new setting of 
'3'. 

A leading '/' denotes options only available on a global basis or NORA option, 
i.e. NORA options are neither DORA* or LORA* options.

Option table:
-------------
* = can override within /List: option context, AKA LORA*
/ = available only on global setting, AKA NORA* 
also -h and -hx for help and eXtended help

Options sorted alphabetically follow:

option    default   decription
 -h                 alternative way to display help
 -hx                alternative way to display eXtended help
 /?                 alternative way to display help
 /?x                alternative way to display eXtended help
 /00                zero normal output options;
 /BD                initialize cssdir options to out-of-the-Box Defaults
 /Ce     [0]        Combine stderr to stdout; useful for 'more' 1,2,3
 /Crlp:  []         compare request list primary 
 /Crls:  []         compare request list secondary
 /Dumpo: [N]        dump options settings Y,N
 /h                 display help
 /hx                display eXtended help

** /List: displayable field  (Lf) options **
             *Lxlo: ='master' on/off switch of Lf options, see below)
 *Lfa    [1]        Attribute        1=dir 3=1
 *Lfb    [0]        eaCrc
 *Lfc    [0]        fileCrc
 *Lfd    [1]        Date             1=yyyy-mm-dd 2=1
 *Lff    [3]        FileSpec         1=relFSpec 3=fullSpec
 *Lfh    [1]        hintString       1=[SHC] <4chars> 8=1
 *Lfm    [1]        dir flag         1=trailing \
 *Lfn    [0]        fileName         1=name.ext 30 chars + '/' 6=1
 *Lfp    [1]        Show delta filesize 1=regular 2=percentage 3=1+2
 *Lfr    [0]        Reference Num    1=norm +, 3=1
 *Lfs    [1]        fileSize         1=with <DIR>+, 3=1
 *Lft    [1]        Time             1=hh:mm:ss  2=1
 *Lfu    [1]        Unique file      1=on
 *Lfx    [3]        number entry     1=8digits 2=7dig 3=6dig 4=5dig 5=4dig 6=
 *Lfz    [1]        EaSize           1=regular +,; 2=1
 /List:  [/*]      list of orders
          ** /List: displayable record (Lr) options **
 *Lrlh   [0]        ListingHead      1=head 2=tail 3=both
 *Lrll   [3]        listingLabel     1=head 2=tail 3=both
 *Lrlp   [0]        ListOptionProc   1=head 2=tail 3=both
 *Lrsl   [0]        shorthandList    ; list codes for basePath of dirSpec     
 *Lrtbeg:[]         listTitle        ; for multiple lines; #=cr/lf
 *Lrtend:[]         ending listTitle ; for multiple lines; #=cr/lf
 *Lrto   [0]        snapshot totals  0=off 1=all recs 2=1+force /Lxspc: style
          ** /List: other (Lx) options **
 *Lxcf:  []         snapshot compare fields '/Lxcf:' = /Lxcf:DAZBSCK        
 *Lxlo:  [XDTSPCZBAURNHFM] Lf layout  /Lxlo:[ABCDFHMNPRSTUXZ]
 *Lxmf:  []         Lora miscFlags   [23456] 2=ignore dir2dir dates ....      
 *Lxsrdd:[*]        snapshot delta list size direction *=all -=neg+0 +=pos+0
 *Lxsrds:[ALL]      snapshot delta size range
 *Lxsrdp:[OFF]      snapshot delta %chg range
 *Lxspc: [0]        show prev change record(from /Sspf:); 0=off 1=show
 *Lxuff: []         UniqFile Visible filter [KDSCZBA-*$]
 *Lxut:  [ACD]      unique type [ACD] A=add(new) C=changed D=delete
 *Lxxao: []         ignore /Lfa specific attributes [ADHRSTCOEVLNP#]
 *Lxxbo: []         exclude /Lfb negative value records [1234]
 *Lxxco: []         exclude /Lfc negative value records [12345]
 *Lxxso: []         exclude /Lfs negative value records [1]
 *Lxxzo: []         exclude /Lfz negative value records [1]

 /Of:    [stdout:]  outFile[/ANOMTY] A=append N=new O=overwrite M=mult T=time
 /Pt     [0]        ProcessTime rec 1=tot 2=gather 3=1+2 4=ALL
 /Ssnf:  [ssnf]     new      snapshot file (input); compare against /Sspf:
 /Sspf:  [sspf]     previous snapshot file (input); compare against /Ssnf:
 /Ve:    [2]        verbose level 0=off 1=basic 2=SYM translation 3=DefArgs ..
 /Vn:    [1]        display version 0=off 1=basic 2=all

**** default /Lxlo:XDTSPCZBAURNHFM (Layout of horizontal fields)  ****
 desc: ### dat tim siz chg fcr esz ecr att  uq rn  fn   hs fil '\'
  opt: Lfx Lfd Lft Lfs Lfp Lfc Lfz Lfb Lfa Lfu Lfr Lfn Lfh Lff Lfm
 sets:  7   2   2   2   4   2   2   2   5   2   2   2   3   3   3
******************************************************************************

(F.) other snapshot compare mode notes Section:
***********************************************
for any Error/warning/information message codes, or terms and agreement, see 
cssdirMainManual. For release notes see relNotes.htm

/Sscm Environment variables of interest: 
 cssdirDefArgsSscm - similar to cssdirDefArgs but used when in /Sscm, however 
its value is pasted immediately after the '/Sscm' with a space in between. 
Also see cssdir.cfg file about symbolic /$cssdirDefArgsSscm$/.

TIP: If you wish to dump a snapshot file with fields rearranged or perhaps
just the relative path and short codes expanded use the ssDummy file for one
of the files, either /Sspf: or /Ssnf:.

TIP: If you wish to maintain a directory's last written timestamp, that will 
be changed on a xcopy and/or unzipping an archive (that contains directories 
to be created), if possible capture that information with 'cssdir /00 /Lfd2 
/Lft2 /Lff3 /Lxlo:dtf'. And then remember to adjust file names and directory 
names in the generated file to the new transfer locations (I will call it 
'list'). Then run an undocumented and unsupported feature, (except for here) 
called 'cssdir /Util /Sflw @list' to set the contained entries last written 
timestamp as requested. You may also ignored directory to directory only date 
compares during /Sscm with /Lxmf:2. Before doing any cssdir /Util /Sflw 
operation one should BACKUP the affected files, at this time this feature is 
currently officially unsupported. Internally at CSS we needed this 
functionality and currently use it.

(OS/2 and eComStation)
If you are referencing a snapshot file in snapshot compare mode that was 
created by versions 3.10 or earlier of cssdir.exe, you will now need to use 
the ss31_32.cmd program on that file, to reformat the SHC (part of hint 
string), which needed to be expanded, and perhaps other field adjustments. 
This util reformats the given file and routes it to stdout:, you will need 
REXX available to use this utility. You will find the utility ss31_32.cmd in 
the utils subdirectory. 
Usage is: ss31_32  snapshotFile > reformattedSnapShotFile

   (C) Copyright 2003-04 Curtis Systems Software P.C. All rights reserved
******************************************************************************
123456789012345678901234567890123456789012345678901234567890123456789012345678
<end of document>