3.1.4 - Get Local Files

Action Option -GL (-GetLocalFile) (Alias: -GetLocal) :

(Alias: -GetLocal) retrieves local file update records for a given dataset. When local file indices or names are provided, only the matching records are returned.

dsupdt [[-(DS|Dataset)] dNNNNNN] -(GL|GetLocalFile) [Mode Option]

[-(FN|FieldNames) FieldNameString]

[-(LI|LocalIndex) LocalFileIndices]

[-(LF|LocalFile) LocalFileNames]

[-(AN|ActionName) DSARCHActionName]

[-(XO|ExecOrder) ExecOrderIndex]

[-(FQ|Frequency) DataFrequencies]

[-(OF|OutputFile) OutputFileName]

[-(DB|Debug) DebugModeInfo]

Available Mode option:

-(FO|FormatOutput)

formats each column to a uniform fixed width

Use -FN (-FieldNames) to specify which local file fields to retrieve. The default is ‘LFAIUCOQJNVWZ’. Use -FN ALL to retrieve all available fields.

Valid field names of local files and their corresponding Info option names:

Names	Info Options	Descriptions
L	-(LI|LocalIndex)	index of update record
F	-(LF|LocalFile)	local, original or source file names
A	-(AN|ActionName)	Action name for dsarch
I	-(CI|ControlIndex)	update control indices
P	-(PI|ParentIndex)	parent index, refers to a dlupdt.lindex if not 0
U	-(FA|FileArchived)	archived file names on GDEX Servers
C	-(DC|DownloadCommand)	command for downloading a remote file
O	-(OP|Options)	options following the Action
X	-(XO|ExecOrder)	order indices for update execution
Q	-(FQ|Frequency)	frequency of data files, i.e., 1W, 1M
E	-(EP|EndPeriod)	0=Sunday/EndMonth if FQ=1W/1M
J	-(ED|EndDate)	data end date of next update
K	-(EH|EndHour)	data end hour of next update
N	-(DI|DueInterval)	data next due period, i.e., 1M2D
V	-(VI|ValidInterval)	update valid interval, i.e., 2D, 1M
T	-(AT|AgeTime)	remote file age interval, i.e., 2D, 1M
W	-(WD|WorkDir)	working directory for processing update
Z	-(CL|CleanCommand)	command for removing data files after update
M	-(MR|MissRemote)	flag (Y/N) indicating whether a missing remote file is allowed
R	-(PR|ProcessRemote)	external utility to process remote files
B	-(BC|BuildCommand)	external utility to build local files
S	-(SN|Specialist)	GDEX specialist who owns the local file record
D	-(DE|Description)	File description, include temporal patterns

Specific local files can be filtered by name using -LF (-LocalFile), which accepts the ‘%’ wildcard to match any number of characters.

When no dataset number is given, update information is displayed for every local file across all datasets owned by the specialist running dsupdt.

EXAMPLE 4. To retrieve the default local file fields for d744004, local file indices 33 and 34:

dsupdt d744004 GL -LI 33 34

Content of the output:

Dataset<=>d744004
LocalIndex<:>LocalFile<:>Action<:>ExecOrder<:>ControlIndex<:>FileArchived<:>DownloadCommand<:>Options<:>Frequency<:>DueInterval<:>EndDate<:>ValidInterval<:>WorkDir<:>CleanCommand<:>
33<:>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__<:>
34<:>curl.<YYYYMM>.bln<:>Aw<:>2<:>0<:><:>cp -p /huron/ftp/rossby/upload/morzel/<:>-GI 12 -DF BINARY<:>1M<:><:>2009-08-31<:><:>$UPDTDATA/zji/BLNWIND<:>rm -f __FN__<:>

Back to Top

Back to Table of Contents