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

creates or modifies update information of local files into RDADB for a given dataset. One or multiple records can be processed each time.

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

Mode option that can be specified for setting local file action:

If information of a local file exists already in RDADB for a given local file index, the update record is modified. A new local file record is added if local file index is 0 and Mode option -NL (-NewLocfile) is present. A dataset name via Info option -DS is only mandatory when a new control record is added.

Patterns quoted by delimiters can be set in local file names per -LF (-LocalFile), remote file names per -RF (-RemoteFile), download command per -DC (-DownloadCommand) and archive file note per -DE (-Description). The default delimiters are '<' and '>', which can be set differently per Info option -PD (-PatternDelimiter). A pattern is use for place holder of temporal or generic matching information of data files and later can be dynamically replaced with given values during update actions. The pattern <YYYYMM> is a place holder for a 4-digital year and a 2-digital month. For example, a local file name is given as 'filename.<YYYYMM>.ext', and the year and month are replaced by year value 2007 and month value 10 if the data file is updated to end date of 2007-10-31. Replacing <YYYYMM> with 200710 to get the local file name as 'filename.200710.ext'.

An local file configuration for a dataset is linked to an existing update control record for the same dataset, if the Control Index is set into the local file record via Info option -CI (-ControlIndex). With this setup, the update action set in the update control record is scheduled to process automatically against this local file configuration.

EXAMPLE 3.

Set Update Information Of Two New Local Files Of Ds744.4 Via input file 'ds744.4.loc'

-(NL|NewLocfile)	sets a new update record into RDADB
-(RO|ResetOrder)	resets the executing order indices of the local file
-(RO|ResetOrder)	resets the executing order indices of the local file records according to the order as they are given.

dsupdt

SL -NL -IF ds744.4.loc

Content of input file ds744.4.loc:

Dataset<=>ds744.4
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__<:>