[ Back to Table of Contents ]
[ << ]
[ >> ]
XXCOPY TECHNICAL BULLETIN #27
From: Kan Yabumoto tech@xxcopy.com
To: XXCOPY user
Subject: XXCOPY Command Reference Functional Classification
Date: 2005-05-02 Revised for ver 2.92.4
====================================================================
Introduction:
This is the third technical bulletin featuring XXCOPY's switches.
With nearly 200 distinct command switches (and growing), a mere
alphabetical listing hardly helps new users who are looking for
a particular functionality in XXCOPY. The more power that is
added with each new switch seems to be offset by the extra burden
in locating the needed feature, thus possibly making the program
harder to use. It is this irony that prompted me to try it again.
The emphasis in this article is not the details, but the
relationships of one another. The bigger picture in this article
hopefully helps you retain what you read in here. Therefore, the
description of each switch is limited to a terse single-line
format. For a more complete description, you should look up the
alphabetic listing XXTB #26.
Taxonomy of XXCOPY command line components
The XXCOPY command switches can be grouped into several large
groups. They are further divided into sub-categories by the
nature of the action they perform. The following table should
serve you as a quick reference card.
Group Examples
------------------------------------------------------------------------
1. Action selectors
1.1 Copy (default) /COPY
1.2 Move (copy-and-delete) /RC
1.3 Remove /RS /RD /RX /RMDIR
1.4 Modify-Attributes /AA /AZ /ANxx /ARxx /ASxx /ARDxx /ASDxx
1.5 SFN/LFN adjustment /NL /NS
1.6 Installation and license /INSTALL /LICENSE
(1.7) (List/Find /L ) see 3.1
2. File Selectors
2.1 Source Specifier (not a switch)
2.1.1 Volume
2.1.2 Base Directory
2.1.3 Directory template with wildcards
2.1.4 Filename template with wildcards
2.2 By the characteristics of the source file
2.2.1 by Alternate Filename /IN (name pattern)
2.2.2 by Exclusion /X (dir/name patterns) /EX
2.2.3 by File Date /DA: /DA# /DB: /DB# /Do:
2.2.4 by File Size /SZ: /SZ!
2.2.5 by File Attributes /H /A /M /AT /AX
2.3 By comparison with the file in destination
2.3.1 by Presence/Absence /BB /U
2.3.2 by File Date /BN /Bo /BX /DA /DB /DS /DX
2.3.3 by File Size /BZE /BZS /BZL /BLX
2.3.4 by Combination /BI /BE /BS /BU /CLONE
3. Action Modifiers
3.1 Console Output /EC /ZS /Q /F /L
3.2 Screen and Log output control /oDx/oEx/oFx/oIx/oPx/oSx/oXx/oQ
3.3 Log File and List File /oA /oN /Fo /FM
3.4 Subdirectories /S /E /T /ED /DL
3.5 File Gathering /SG /SGF/SGN/SGo
3.6 Directory Flattening /SL /SR /SX /SLR/SRR/SXR
3.7 File Name Treatments /NX /NX0/N /NP /ND /NW
3.8 File Name Case Control /NC0/NCL/NCU/NCX
3.9 File Time Treatments /FA /FC /FL /FU /FW /FF
3.10 Timestamp Control /TTA/TCA/TCC/TCW
3.11 Time Zone Adjustments /TD /TS
3.12 File Attributes /AC /R /K /KD /KN /KS
3.13 Limiting the Size in Copying /TR
3.14 File Removal /Z /ZY /RC /RS /RD /RX
3.15 Quota on File Operation /QF /QBL/QBT/QSL/QST
3.16 Verify After Copy /V /V0 /V1 /V2 /VE
3.17 Cyclic Copy Handling /CC /CC0 /CCY
3.18 Security Information /SC /SF
3.19 Checking Remaining Space /CK /CK0
3.20 Prompt Control /YY/I/W/WS/WE/P/PC/PN/Po/Y/PD/PZ/WD/ZY/RxY/CCY
3.21 Progress Bar /PB /PBH /PBH0
3.22 List Tree /LTREE
3.23 Error Handling /C /CB /CBQ/CR /CE
3.24 Check Condition /IA /IP /ILS /ILD
3.25 Debug and Test /DEBUG /DEBUGX
3.26 Cache Control /CA
3.27 Miscellaneous /ER /NI /SP /MD
3.28 Help /? /HELP /HELPA /HELPE
3.29 DATMAN-Specific Features /J /0 /1 /G
4 Command Entries
4.1 Environment Variables XXCOPY XXCOPYX COPYCMD
4.2 Environment Variable Control /ZE /ZX /ZX0
4.3 Command File /CF
4.4 Macro Reference /$xxxx$
4.5 Environment Variable /%xxxx%
4.6 Offset for Macro Time Values /TM0/TM+/TM-
------------------------------------------------------------------------
Notation:
In this article, minor variations which are designated by
additional suffix letters are collectively denoted by one or
more lowercase x (such as Lxxx). Literal character X in the
command switch is shown in uppercase X.
With only a few rare exceptions, XXCOPY's command switches
are case-insensitive. In order to help you distinguish the
letter O (Old) from the digit 0 (zero), the lowercase o is
used in this article for the switch alphabet which is more
distinct than the uppercase counterpart in most fonts.
=================================================================
1. Action Selector Group:
Once upon a time, XXCOPY was just a file copy utility.
Now, it is a multi-function file management tool. The
switches in this group specify what is the primary goal
of the current job.
1.1 Copy (default)
/COPY Copies files/directories (default).
This switch exists mostly for a figurative reason.
Since it is the default mode of operation, most
users do not type this switch. Even our command
line examples do not show this.
1.2 Move (copy-and-delete)
/RCx This is a variation of the Remove command group.
This function performs a regular copy operation
which is followed by a file remove operation if
the copying step is successful. The net effect
of this operation is equivalent of moving the
file from the source to the destination.
1.3 Remove
This group has three variations of file remove
operation depending on the location of the files.
/RSx Removes files/directories from the source.
/RDx Removes files which would be overwritten.
/RXx Removes files that are not in the source.
/RMDIR Similar to the DELTREE utility. Same as /RS/S/H/R/PD0.
1.4 Modify-Attributes
/AA Sets the Archive bit.
/AZ Clears the Archive bit.
/ANxxx Sets the whole file attributes with a new value.
/ASxxx Sets the selected file attribute bits.
/ARxxx Resets the selected file attribute bits.
/ASDxx Sets the selected dir attribute bits.
/ARDxx Resets the selected dir attribute bits.
1.5 SFN/LFN adjustment
/NL Attaches a long filename to the files in destination.
/NS Attaches a short filename to the file in destination.
1.6 Installation and license
/INSTALL Installs XXCOPY on a new computer (also for update).
/UNINSTALL Uninstalls XXCOPY from a computer.
/LICENSE Displays the license status.
/HOSTS Displays the list of remote hosts accessed by XXCOPY.
(1.7) List/Find
The List/Find function is implemented as an Action
modifier to any operation in the Action Selector group.
When an /L switch is added to the command line,
the action will not be carried out except that the
result of file selection process will be shown using
the customized output format. This function does not
really belong here, but to the action modifiers
(Section 3.1). See XXTB #26 for detail.
/L<items> Lists the file without any file action.
2. File Selector Group:
The switches in this group determines what files are to be operated
upon by the current action specified by the parameter in the
Action Selector Group.
The source specifier (2.1) and the /IN switch collectively determine
the set of files to be included in the operation. You may specify
as many /IN switches for more patterns as you like.
The remaining switches in the group all work in the principle of
elimination. When you specify more such switches, the more files
get eliminated from the set. You can consider each switch in this
category as a filter. XXCOPY offers a very wide range of filtering
mechanism to narrow down the choice for a particular operation.
2.1 Source Specifier (not a switch)
[ volume ] [ base_dir ] [ dir_pattern ] [ file_pattern ]
2.1.1 Volume Usually a drive letter (UNC allowed)
2.1.2 Base Directory The constant part without wildcard
2.1.3 Directory Template Wildcards (* and ?), multiple-level
2.1.4 Filename Template Wildcards (* and ?), filename pattern
This parameter in conjunction with the /IN switch
determines the entire inclusive scope of the directories
and files that will be subject to the file operation.
See XXTB #28 for detail.
2.2 By the characteristics of the source file
The switches in this group are concerned with the
characteristics of the files in the source (as opposed
to the switches in Group 2.3 which compare between the
files in the source and those in the destination).
2.2.1 by Alternate Filename
/IN<tmpl> Includes an alternate filename template (tmpl).
This is the only one in the entire XXCOPY command switch
whose effect is applied inclusively. That is, if you add
another /IN switch, it will add new set of files in addition
to the previous set of files for the operation.
2.2.2 by Exclusion
/X<xspec> Adds an exclusion specifier (xspec).
/EX<list> Specifies a text file with a list of xspecs.
See XXTB #05 for detail.
2.2.3 by File Date
The various /DAx switches are mutually exclusive one another.
The various /DBx switches are also mutually exclusive one another.
You may specify a /DAx and a /DBx at the same time which will
work together to bracket a range in time line to select files.
The /Do switch can be considered as a combination of /DAx and /DBx
with the same date specifier which determine a single file date
which qualifies the files for operation.
/D:<date> Same as /DA:<date>.
/DA#<n> Copies files that were changed on or after n days ago.
/DA:. Copies files that were changed today or later.
/DA:<date> Copies files that were changed on or after the specified date.
/DA:<time> Copies files that were changed on or after the date and time.
/DB#<n> Copies files that were changed on or before n days ago.
/DB:. Copies files that were changed yesterday or earlier.
/DB:<date> Copies files that were changed on or before the specified date.
/DB:<time> Copies files that were changed on or before the date and time.
/Do#<n> Copies files that were changed on the day of n days ago.
/Do:. Copies files that were changed today only.
/Do:<date> Copies files that were changed on the specified date.
2.2.4 by File Size
The file size qualifier switches sets the low limit or high
limit or both to select files. Only the last such switch will
prevail if multiple switches from this group are specified.
/SZ:<n>-<m> Copies a file whose size is between n bytes and m bytes.
/SZ:<n>- Copies a file whose size is equal to or greater than n bytes.
/SZ:-<m> Copies a file whose size is equal to or less than m bytes.
/SZ:<n> Copies a file whose size is exactly n bytes.
/SZ!<n>-<m> Copies a file whose size is NOT between n bytes and m bytes.
/SZ!<n>- Copies a file whose size is NOT equal to or greater than n bytes.
/SZ!-<m> Copies a file whose size is NOT equal to or less than m bytes.
/SZ!<n> Copies a file whose size is NOT equal to n bytes.
/SZ:- Disables size-based selection (/SZ!- also works).
2.2.5 by File Attributes
The /ATxxxx and /AXxxxx switches let you specify any
combination of file selection using the file attributes
as the key. The popular switches, /H and /A are
two most common ones.
/H Copies hidden and/or system files also.
/H0 Excludes hidden and/or system files (default). (same as /AXH/AXS)
/Ho Copies hidden and/or system files only. (same as /ATHS)
/A Copies only files with the archive attribute set. (same as /ATA)
/M Copies only files with the archive attribute set. (similar to /ATA)
/AT<mask> Selects files by the attribute bits (AHSRC).
/AX<mask> Excludes files with the specified attribute bits (AHSRC).
/A0 Ignores the archive attribute bit and does not change it.
2.3 By comparison with the file in destination
The switches in this group select files based on the
comparison between the files in the source and those in
the destination. They are often used for periodic backup
and directory synchronization purposes. These switches
were originally created as variations of directory backup.
They are also convenient for selecting files for deletion.
2.3.1 by Presence/Absence
The /BB and /U switches are the two switches which select
files by the pure presence or absence as the criteria.
Other switches in the this group (Group 2.3) are also
affected by the file in the destination, but for a
particular characteristics for comparison's sake.
/BB Selects files that are present in source but not in destination.
/U Selects files that are present in both source and destination.
2.3.2 by File Date
The files in the source and in the destination are
compared by their date (the Last-written date by
default --- see /FC for more info).
/BN Backs up newer files only (includes brand new files).
/Bo Backs up older files only (includes brand new files).
/BX Backs up different-date files (includes brand new files).
/D Same as /DA.
/DA Copies newer files and brand new files.
/DB Copies older files and brand new files.
/DS Copies same date/time files only.
/DX Copies different-date files only.
/DA and /BN are basically the same. Similarly,
/DB and /Bo are basically the same. Why does XXCOPY
provide the redundant sets of switches? This is
something to do with the mutual exclusivity of switches.
The Backup-related switches (/Bxx) are mutually exclusive
and cannot have two ways to run a backup operation. For
example, if you use /BZ (see below), you may not use the
/BN switch at the same time (then you can use /DA).
Similarly, when you use a /DA# switch, you cannot use
the /DA switch (then, you can use /BN).
2.3.5 by File Size
You may use the relative file size as the file
selection criteria. The switches listed below are
mutually exclusive.
/BZ Same as /BZX
/BZE Backs up equal-size files (includes brand new files).
/BZS Backs up smaller-size files (includes brand new files).
/BZL Backs up larger-size files (includes brand new files).
/BZX Backs up different-size files (includes brand new files).
2.3.6 by Combination
We advocate the use of the combination of file size
and file time as the file selection criteria for
incremental backup job (/BI). We think this scheme is
more reliable than the use of the Archive bit (which may
be inadvertently altered by another application).
/BI Backs up incrementally, different (by time/size) files only.
/BE Selects exactly the same files and brand new files in src.
/BS Selects exactly the same files (this is useful with /RS).
/BU Standard Backup switch (same as /R/I/BI/Q/C/H/E/V/Y)
/CLONE Duplicates a directory (volume). Same as /KS/H/E/R/Q/Y/BI/ZY/ZE
3. Action Modifier Group:
The switches that have been discussed above are very systematically
designed. Indeed, many of them are quite inevitable features for
a complete file management tool such as XXCOPY. On the other hand,
the action modifiers listed in this group are not so systematic.
They are a result of evolutionary process where we responded to user
requests. The nature of the switches in this broad group is that the
presence of the switch alters the behavior of the XXCOPY operation
one way or another. Since the backward compatibility is important
to long time users, the switch letter assignments are not optimum
for mnemonic purposes at times. The main reason why they are listed
together in this group is that they are not part of the file-selection
mechanism.
Fortunately, the switches listed here are mostly optional and
you can operate XXCOPY without the full knowledge of them.
You may take time to digest the list over a long period of time,
or you may simply forget most of these and come back later.
Some of the parameters that follow the command switch are not
always shown in this listing. The alphabetic listing has full
explanation of the parameters XXTB #26.
3.1 Console Output
/EC Echoes the entire command line (after macro processing).
/ZS Disables the sign-on message and statistics output.
/Q Same as /Q1. Does not display files which are skipped.
/Q0 Displays all filenames.
/Q1 Does not display files which are skipped.
/Q2 Does not display directories which are excluded.
/Q3 Does not display file and directory names while copying.
/Q3 Does not display file and directory names while copying.
/F Displays full source and destination filenames while copying.
/L<items> Lists the files which would be affected (no other actions).
See 3.1x (/FM<items>) for specifications of items.
/oFn See the following section (also for /oDn/oEn/oIn/oPn/oSn/oXn).
3.2 Screen and Log File output control
/oQ Surround pathname with a pair of quotation marks.
/oDn Deleted-file list (by a /Z or /ZY switch).
/oEn Error summary with the system error code.
/oFn File list (files that are successfully operated on).
/oIn Include-item list.
/oPn Parameter (command switch detailed list).
/oSn Skipped-file list (with the reason for skip).
/oXn Exclude-item list.
The suffix (n) will have the following effects:
0: no output
1: Screen only
2: Log file only
3: Screen and Log file both
3.3 Log File and List File
/oA<fname> Appends to a logfile, reporting errors. (does not overwrite log).
/oN<fname> Outputs a new logfile, reporting errors (make a new log) file.
/Fo<fname> Displays full source and filenames and also saves into a file.
/FM<items> Specifies the output line format (also applies to /L format).
For items, use one or more of the followings.
D file date
T file time
Z file size in bytes
A file attributes (A, H, S, R)
S short name (8.3)
L long name with full directory path
N long name without path
P parent path
R relative path
3.4 Subdirectories
/S Copies directories and subdirectories except empty ones.
/E Copies directories and subdirectories, including empty ones.
/T Creates directory structure, but does not copy files.
/ED Preserves an empty directory on /Z, /RC, /RS, /RD, /RX cases.
/ED0 Deletes empty directories (default).
/ED<n> Preserves n levels of empty subdirectories.
/DL<n> Limits processing of directories to n levels.
3.5 File Gathering
/SG Same as /SGN (see variations in handling duplicates below).
/SGF Gathers files into one-level directory (unsorted First file 1st).
/SGN Gathers files into one-level directory (sorted, Newest file 1st).
/SGo Gathers files into one-level directory (sorted, Oldest file 1st).
/SGFo Gathers files into one-level directory (First only).
/SGNo Gathers files into one-level directory (Newest only).
/SGoo Gathers files into one-level directory (Oldest only).
3.6 Directory Flattening
/SL Flattens subdirectories, add-name-Left (see below).
/SR Flattens subdirectories, add-name-Right (see below).
/SX Flattens subdirectories, add-name-Middle (see below).
/SLR Rebuilds flattened directory (path to the left).
/SRR Rebuilds flattened directory (path to the right).
/SXR Rebuilds flattened directory (path in the middle).
3.7 File Name Treatments
/NX Preserves the shortname when the file is copied (default).
/NX0 Disables the /NX switch (good for remote volume, DirectCD, etc.).
/N Uses the short (8.3) name for name matching, and creation.
/N0 Uses the longname for name matching, and creation (default).
/NP Uses precise name matching (ignores the match in alias).
/NP0 Uses loose name matching (either longname or alias -- default).
/ND Uses the old (DOS) wildcard treatment (default in XXCOPY16).
/NW Uses the new (Win32) wildcard treatment (default in XXCOPY).
3.8 File Name Case Control
/NC0 Disables /NCL, /NCU, or /NCX (accepts letters of both cases).
/NCL Uses Lowercase-only name when a new file is created.
/NCU Uses Uppercase-only name when a new file is created.
/NCX Uses Uppercase-only name when a new shortname-file is created.
3.9 File Time Treatments
/FA Uses the Last-Access timestamp for Filetime comparison.
/FC Uses the Creation timestamp for Filetime comparison.
/FL Filetime in Local time (default).
/FU Filetime in UTC (Universal Coordinated Time - same as GMT).
/FW Uses the Last-Write time for Filetime comparison (default).
/FF Fuzzy Filetime, ignores +/- 2 seconds in Filetime difference.
/FF<n> Fuzzy Filetime, same as /FF+<n>/FF-<n>.
/FF+<n> Allows difference up to plus n seconds for matching filetime.
/FF-<n> Allows difference up to minus n seconds for matching filetime.
/FR Legacy switch (replaced by /FF+2).
/FT Legacy switch (replaced by /FF-2).
3.8 Timestamp Control
/TTA Touches (modifies) timestamp of Last Access of src.
/TTA0 Preserves timestamp of Last Access of src (default).
/TCA Copies the timestamp of Last Access from src to dst.
/TCC Copies the timestamp of Create Time from src to dst.
/TCW Copies the timestamp of Last Write from src to dst (default).
/TCA0 Uses current time for dst Last Access (default).
/TCC0 Uses current time for dst Create Time (default).
/TCW0 Uses current time for dst Last Write.
3.9 Time Zone Adjustments
/TD+<n> Adds an offset to the time of the destination file.
/TD-<n> Subtracts an offset time from the dst file for comparison.
/TS+<n> Adds an offset to the time of source (and the copied) file.
/TS-<n> Subtracts an offset time from source (and the copied) file.
3.12 File Attributes
/AC Clears the archive bit of the source after it is copied.
/R Allows overwrite or delete of read-only files.
/R0 Cancels overwrite/delete of read-only files.
/K Keeps the source attributes including read-only (same as /KS).
/KD Keeps the attributes of destination (overwritten) file.
/KN Sets the destination attributes to normal (only /A).
/KS Keeps the src attributes including the read-only bit.
3.13 Limiting the File Size in Copying.
/TR<n> Truncates the newly copied files (first n bytes are copied).
/SZ<n> Legacy switch (replaced by /TR).
3.14 File Removal
/Z Deletes extra files or subdirectories in destination.
/ZY Same as /Z except there is no confirmation prompt.
/RC Removes files in src after a successful copy (equivalent to move).
/RS Removes files in src (see Section 1.2.2 of Action section).
/RD Removes files in src (see Section 1.2.3 of Action section).
/RX Removes files in src (see Section 1.2.4 of Action section).
3.15 Quota (counting) on File Operation
/QF<n> Quits when the quota for the file count has been reached.
/QBL<n> Quits before the byte count exceeds the limit.
/QBT<n> Quits when the total byte count reaches the trigger point.
/QSL<n> Quits before the remaining space dips below the limit.
/QST<n> Quits when the remaining space reaches the trigger point.
3.16 Verify After Copy
/V Verifies after copy; default (same as /V1).
/V0 Disables verify switch (canceling /V, /V1, /V2, or /V3)
/V1 Verifies after copy (quick test --- file size match).
/V2 Verifies after copy byte-by-byte check (DATMAN 2-pass).
/VE Displays only error cases of DATMAN 2-pass verify (/V2).
3.17 Cyclic Copy Handling
/CC Prompts you when a cyclic copy is attempted.
/CC0 Disallows cyclic copy.
/CCY Allows a cyclic copy by excluding destination (default).
3.18 Security Information (NTFS only)
/SC Same as /SC3 (copies security info).
/SC0 Cancels the /SC or /SF switch (no security info copied).
/SC1 Copies security info (Permissions only) when a file is copied.
/SC2 Copies security info (Auditing only) when a file is copied.
/SC3 Copies security info (both Perm, Audit) when a file is copied.
/SF Same as /SF3 (fixes up security info)
/SF0 Cancels the /SC or /SF switch (equivalent to /SC0).
/SF1 Fixes up security info (Permissions only) (no file copy).
/SF2 Fixes up security info (Auditing only) (no file copy).
/SF3 Fixes up security info (both Perm, Audit) (no file copy).
3.19 Checking Remaining Space
/CK Checks remaining space before copy (default).
/CK0 Disables the pre-check of remaining space before copy.
3.20 Prompt Control
/YY Suppresses ALL prompts unconditionally (good in batch file).
/I Suppresses the prompt before creating the destination directory.
/I0 Prompts you before creating the destination directory if absent.
/W Same as /WE (Prompts you before proceeding).
/WS Prompts you to press a key at the start of copying.
/WE Prompts you to press a key at the end of copying.
/W0 Cancels the /W, /WS, or /WE switch.
/P Prompts you before creating each destination file.
/P0 Cancels the /P specified earlier.
/PC Prompts you before creating a new files.
/PC0 Creates a new file without prompting.
/Po Prompts you before overwriting an existing file (same as /Y0).
/Po0 Overwrites an existing file without prompting (same as /Y).
/Y Overwrites existing files without prompting (same as /Po0).
/Y0 Cancels the /Y switch. (same as /Po).
/-Y Cancels the /Y switch (XCOPY compatible syntax).
/PD Prompts you on a directory (default on destructive operations).
/PD0 Suppresses the warning generated by the /PD setting.
/PZ Prompts for confirmation of dst directory on /Z /ZY /CLONE.
/PZ0 Suppresses prompt for directory confirmation on /CLONE /Z /ZY.
/PN Prompts when on excessive failures on /NX operations.
/PN0 Suppresses prompts on excessive failures of /NX operations.
/WD Warns you when a root-level directory is missing (default).
/WD0 Suppresses the warning generated by the /WD setting.
/WV This switch is now obsolete and has no effect.
/WV0 This switch is now obsolete and has no effect./WV setting.
/ZY /Z action without the warning on file delete.
/RSY /RS action without the warning on file delete.
/RCY /RC action without the warning on file delete.
/RDY /RD action without the warning on file delete.
/RXY /RX action without the warning on file delete.
/CCY /CC action without the warning on cyclic copy.
3.21 Progress Bar
/PB Shows Progress bar for the job (default file progress >= 1M).
/PB<n> Shows Progress bar with file progress if size >= n bytes.
/PBH Enables Progress bar Halt/Abort button (default).
/PBH0 Disables Progress bar Halt/Abort button.
3.22 List Tree
/LTREE Lists directory tree (without copy or making directories).
Note: with /LTREE, the /DA/DB/DO parameters apply on dir time.
3.23 Error Handling
/C Continues copying even if errors occur (default).
/C0 Terminates upon the first occurrence of a fatal error.
/CB Continues batch file if XXCOPY ended OK last time.
/CBQ Same as /CB except suppresses console output to end immediately.
/CR<n> Sets the retry period (n seconds, default = 3) on failed copy.
/CR0 Disables the retry attempt of a filed copy.
/CE Same as /CBQ/EC (most useful in batch file with @echo off).
3.24 Check Condition
/IA Continues if destination is absent (terminates if exists).
/IA<file> Continues if the specified file or dir is absent (terminates if exists).
/IP Continues if destination is present (terminates if absent).
/IP<file> Continues if the specified file or dir is present (terminates if absent).
3.25 Debug and Test
/DEBUG Shows the command parameters and prompts you to start.
/DEBUGX Exits immediately after showing the command parameters.
3.26 Cache Control
/CA Enables all cache. Same as /CA7 (default).
/CA0 Cache control: src-rd = OFF dst-wr = OFF dst-rd = OFF
/CA1 Cache control: src-rd = OFF dst-wr = OFF dst-rd = ON
/CA2 Cache control: src-rd = OFF dst-wr = ON dst-rd = OFF
/CA3 Cache control: src-rd = OFF dst-wr = ON dst-rd = ON
/CA4 Cache control: src-rd = ON dst-wr = OFF dst-rd = OFF
/CA5 Cache control: src-rd = ON dst-wr = OFF dst-rd = ON
/CA6 Cache control: src-rd = ON dst-wr = ON dst-rd = OFF
/CA7 Cache control: src-rd = ON dst-wr = ON dst-rd = ON
3.27 Miscellaneous
/ER Emulates XCOPY's exit code (for ERRORLEVEL check in batch files).
/NI Becomes nice to other tasks by idling (1000 msec) between actions.
/NI<n> Same as /NI. Specifies n msec as the idle time (0 to disable it).
/SP Spans the copy job over multiple destination (new volume).
/MD<dir> Make Directory (convenient to create a directory for log files).
3.28 Help
/? Shows a summary of the switches on one page (without a switch).
.../? Shows only relevant switches when other switches are present.
/HELP Shows the switches in detail (print this output).
/HELPA Shows the /HELP listing in alphabetical order.
/HELP /x Shows a portion of /HELPA for switches starting with letter x.
/HELPE Lists the Exit codes (ERRORLEVEL values) returned by XXCOPY.
3.29 DATMAN-Specific Features
/J<n> Forces DATMAN catalog (journal) flush.
/0 Disables DATMAN One-pass copy (not recommended, but allowed).
/1 DATMAN One-pass copy (when copying from DATMAN tape, default).
/G<n> Sets DATMAN N-Group (redundant) write. (<n> : 0 - 7).
4. Command Entries
4.1 Environment Variables:
XXCOPY Specifies command line (any switches except src or dst).
XXCOPYX Specifies exclusion specifiers (without the /X prefix)
COPYCMD /Y /-Y can be accepted (XCOPY compatible)
4.2 Environment Variable Control
/ZE Disables the use of all Environment Variables for XXCOPY.
/ZX Disables the use of the Environment Variable XXCOPYX.
/ZX0 Enables use of the Environment Variable XXCOPYX.
4.3 Command File
/CF Specifies a text file which contains command line text.
4.4 Macro Reference (XXTB #24) --- examples shown below
/$DATE$ Expands to month and date (equivalent to /$MMDD$) --> "1225".
/$TIME$ Expands to hour and minutes (equiv. /$HHNN$) --> "1315".
/$YYMMDD$ Expands to 2-digit year month day --> "021225".
/$YYYY-MM$ Expands to 4-digit year month --> "2002-12".
/$HHNNSS$ Expands to hour minutes second --> "131530".
/$MON-DD$ Expands to month day --> "DEC-25".
/$Y$ Expands to last digit of the current year --> "2".
/$WWW$ Expands to day of the week --> "WED".
/$W$ Expands to ordinal number of day of week (0-6) --> "3".
/$IIII$ Expands to ISO 8601 Year value for Week number --> "2002".
/$II$ Expands to ISO 8601 Year value for Week number --> "02".
/$WK$ Expands to ISO 8601 Week number --> "W52".
/$K$ Expands to ISO 8601 Day-of-the-Week number (1-7) --> "3".
Note: The above examples are for 2002-12-25 13:15:30 (Wednesday).
Punctuation with ( . , - _ ' ! # % & @ ~ { } ` T ) may be used.
4.5 Environment Variable
// keep a common set of exclusion items in one place.
/%xxxx% Environment Variable reference in command files (/CF /EX).
4.6 Offset for Macro Time Values
/TM0 Cancels the time offset (in days) set by /TM+ or /TM-.
/TM+<n> Adds an offset (Dy) to the current time of macro reference.
/TM-<n> Subtracts an offset (Dy) to the current time of macro reference.
© Copyright 2008 Pixelab, Inc. All rights reserved.
