3.3.1 - Set Group Information

Action Option -SG (-SetGroup) :

creates new or updates existing group records in GDEXDB for the specified dataset. Multiple records can be processed in one run.

dsarch [-(DS|Dataset)] dNNNNNN [-](SG|SetGroup) [Mode Options]
[-(GI|GroupIndex) GroupIndices]
[-(GN|GroupName) GroupNames]
[-(PI|ParentIndex) ParentGroupIndices]
[-(TI|Title) GroupTitles]
[-(GT|GroupType) GroupTypes]
[-(GP|GroupPattern) FileNamePatterns]
[-(BF|BackupFlag) QuasarBackupFlags]
[-(DA|AccessFlag) DataAccessFlags]
[-(SP|SavedPath) SavedFilePaths]
[-(WP|WebPath) WebFilePaths]
[-(ML|MetaLink) MetadataLinks]
[-(NW|NoteWeb) WebNotes]
[-(NI|NoteInternal) InternalNotes]
[-(LN|LoginName) LoginAccountName]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(MD|MyDataset)

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

-(NT|NoTrim)

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

-(RT|ResetTGroup)

resets the top group index for Saved/Web file records in the affected group

-(WM|WithMetadata)

re-gathers Web file content metadata at the group level

-(WN|WithFileNumber)

re-evaluates and resets Saved/Web file counts for the affected groups

If the group index already exists in GDEXDB, the record is updated; otherwise a new group is created. New groups require a unique index.

To create a subgroup, set a parent index via -PI (-ParentIndex). Groups can be nested to any depth. By default, three levels are shown on group list webpages; adjust this with -GL (-GroupLevel) via -SD (-SetDataset).

Changing a group’s type from P (public) to I (internal) automatically marks all its subgroups and associated Saved/Web files as internal too.

EXAMPLE 6. To set multiple group records for d744004 using an input file:

dsarch SG -IF d744004.grp

Content of input file d744004.grp:

Dataset<=>d744004
EndDate<=>2005-09-30
GroupIndex<:>Title<:>GroupPattern<:>DescWeb<:>
1<:>Blended Wind<:>.bln<:>
The 'bln' product is the blended wind field output.<:>
2<:>NCEP Re-analyses<:>.low<:>
The 'low' fields consist of the NCEP re-analyses splined
to the 0.5 x 0.5 degree grid (i.e. no QSCAT data blended).<:>
3<:>Superposition of QSCAT Observations<:>.sub<:>
The 'sub' product is output from an intermediate step in the blending process
that consists of the superposition of QSCAT observations on NCEP before
blending. This product is of no particular scientific value, but very useful
in identifying the satellite data swaths in each composite of 12-hours of
QSCAT observations.<:>