Use proper Mode options to modify behaviors of Action options. Mode options are all optional. No value is allowed to be passed in following any Mode option.
works with Info option -BP (-BatchProcess) to use empty work directory so that the recorded "dsupdt' command can be started processing any where other than the directory where the command was recorded initially.
background process. When it presents screen display is turned off for both standard outputs and errors.
if presents, allows check update actions -CU (-CheckUpdate) to check availability of all remote files. Without it, the checking procedure quits after the first unavailable remote.
for server file is locally ready, checks if the file on server is changed; downloads it again if it is changed. This option is ignored if -RD is present. There must be a local copy of the data file for checking newer file on server. The local data file copy is normally the local copy of the server file, but it can be an existing remote file or local file if it is the same file content as the server file, although it may have different file name.
For this Mode option to work properly, it is specialists' responsibility to maintain a proper local data file and a valid download command that can check data file info on server, such commands as 'cp', 'mv' and 'tar' for a file on local host, 'scp', 'wget' and 'ncftpget' for a file on remote host. For a customized download command, it must have build-in function of checking newer server file.
If the server time zone is different from the local time, Info Option -HO (-HourOffset) for an offset value in hours must be provided to be able to check newer file on remote server by comparing the file local and remote timestamps.
Mode Option -CP (-CurrrentPeriod) :
if presents, allows update actions for the current date/hour lands in the current update period, although the data end date/hour are not due yet.
Mode Option -EE (-ErrorEmail) :
sends email to the specialist after update only when error happens during the update action.
Mode Option -FO (-FormatOutput) :
if present, formats column output results for get actions. A same width, evaluated dynamically, is applied for all values of a given field.
if present, force update at lease for one end data/time, although the update may not be due yet.
uses GMT dates/times as controlling times for update actions, instead of local time.
Mode Option -HU (-HourlyUpdate) :
forces update of time to hours after successful archive action for data file update.
Mode Option -IE (-IgnoreError) :
works with Mode option -MU (-MultipleUpdate) to skip the update errors and continue update for the later archive periods. For archive record with defined valid interval, this Mode option will also make 'dsupdt' to check back to the valid period and re-archive if found any missing archive.
keeps remote file on local disk by copying it to local file instead of moving.
keeps server file on local disk by copying it to remote file instead of moving.
turns detail logging on when Info option -PL (-ProcessLimit) is present for update actions.
Mode Option -MD (-MyDataset) :
allows a specialist to add or modify update information of a given dataset listed for another specialist.
Mode Option -MO (-MissedOnly) :
skips update action if the data file is archived already. This is often used with Mode option -MU (-MultipleUpdate). This option is ignored if one of the Mode options -RA, -RD or -CN is present.
Mode Option -MU (-MultipleUpdate) :
allows multiple updates if multiple data update periods are available; 'dsupdt' defaults to process a single update if this Mode option is not present.
a new update control record can only be added when this Mode option is present and update control index is given as 0 when Action -SC (-SetControl) of 'dsupdt' is executed. This Mode option prevents adding update control records unintentionally.
does not send email notice to the specialist after update.
a new local file record can only be added when this Mode option is present and local file index is given as 0 when Action -SL (-SetLocalFile) of 'dsupdt' is executed. This Mode option prevents adding local file update records unintentionally.
Mode Option -NY (-NoLeapYear) :
skips February 29 for leap years.
quits processing updates of a dataset when an error happens, instead of continuing on finishing other local file records.
Mode Option -RA (-RetryArchive) :
forces archive of local files by passing option -RA to 'dsarch'.
retries download the remote file if it is local already for Action -DR (-DownloadRemote).
Mode Option -RE (-ResetEndTime) :
- if present, reset end datae/hour if file timestamp is newer than end date/hoour plus one update frequency.
when present, resets the execute orders of the given local file lists as the orders the update records are given for actions -SL (-SetLocalFile). Another way of reordering the local files is to provide explicitly order index values per Info option -XO (-ExecOrder).
Mode Option -SE (-SummaryEmail) :
sends a summary email to the specialist after data update action without detail logging information.
Mode Option -UB (-UseBeginTime) :
when present, uses the beginning time of update period for replacing temporal patterns configured for file names, download commands, and other fields.
Mode Option -UT (-UpdateTime) :
when present, forces to update the data end time and next due update times in local file records no matter the update actions are successful or not.