3.1.3 - Set Local Files

Action Option -SL (-SetLocalFile) (Alias: -SetLocal) :

(Alias: -SetLocal) creates or modifies local file update records in GDEXDB for a given dataset. One or more records may be processed per execution.

dsupdt [[-(DS|Dataset)] dNNNNNN] -(SL|SetLocalFile) [Mode Options]
-(LI|LocalIndex) LocalFileIndices
[-(LF|LocalFile) LocalFileNames]
[-(CI|ControlIndex) UpdateControlIndices]
[-(PI|ParentIndex) ParentLocalIndices]
[-(FA|FileArchived) ArchivedFileNames]
[-(DC|DownloadCommand) DownloadCommand]
[-(AN|ActionName) DSARCHActionNames]
[-(OP|Options) DSARCHOptions]
[-(XO|ExecOrder) ExecuteOrderIndices]
[-(FQ|Frequency) DataFrequencies]
[-(EP|EndPeriod) PeriodEndAt]
[-(DI|DueInterval) DataDueInterval]
[-(ED|EndDate) NextDataEndDate]
[-(EH|EndHour) NextDataEndHour]
[-(VI|ValidInterval) UpdateValidInterval]
[-(AT|AgeTime) RemoteFileAgeTime]
[-(WD|WorkDir) WorkingDirectory]
[-(CL|CleanCommand) FileCleaningCommand]
[-(MR|MissRemote) AllowMissRemote]
[-(PR|ProcessRemote) AdditionalRemoteFileProcess]
[-(BC|BuildCommand) CommandBuildLocalFile]
[-(SN|Specialist) GDEXSpecialist]
[-(DE|Description) FileDescription]
[-(DB|Debug) DebugModeInfo]

Available Mode options:

-(MD|MyDataset)

sets information into GDEXDB regardless of dataset ownership

-(NL|NewLocfile)

adds a new local file update record to GDEXDB

-(RO|ResetOrder)

resets execution order indices to match the order in which records are provided

An existing local file record in GDEXDB for the given index is modified in place. A new record is created when the index is 0 and -NL (-NewLocfile) is supplied. The dataset name via -DS is required only when adding a new record.

Temporal or generic patterns enclosed by delimiters (default ‘<’ and ‘>’) may be embedded in local file names (-LF), remote file names (-RF), download commands (-DC), and file descriptions (-DE). Delimiters can be changed via -PD (-PatternDelimiter). Patterns are placeholders substituted with real values at update time. For example, <YYYYMM> represents a 4-digit year followed by a 2-digit month. A file named ‘filename.<YYYYMM>.ext’ updated to end date 2007-10-31 becomes ‘filename.200710.ext’.

Linking a local file record to an update control record (via -CI) causes the control record’s scheduled action to run automatically against that local file.

EXAMPLE 3. To set update information for two new local files of d744004 via input file ‘d744004.loc’:

dsupdt SL -NL -IF d744004.loc

Content of input file d744004.loc:

Dataset<=>d744004
LocalIndex<:>LocalFile<:>Action<:>ExecOrder<:>ControlIndex<:>FileArchived<:>DownloadCommand<:>Options<:>Frequency<:>DueInterval<:>EndDate<:>ValidInterval<:>WorkDir<:>CleanCommand<:>
0<:>uv.<YYYYMM>.bln<:>AW<:>1<:>0<:><:>cp -p /huron/ftp/rossby/upload/morzel/<:>-GI 11 -DF BINARY<:>1M<:><:>2009-08-31<:><:>$UPDTDATA/zji/BLNWIND<:>rm -f __FN__<:>
0<:>curl.<YYYYMM>.bln<:>AB<:>2<:>0<:><:>cp -p /huron/ftp/rossby/upload/morzel/<:>-GI 12 -DF BINARY<:>1M<:><:>2009-08-31<:><:>$UPDTDATA/zji/BLNWIND<:>rm -f __FN__<:>