3.4.3 - Set Web File Information

Action Option -SW (-SetWebFile) (Alias: -SetWeb) :

creates new or updates existing Web file records in GDEXDB for the specified dataset. Multiple records can be processed in a single run.

dsarch [-(DS|Dataset)] dNNNNNN -(SW|SetWebFile) [Mode Options]
[-(WF|WebFile) webFileNames]
[-(ON|OrderNames) OrderNameString]
[-(OB|OrderBy) OrderByPattern]
[-(GI|GroupIndex) GroupIndices]
[-(GN|GroupName) GroupNames]
[-(TG|TopGroupIndex) TopGroupIndices]
[-(PO|PatternOffset) PatternStringOffset]
[-(WT|WebFileType) WebFileTypes]
[-(LC|Location) StorageLocationFlags]
[-(FS|FileStatus) WebFileStatus]
[-(FF|FileFlag) FilesOrPaths]
[-(DF|DataFormat) DataFormats]
[-(AF|ArchiveFormat) FileArchiveFormats]
[-(DO|DisplayOrder) DisplayOrderIndices]
[-(SZ|Size) FileSizes]
[-(MC|MD5Checksum) MD5ChecksumValues]
[-(FD|FileDate) DateModified]
[-(FT|FileTime) TimeModified]
[-(ML|MetaLink) MetadataLinks]
[-(TL|ThreddLink) ThreddCatalogLinks]
[-(DE|Description) WebFileDescriptions]
[-(LN|LoginName) LoginAccountName]
[-(AL|AsyncLimit) AsyncProcessLimit]
[-(QS|QsubOptions) PBSBatchOptions]
[-(BP|BatchProcess) [BatchControlInfo]]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(BG|BackGround)

runs in background; suppresses screen output and errors

-(DX|DeleteXML)

calls dcm to delete content metadata for the specified Web files

-(EM|EMailNotice)

sends an email summary (including any errors) when the action completes or aborts

-(GX|GatherXML)

calls gatherxml to evaluate file content metadata

-(MD|MyDataset)

allows any specialist to set GDEXDB information, regardless of dataset ownership

-(NE|NoEmail)

suppresses email notification on failure

-(NT|NoTrim)

skips trimming of spaces and comments from input values, speeding up input file processing

-(RD|RemoveDir)

removes empty web directories after file changes

-(RO|ResetOrder)

resets display order indices to match the order files are given per -WF. Alternatively, use -ON (-OrderNames) to reorder all files in the dataset and affected groups

-(RS|GXRSOptions)

passes options R and S to gatherxml for faster processing, used with -GX (-GatherXML)

-(SC|SetChecksum)

computes MD5 checksums for files on the GDEX Server and saves them to GDEXDB

-(WS|WithFileSize)

gathers file size information for Web files on the GDEX Server and saves them to GDEXDB

Web file names must be provided via -WF (-WebFile) unless -ON (-OrderNames) is used to reorder files. The number of values supplied to other Info options must match the number of file names, except for options that accept a single shared value, such as -GI (-GroupIndex), -AF (-ArchiveFormat), -DF (-DataFormat), and -WT (-WebFileType).

If no group index is specified and -PO (-PatternOffset) is present, file names are matched against group patterns saved via -SG (-SetGroup) to determine the group index automatically.

The file status may be set to P (public) or I (internal) for data types D, N, O, and S. Files assigned to an internal group are automatically set to I.