Action Option -AW (-ArchiveWebFile) (Aliass: -ArchiveWeb, -ArchWeb, -ArchWebFile) :

archives local data files onto RDA Server and saves information of the archived files into RDADB for a given dataset. One or multiple local files can be archived each time.

dsarch	[-(DS|dataset)] dsnnn.n -(AW|ArchiveWebFile) [Mode Options]
	[-(LF|LocalFile) LocalFileNames]
	[-(LD|LocalDirectory) LocalDirectoryName]
	[-(LL|LocalFileList) LocalFileListName]
	[-(WF|WebFile) webFileNames]
	[-(GI|GroupIndex) GroupIndices]
	[-(TG|TopGroupIndex) TopGroupIndices]
	[-(GN|GroupName) GroupNames]
	[-(PO|PatternOffset) PatternStringOffset]
	[-(WT|WebFileType) WebFileTypes]
	[-(FS|FileStatus) WebFileStatus]
	[-(LC|Location) StorageLocationFlags]
	[-(DF|DataFormat) DataFormat]
	[-(AF|ArchiveFormat) FileArchiveFormat]
	[-(DO|DisplayOrder] DisplayOrderIndices]
	[-(SZ|Size) FileSizes]
	[-(MC|MD5Checksum) MD5ChecksumValues]
	[-(DE|Description] WebFileDescriptions]
	[-(VS|ValidSize) MinSizeForValidFile]
	[-(LN|LoginName) LoginAccountName]
	[-(AL|AsyncLimit) AsyncProcessLimit]
	[-(QS|QsubOptions) PBSBatchOptions]
	[-(BP|BatchProcess) [BatchControlInfo]]
	[-(DD|DeleteDir) DeleteLocalDirLevel]
	[-(DB|Debug) DebugModeInfo]

Mode options that can be specified for archive web file action:

One or multiple local file names can be provided per option -LF (-LocalFile) for this action to work. If option -LF is given on command line, '*' and '?' can be used in local file names for wildcard match. File names must include relative or absolute paths if local data files are not located in the directory where 'dsarch' is started. The local file names are gathered recursively following the sub-directory tree if a local directory per Info option -LD (-LocalDirectory) is present.

Local file names are used as default for Web file names unless they are explicitly given per option -WF (-WebFile). Local files are archived onto RDA Server under the dataset home directory as default, unless relative or absolute paths are given per option -WP (-WebPath) or Web path information for the given dataset, and groups if specified, previously saved in RDADB. The original local file names, including paths, are used if Mode option -KP (-KeepLocalPath) is specified. Option -WP is not allowed if Mode option -KP is given.

Group information for data files to be archived are given per option -GI (-GroupIndex) or -GN (-GroupName). Pattern matching is used for identify a group index for a given Web file if group index is not given explicitly, and the file record not exists in RDADB yet or Info option -PO (-PatternOffset) if present. The Web or local file name is matched against group pattern values that are previously saved in group records via Action -SG (-SetGroup). If no group index is provided and no group pattern matching, an index value of 0 is defaulted for a data file to indicate no group.

A web file can be archived as either P (public) or I (internal) for any data type as D (data) or N (ncar data). For a Web file is archived to be under an Internal group, its status is automatically forced to I.

The number of values passed in per Info options must be the same as the number of local file names provided, except for the Info options that are allowed to pass in single values, such as options -GI (-GroupIndex), -DF (-DataFormat), -AF (-ArchiveFormat), -WT (-WebFileType), and -WP (-WebPath). If a single group index is provided for multiple given local file names, the group index is shared by all the given data files.

The location flag is provided via option -LC (-Location). The defualt value is 'G' for archiving a web file onto Glade Disk only.

Back to Top

-(CL|CleanLocal)	cleans local files after they are all archived onto
-(EM|EMailNotice)	sends email for summary and errors for this action
-(GX|GatherXML)	evaluates file content metadata from local file
-(GZ|GMTZone)	uses GMT dates/times as controlling times
-(KP|KeepLocalPath)	retains the path names of local files as relative paths
-(MD|MyDataset)	overrides the default specialist and enables RDADB
-(NE|NoEmail)	does not send email to the specialist for failed action
-(NT|NoTrim)	skip trimming of spaces and comments from input
-(OE|OverrideExist)	overrides existing web files
-(RO|ResetOrder)	resets the ordering indices of the list of file names
-(SC|SetChecksum)	evaluates the md5 checksum values for data files on
-(UZ|UpzipData)	uncompresses online data with one of the uncompressing
-(XC|CrossCopy)	copies files from existing web/Object data files
-(XM|CrossMove)	moves files from existing web/Object data files
-(ZD|ZipData)	compresses online data with one of the compressing
-(ZD|ZipData)	compresses online data with one of the compressing utilities, 'gzip', 'compress', 'zip' or 'bzip', according to the archiving format 'GZ', 'Z', 'ZIP' or 'BZ2' provided per option -AF (-ARchiveFormat), respectively