3.3.2 - Get Group Information

Action Option -GG (-GetGroup) :

retrieves group records for the specified dataset. Filter results by providing group indices, names, or a parent index.

dsarch [-(DS|Dataset)] dNNNNNN [-](GG|GetGroup)
[-(FN|FieldNames) FieldNameString]
[-(ON|OrderNames) OrderNameString]
[-(GI|GroupIndex) GroupIndices]
[-(GN|GroupName) GroupNames]
[-(PI|ParentGroupIndex) ParentGroupIndices]
[-(OF|OutputFile) OutputFileName]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(FO|FormatOutput)

formats each column to a uniform fixed width

-(RG|RecursiveGroup)

gathers subgroups recursively for a given group index

-(WN|WithFileNumber)

gathers and displays file counts for groups

Use -FN (-FieldNames) to specify which group fields to retrieve. Defaults to ‘IGXTQSW’. Use -FN ALL for all available fields.

Valid group field names and their corresponding Info options:

Names

Info Options

Descriptions

I

-(GI|GroupIndex)

group indices

G

-(GN|GroupName)

group names, IDs

X

-(PI|ParentIndex)

parent group indices

T

-(TI|Title)

group titles

R

-(GT|GroupType)

group types

P

-(GP|GroupPattern)

common file name patterns for each group

Q

-(BF|BackupFlag)

Quasar Backup flags

A

-(DA|DataAccessFlag)

top group data file list access flags

S

-(SP|SavedPath)

path relative to saved home directory for groups

W

-(WP|WebPath)

path relative to web home directory for groups

M

-(ML|MetaLink)

a link to content meta at the group level

D

-(NW|NoteWeb)

group description of data on GDEX Server

N

-(NI|NoteInternal)

group description of internal HPSS data

Results can be filtered by group index (-GI), name (-GN), or parent index (-PI). The -GN option accepts the ‘%’ wildcard.

EXAMPLE 7. To retrieve the default group fields and file counts for groups 1 and 2 of d260001:

dsarch d260001 GG -WN -GI 1 2

Content of the output:

Dataset<=>d260001
GroupIndex<:>GroupName<:>ParentIndex<:>Title<:>GroupPattern<:>BackupFlag<:>SavedPath<:>WebPath<:>
1<:>DAILY<:>0<:>DAILY OAFlux Products<:><:>P<:><:>daily<:>
2<:>MONTHLY<:>0<:>MONTHLY OAFlux Products<:><:>P<:><:>monthly<:>
2 group records retrieved
d260001-G1: DS-11094192261 DC-327 WC-327 SS-8909173908 SC-51
d260001-G2: DS-552780725 DC-522 WC-522 SS-465789806 SC-51