Instructions

UM-0085-B09 DT80 Range User Manual Page 102
RG
The COPYD command supports many options, which are used to:
• select the data or alarm stores from which you wish to unload,
• select the range of data records to unload,
• select the format you want it in,
• select where you want it to go, and
• select what to do with the source data after it has been unloaded
Selecting the Stores to Unload
The first group of COPYD options are used to select the set of data/alarm stores from which to unload. These options are
identical to those used for
LISTD, apart from some different defaults, and are listed in COPYD Option Summary (P109).
Note: by default COPYD does not unload from archive files – specify archive=Y to include them.
Selecting the Range of Data to Unload
The second group of COPYD options allow you to further refine the selection of what data to unload, by specifying a time
range of interest.
 Start and End Times
By default, all available data in the selected data/alarm stores will be unloaded. To select a smaller range, use the
start= and end= options.
• If the
start= option is specified then only records with timestamp later than or equal to the indicated time will
be unloaded.
• If the end= option is specified then only records with timestamp less than the indicated time will be unloaded.
The actual start and end times can be specified in a number of different ways. These formats are all based on the
ISO8601 time format, which is
yyyy
-mm-ddThh:mm:ss.ttt
Time components may be omitted, starting from the subseconds field. If a time component is not specified then 0 is
assumed. Date components may also be left off, starting with the days field. Missing date components are assumed to
be 1. If all date components are omitted then a date of 'today" is assumed.
If just the date part is specified, the trailing T is still required, to eliminate any possible ambiguities.
Some examples of possible start= and end= option values:
Value
Description
2010-02-15T12:05:02.25
12:05:02.25, 15-Feb-2010
2010-02-15T
midnight, 15-Feb-2010
2010-02T
midnight, 01-Feb-2010
13:20
13:20 today
0
midnight today
For example, to unload all data logged between 9:00am and 5:30pm today:
COPYD start=9 end=17:30
Relative times can also be specified by prefixing either the date or time part with a minus sign.
If the date part is relative, i.e.
-ddThh:mm:ss.tt
then this means "the specified time (hh
:mm:ss.tt), dd days ago".
If the time part is relative, i.e.
-hh:mm:ss.tt
then this means "the current time, minus the specified offset (hh
:mm:ss.tt), rounded down to the smallest specified
time component"
Some examples may clarify this. These assume that the current time is 17:05:22.888, 20-Feb-2010
Value
Description
-1T17:30
5:30pm yesterday (17:30:00.000, 19-Feb-2010)
-7T
midnight 7 days ago (00:00:00.000, 13-Feb-2010)
-0:10
10 minutes ago, rounded down to the minute (16:55:00.000, 20-Feb-2010)
-2
2 hours ago, rounded down to the hour (15:00:00.000, 20-Feb-2010)
-48
48 hours ago, rounded down to the hour (17:00:00.000, 18-Feb-2010)
-48:00:00.000
exactly 48 hours ago (17:05:22.888, 18-Feb-2010)