3.3.3 - Build Local Files

Action Option -BL (-BuildLocal) (Alias: -BuildLocalfile) :

(Alias: -BuildLocalFile) validates and converts remote files and builds local files.

dsupdt [[-(DS|Dataset)] dNNNNNN] -(BL|BuildLocal) [Mode Options]
[-(CI|ControlIndex) UpdateControlIndex]
[-(LI|LocalIndex) LocalFileIndices]
[-(LF|LocalFile) LocalFileNames]
[-(XO|ExecOrder) ExecOrderIndex]
[-(RF|RemoteFile) RemoteFileNames]
[-(BC|BuildCommand) CommandBuildLocalFile]
[-(ED|EndDate) NextDataEndDate]
[-(EH|EndHour) NextDataEndHour]
[-(GP|GenericPattern) GenericPatterns]
[-(WD|WorkDir) WorkingDirectory]
[-(FQ|Frequency) UpdateFrequency]
[-(CD|CurrentDate) CurrentDate]
[-(CH|CurrentHour) CurrentHour]
[-(VS|ValidSize) MinSizeForValidFile]
[-(PL|ProcessLimit) MaxNumberOfChildProcesses]
[-(QS|QsubOptions) PBSBatchOptions]
[-(BP|BatchProcess) [BatchProcessHosts]]
[-(CC|CarbonCopy) Cc’dEmailAddresses]
[-(DB|Debug) DebugModeInfo]

Available Mode options:

-(AW|AnyWhere)

works with -BP (-BatchProcess) to allow the recorded dsupdt command to start from any directory

-(BG|BackGround)

runs in the background; suppresses screen output and errors

-(CP|CurrentPeriod)

allows the end date/hour to be processed even if it falls within the current update period

-(EE|ErrorEmail)

sends email only when an error occurs during local file building

-(FU|ForceUpdate)

forces a build for at least one end date/time, even if the update is not yet due

-(GZ|GMTZone)

uses GMT dates/times as controlling times

-(HU|HourlyUpdate)

advances time tracking to hours after a successful local file build

-(IE|IgnoreError)

works with -MU (-MultipleUpdate) to skip build errors and continue with remaining local files

-(KR|KeepRemote)

copies rather than moves the remote file to the local file location, preserving the remote file on disk

-(LO|LogOn)

enables detailed logging when -PL is present

-(MO|MissedOnly)

builds only files that have not yet been archived

-(MU|MultipleUpdate)

builds across all available update periods; without this option, only one period is processed

-(NE|NoEmail)

suppresses post-build email notification

-(NY|NoLeapYear)

skips February 29 in leap years

-(QE|QuitError)

stops all builds for the dataset on the first error, rather than skipping and continuing

-(UB|UseBeginTime)

uses the period’s beginning time instead of the end time when substituting temporal patterns

If specialist-defined validation and conversion routines are configured, this action invokes them. When local and remote files are identical, no action is taken. Otherwise, standard compress/uncompress and tar/untar utilities handle one-to-one, many-to-one, and one-to-many conversions. Local files are the final, archive-ready output.

When a local file already exists on disk, the build action for that file is skipped. To rebuild, remove the existing local file manually.