    ******************************************************************************
       (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>