56
1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

Embed Size (px)

DESCRIPTION

3 Get Help dsarch [Option] [-h[elp]] [Option] A full help document will be displayed, if DSARCH is issued without any option specified Description of an individual option will be displayed if DSARCH is issued with -help and a specified option, which can be either before or after -help Error messages will be displayed if missing mandatory information options

Citation preview

Page 1: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

1

DSARCH USAGE

Dataset Archiving Utility Usage

By Zaihua Ji

Page 2: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

2

General DSARCH Usagedsarch [[-DS] dsnnn.n] [Action Option] [Mode Options] [Information Options]

Quotes [] indicate optional Three Option categories: Action, Mode, and Information (Info for short)

Options. Action options - specify what tasks this utility to execute Mode options - modify behaviors of given actions Info options - pass information, one or multiple values, to run DSARCH An option is given in either short or long names, eg. -DS or -Dataset All Action and Mode options, as well as Info option -IF (-InputFile), must

be given on command line; all other info options can be given either on command line or in one or multiple input files specified by option -IF

Page 3: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

3

Get Helpdsarch [Option] [-h[elp]] [Option]

A full help document will be displayed, if DSARCH is issued without any option specified

Description of an individual option will be displayed if DSARCH is issued with -help and a specified option, which can be either before or after -help

Error messages will be displayed if missing mandatory information options

Page 4: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

4

Error Prevention Procedures Input file names must start with dataset number, as in

format of 'dsnnn.n.*’, wildcard '*' matches any valid file name characters

Checks if the DSS staff who executes DSARCH against a given dataset is the specialist listed for that dataset; stops processing if they are different, unless a mode option -MD (-MyDataset) is present

Flag of using RDADB must be set to ‘Y’ (or ‘P’, ‘I’) before starting any actions that will update information in RDADB

Backups information of dataset/groups/files of each dataset into CVS Archive; backup frequencies: instant, multi-run, or overnight

Page 5: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

5

Categories of Action Options Dataset Actions - create, modify and retrieve dataset information in

RDADB Group Actions - create, delete, modify and retrieve dataset group

information in RDADB File Actions

archive files onto MSS and RDA server move and delete files on MSS and RDA server create, delete, modify and retrieve information about data files in RDADB

File-Name Actions - generate, release, retrieve and archive MSS file names (VSN - Volume Serial Number) per RDADB card bank

All-Info Actions - create, modify and retrieve all information for a dataset, groups in dataset, files archived on MSS and RDA Server

Backup Actions - archive, restore, and check CVS backup history information for datasets, groups, and MSS and RDA Server files

Page 6: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

6

Dataset Actions -SD (-SetDataset) - creates and modifies

dataset information in RDADB for a given dataset number

-GD (-GetDataset) - retrieves dataset information from RDADB for a given dataset number

Page 7: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

7

Action -SD (-SetDataset)dsarch [-DS (-Dataset)] dsnnn.n -SD [Mode Options] [-TI (-Title) DatasetTitle] (same as in SCCS document) [-MP (-MSSPath) MSSFilePath] (relative to /DSS/) [-WP (-WebPath) WebFilePath] (relative to /huron/ftp/datasets/dsnnn.n/data/) [-WH (-WebHomeDir) WebHomeDirectory] (eg. /datazone/dsszone/ds090.0) [-UD (-UseRDADB) UsingRDADBFlag] (Y, P, I, or N) [-CD (-Card) DefaultCard] (D, currently) [-BD (-BeginDate) StartDate] (in format of YYYY-MM-DD) [-ED (-EndDate) EndDate] [-PS (-PrimarySize) PrimaryDataSize] (total size of MSS primary data file) [-PF (-PeriodFormat) PeriodFormat] (eg. YYYYmon-YYYYmon) [-DM (-MSSNote) MSSDataNote] [-DI (-InternalNote) MSSInternalNote] [-DW (-WebNote) WebDataNote] [-CC (-CVSComment) CVSCommentString]Ordsarch -SD [Mode Options] -IF (-InputFile) InputFileNames

Page 8: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

8

Mode Options for Action -SD -CS (-CVSSave) - instant CVS backup -SS (-SetPrimarySize) - resets total data

size of all primary MSS data files -MD (-MyDataset) - forces update of a

dataset listed for a specialist other than yourself

Page 9: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

9

Info Option -IF (-InputFile) One or multiple input file names may be given on command line A input file name must start with dataset number as in format of 'dsnnn.n.*’ Lines starting with sign '#' are considered as comments Only information options can be provided in input files Single value is assigned to an Info option in format of

OptionName<=>OptionValue, eg. Dataset<=>ds285.4 Multiple values are assigned to info options as ‘<:>’ delimited columns, eg. MSSFile<:>LocalFile<:>MSSFileType<:> /DSS/D1<:>gridded.tar<:>P<:> /DSS/D2<:>gridded.tar<:>B<:>

Page 10: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

10

Example of Action -SDdsarch ds277.6 -SD -UD Y -CD D -PF YYYYmon-YYYYmon -BD 1980-01-01 -ED 2006-06-30

Page 11: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

11

Action -GD (-GetDataset)dsarch [-DS (-Dataset)] dsnnn.n -GD [-FN (-FieldNames) FieldNameString or ALL] [-PF (-PeriodFormat) PeriodFormat] [-OF (-OutputFile) OutputFileName]Ordsarch -GD -IF (-InputFile) InputFileNames

Page 12: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

12

Info Option -FN (-FieldNames) for Action -GDField Info Field NamesNames Options In RDADB------------------------------------T -TI dataset.titleM* -MP dataset.msspathW* -WP dataset.webpathH* -WH dataset.webhomeU* -UD dataset.use_rdadbC* -CD dataset.default_cardB* -BD dataset.date_startE* -ED dataset.date_endS* -PS dataset.primary_sizeF* -PF dataset.period_formatP -DP dataset.dataset_period # from B, E and FD -DM dataset.mnoteN -DI dataset.inoteO -DW dataset.wnote

* Default field names if missing option -FN

Page 13: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

13

Example of Action -GDdsarch ds277.6 -gd -fn TUCFP

Dataset<=>ds277.6Title<=>NCEP Global Ocean Data Assimilation System (GODAS)UseRDADB<=>PCard<=>DPeriodFormat<=>YYYYmon-YYYYmonDatasetPeriod<=>1980jan-2006jun

Page 14: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

14

Group Actions -SG (-SetGroup) - creates and modifies group

information into RDADB -GG (-GetGroup) - retrieves one of multiple group

information -DG (-DeleteGroup) - deletes one or multiple groups

from RDADB -CG (-ChangeGroup) - changes group indices from

original groups given by option -OG (-OriginGroup) to new groups given by option -GI (-GroupIndex)

Page 15: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

15

Action -SG (-SetGroup)dsarch [-DS (-Dataset)] dsnnn.n -SG [-CS] [-MD] [-GI (-GroupIndex) GroupIndices] (1, 2, 3, …) [-GN (-GroupID) GroupIDs] (Group name up to 20 chars, eg. DAILY in ds260.1) [-TI (-Title) GroupTitles] (a string up to 255 chars) [-GP (-GroupPattern) FileNamePaterns] (eg. daily matches all files named *daily*) [-MP (-MSSPath) MSSFilePaths] (relative to /DSS/) [-WP (-WebPath) WebFilePaths] (relative to /huron/ftp/datasets/dsnnn.n/data/) [-DM (-MSSNote) MSSDataNotes] [-DI (-InternalNote) MSSInternalNotes] [-DW (-WebNote) WebDataNotes] [-CC (-CVSComment) CVSCommentString]Ordsarch -SG [-CS] [-MD] -IF (-InputFile) InputFileNames

Page 16: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

16

Example of Action -SGdsarch -SG -IF ds277.6.grp

##beginning of input file ds277.6.grp######Dataset<=>ds277.6GroupIndex<:>GroupID<:>Title<:>1<:>MONTHLY<:>Monthly Averaged GODAS Data<:>2<:>PENTAD<:>5-Day Averaged GODAS Data<:>##end of input file#####################

Page 17: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

17

Action -GG (-GetGroup)dsarch [-DS (-Dataset)] dsnnn.n -GG [-FN (-FieldNames) FieldNameString or ALL] [-GI (-GroupIndex) GroupIndices] [-GN (-GroupID) GroupIDs] [-OF (-OutputFile) OutputFileName]Ordsarch -GG -IF (-InputFile) InputFileNames

Page 18: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

18

Info Option -FN for action -GGField Info Field NamesNames Options In RDADB------------------------------------I* -GI dsgroup.gindexG* -GN dsgroup.grpidT* -TI dsgroup.titleP* -GP dsgroup.patternM* -MP dsgroup.msspathW* -WP dsgroup.webpathD -DM dsgroup.mnoteN -DI dsgroup.inoteO -DW dsgroup.wnote

* Default field names if missing option -FN

Page 19: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

19

Example of Action -GGdsarch ds277.6 -gg -fn IGT

Dataset<=>ds277.6GroupIndex<:>GroupID<:>Title<:>1<:>MONTHLY<:>Monthly Averaged GODAS Data<:>2<:>PENTAD<:>5-Day Averaged GODAS Data<:>

Page 20: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

20

Action -DG (-DeleteGroup)dsarch [-DS (-Dataset)] dsnnn.n -DG [-CS] [-MD] -GI (-GroupIndex) GroupIndices [-CC (-CVSComment) CVSCommentString]Ordsarch -DG [-CS] [-MD] -IF (-InputFile) InputFileNames

Page 21: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

21

Action -CG (-ChangeGroup)dsarch [-DS (-Dataset)] dsnnn.n -CG [-CS] [-MD] -OG (-OriginGroup) OrignalGroupIndices -GI (-GroupIndex) NewGroupIndices [-CC (-CVSComment) CVSCommentString]Ordsarch -CG [-CS] [-MD] -IF (-InputFile) InputFileNames

Page 22: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

22

Example of Action -CGdsarch ds277.6 -CG -OG 1 2 -GI 2 1

This action will exchange group indices, 1 to 2 and 2 to 1

Page 23: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

23

File Actions -SM (-SetMSSFile) - creates or modifies MSS file information -SW (-SetWebFile) - creates or modifies information of files on RDA server -AM (-ArchiveMSSFile) - archives local data files onto MSS -AW (-ArchiveWebFile) - archives local data files onto RDA server -AB (-ArchiveBoth) - archives local data files onto both MSS and RDA server -GM (-GetMSSFile) - retrieves MSS file information in RDADB -GW (-GetWebFile) - retrieves Web file information in RDADB -CA (-CheckArchive) - checks if files are archived correctly on MSS -CP (-ChangePassword) - changes write/read passwords for given MSS files -MV (-MoveFile) - moves data files from one dataset to another, or from one

group to another of the same dataset -DF (-DeleteFile) - deletes data files from MSS or RDA server -CM (-CopyMSSFile) - copies MSS data files back to local computers

Page 24: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

24

Action -SM (-SetMSSFile)dsarch [-DS (-Dataset)] dsnnn.n -SM [Mode Options] -MF (-MSSFile) MSSFileNames [-MB (-MSSBackup) MSSBackupFiles] [-LF (-LocalFile) LocalFileNames] [-GI (-GroupIndex) GroupIndices] [-TF (-DataFormat) MSSDataFormat] (eg. ASCII, GRID) [-FF (-FileFormat) MSSFileFormat] (eg. BI.TAR, binary COS blocked and then tarred) [-MT (-MSSFileType) MSSFileTypes] (P, B, W, etc.) [-DO (-DisplayOrder) DisplayOrderIndices] (1, 2, 3, …) [-SZ (-FileSize) FileSize] (file size in Bytes) [-DE (-Note) MSSFileNote] [-PM (-PrimaryMSSFile) PrimaryMSSFiles] (Primary file name for backup one) [-PW (-PasswordWrite) WritePassword] (Y or N) [-PR (-PasswordRead) ReadPassword] (Y or N) [-BD (-BeginDate) StartDate] [-ED (-EndDate) EndDate] [-PS (-PrimarySize) PrimaryDataSize] [-CC (-CVSComment) CVSCommentString]Ordsarch -SM [Mod Options] -IF (-InputFile) InputFileNames

Page 25: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

25

Mode Options for Action -SM -CS (-CVSSave) - instant CVS backup -SS (-SetPrimarySize) - resets total data

size of all primary MSS data files -RO (-ResetOrder) - Resets file display

order as the given file list -MD (-MyDataset) - forces update of a

dataset listed for a specialist other than yourself

Page 26: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

26

Action -SW (-SetWebFile)dsarch [-DS (-Dataset)] dsnnn.n -SW [-CS] [-RO] [-MD] -WF (-WebFile) WebFileNames [-GI (-GroupIndex) GroupIndices] [-TF (-dataFormat) WebDataFormat] [-FF (-FileFormat) WebFileFormat] [-DO (-DisplayOrder) DisplayOrderIndices] [-PM (-PrimaryMSSFile) PrimaryMSSFiles] [-SZ (-FileSize) FileSizes] [-DE (-Note) WebFileNotes] [-CC (-CVSComment) CVSCommentString]Ordsarch -SW [-CS] [-RO] [-MD] -IF (-InputFile) InputFileNames

Page 27: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

27

Action -AM (-ArchiveMSSFile)dsarch [-DS (-Dataset)] dsnnn.n -AM [Mode Options] -LF (-LocalFile) LocalFileNames (support file name wildcards) [-CD (-Card) CardVolume] (default to Card Volume saved for dsnnn.n) [-MF (-MSSFile) MSSFileNames] (auto-generated as default) [-MB (-MSSBackup) MSSBackupFileNames] (auto-generated as default) [-BE (- BackupExtension) BackupfileExtension] [-GI (-GroupIndex) GroupIndices] [-MP (-MSSPath) MSSFilePaths] (default to path saved for dsnnn.n or its group) [-PW (-PasswordWrite) WritePassword] (default to 4DSnnn.n) [-PR (-PasswordRead) ReadPassword] [-FF (-FileFormat) MSSFileFormat] (default to TR - transparency) [-TF (-DataFormat) MSSDataFormat] [-MT (-DataFormat) MSSFileTypes] (default to P and B, two MSS archives for each local file) [-RD (-RetentionDays) RetentionDays] (default to 32767) [-DE (-Note) MSSFileNote] [-BD (-BeginDate) StartDate] [-ED (-EndDate) EndDate] [-PS (-PrimarySize) PrimaryDataSize] [-CC (-CVSComment) CVSCommentString]Ordsarch -AM [Mode Options] -IF (-Inputfile) InputFileNames

Page 28: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

28

Mode Options for Action -AM -CS (-CVSSave) - instant CVS backup -DC (-DoCOSBlock) - adds COS Block while archiving -HC (-HeldCard) - gets MSS file names from previously held VSN -KN (-KeepLocalName) - uses local file names for MSS archives -KP (-KeepLocalPath) - retains local relative path onto MSS under /DSS/ -NB (-NoBackup) - does not create backup copies -NP (-NoPassword) - does not use any password for MSS archives -NS (-NoSetArchInfo) - does not set file info into RDADB after archiving -NW (-NoWait) - does not wait MSS command to finish before jump to archive

next data file -RP (-RecursivePath) - archives local files through local paths recursively -SS (-SetPrimarySize) - resets total size of primary MSS files after archiving -WB (-WithBackup) - forces backup copies -MD (-MyDataset) - forces update of a dataset listed for a specialist other than

yourself

Page 29: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

29

Example of Action -AMdsarch ds277.6 -AM -GI 2 -TF GRIB -FF

GZ.TAR -LF godas.P.2006??.tar

Six tarred pentad data files, godas.P.200601.tar, …, godas.P.200606.tar, are archived onto MSS for ds277.6. All six archived data files are for Group 2 with data format ‘GRIB’ and file format as GZ.TAR. The file format GZ.TAR means each file is tarred from multiple gzipped data files

Page 30: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

30

Action -AW (-ArchiveWebFile)dsarch [-DS (-Dataset)] dsnnn.n -AW [Mode Options] -LF (-LocalFile) LocalFileNames [-WF (-WebFile) WebFileNames] (default to local file names) [-GI (-GroupIndex) GroupIndices] [-FF (-FileFormat) WebFileFormat] [-TF (-DataFormat) WebDataFormat] [-WT (-WebFileType) WebFileTypes] (D, S, O) [-DE (-Note) WebFileNote] [-WP (-WebPath) WebFilePaths] (default to saved path) [-CC (-CVSComment) CVSCommentString]Ordsarch -AW [Mode Options] -IF (-Inputfile) InputFileNames

Page 31: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

31

Mode Options for Action -AW -CS (-CVSSave) - instant CVS backup -KP (-KeepLocalPath) - retains local relative path onto

RDA server under /huron/ftp/datasets/dsnnn.n/data -NS (-NoSetArchInfo) - does not set file info into

RDADB after archiving -RP (-RecursivePath) - archives local files through local

paths recursively -MD (-MyDataset) - forces update of a dataset listed for

a specialist other than yourself

Page 32: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

32

Action -AB (-ArchiveBoth) Combine both actions -AM and -AW All options applied to -AM or -AM are valid

for -AB Given local data files will be archived onto

both MSS and RDA server

Page 33: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

33

Example of Action -ABdsarch ds277.6 -AB -GI 1 -TF GRIB -FF GZ

-LF godas.M.2006??.grb.gz

Six gzipped monthly data files, godas.M.200601.grb.gz, …, godas.M.200606.grb.gz, are archived onto both MSS and RDA Server for ds277.6. They are for Group 1 with data format GRIB and file format GZ as gzipped

Page 34: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

34

Action -GM (-GetMSSFile)dsarch [-DS (-Dataset)] dsnnn.n -GM [-FN (-FieldNames) FieldNameString or ALL] [-MF (-MSSFile) MSSFileNames] (support wildcards) [-LF (-LocalFile) LocalFileNames] (support wildcards) [-MT (-MSSFileType) MSSFileTypes] (P, B, W, ..) [-GI (-GroupIndex) GroupIndices] [-OF (-OutputFile) OutputFileName]Ordsarch -GM -IF (-InputFile) InputFileNames

Page 35: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

35

Info Option -FN for Action -GMField Info Field NamesNames Options In RDADB------------------------------------F* -MF mssfile.mssfileI* -GI mssfile.gindexL* -LF mssfile.locfileN* -TF mssfile.data_formatM* -FF mssfile.file_formatP* -PM mssfile.pmssid # primary MSS file nameO -DO mssfile.disp_orderP -PR mssfile.read_passwd # 'Y' or 'N' onlyW -PW mssfile.write_passwd # 'Y' or 'N' onlyT* -MT mssfile.propertyS -SZ mssfile.data_sizeC -RN mssfile.rec_countH -RL mssfile.rec_lengthD -DE mssfile.note

* Default field names if missing option -FN

Page 36: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

36

Example of Action -GMdsarch 277.6 -GM -LF godas.M.200606.grb.gz

Dataset<=>ds277.6MSSFile<:>GroupIndex<:>LocalFile<:>DataFormat<:>FileFormat<:>MSSFileType<:>PrimaryMSSFile<:>/DSS/D1819<:>1<:>godas.M.200606.grb.gz<:>GRIB<:>GZ<:>P<:><:>/DSS/D1820<:>1<:>godas.M.200606.grb.gz<:>GRIB<:>GZ<:>B<:>/DSS/D1819<:>

Page 37: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

37

Action -GW (-GetWebFile)dsarch [-DS (-Dataset) dsnnn.n] -GW [-FN (-FiledNames) FieldNameString or ALL] [-WF (-Webfile) WebFileNames] (support wildcards) [-WT (-WebFileType) WebFileTypes] (D, S, O) [-GI (-GroupIndex) GroupIndices] [-OF (-OutputFile) OutputFileName]Ordsarch -GW -IF (-InputFile) InputFileNames

Page 38: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

38

Info Option -FN for Action -GWField Info Field NamesNames Options In RDADB------------------------------------F* -WF wfile.wfileI* -GI wfile.gindexN* -TF wfile.data_formatM* -FF wfile.file_formatP -PM wfile.mssid # MSS primary file name if same dataT* -WT wfile.type # Data, Internal, dOcument, SoftwareO -DO wfile.disp_orderS -SZ wfile.data_sizeC -RN wfile.rec_countH -RL wfile.rec_lengthD -DE wfile.note

* Default field names if missing option -FN

Page 39: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

39

Action -CA (-CheckArchive)dsarch [-DS(-Dataset)] dsnnn.n -CA -MF (-MSSFile) MSSFileNamesOrdsarch -CA -IF (-InputFile) InputFileNames

Page 40: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

40

Action -CP (-ChangePassword)dsarch [-DS (-Dataset)] dsnnn.n -CP [-CS] [-MD] [-OD (-OriginDataset) OrignalDataset] -MF (-MSSFile) MSSFileNames [-OR (OrignRead) OriginalReadPassWord] [-OW (-OrignWrite) OriginalWritePassword] [-PR (-PasswordRead) NewReadPassWord] [-PW (-PasswordWrite) NewWritePassword] [-CC (-CVSComment) CVSCommentString]Ordsarch -CP [-CS] [-MD] -IF (-InputFile) InputFileNames

Page 41: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

41

Action -MV (-MoveFile)dsarch [-DS (-Dataset)] dsnnn.n -MV [-CS] [-MD] -MF (-MSSFile) MSSFileNames [-OD (-OriginDataset) dsmmm.m] [-RF (-OriginFile) OriginalMSSFileNames] [-OG (-OriginGroup) OriginalGroupIndices] [-GI (-GroupIndex) NewGroupIndices] [-OW (-OriginWrite) OriginalWritePassword] (default to 4DSmmm.m) [-PW (-PasswordWrite) NewWritePassword] (default to 4DSnnn.n) [-CC (-CVSCOMMENT) CVSCommentString]Ordsarch [-DS (-Dataset)] dsnnn.n -MV [-CS] [-MD] -WF (-WebFile) WebFileNames [-OD (-OriginDataset) dsmmm.m] [-RF (-OriginFile) OriginalWebFileNames] [-OT (-OriginType) OriginalFileTypes] [-WT (-WebFileType) NewWebFileTypes] [-OG (-OriginGroup) OriginalGroupIndices] [-GI (-GroupIndex) NewGroupIndices] [-CC (-CVSComment) CVSCommentString]Ordsarch -MV [-CS] [-MD] -IF (-InputFile) InputFileNames

Page 42: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

42

Example of Action -MVdsarch -MV -OD ds277.1 -DS ds277.6 [-RF /DSS/Y55689] -MF /DSS/Y55689

MSS file /DSS/Y55689 is moved from ds277.1 to ds277.6 Write password is changed from 4DS277.1 to 4DS277.6

Page 43: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

43

-CM (-CopyMSSFile)dsarch -CM -MF (-MSSFile) MSSFileNames [-DS (-Dataset) dsnnn.n] (mandatory to get saved local file names)

[-LF (-LocalFile) LocalFileNames] (default to saved local file names)

Ordsarch -CM -IF (-InputFile) InputFileNames

Page 44: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

44

Action -DF (-DeleteFile)dsarch [-DS (-Dataset)] dsnnn.n -DF [-CS] [-MD] -MF (-MSSFILE) MSSFileNames [-CC (-CVSComment) CVSCommentString]Ordsarch [-DS (-Dataset)] dsnnn.n -DF [-CS] [-MD] -WF (-WebFile) WebFileNames [-CC (-CVSComment) CVSCommentString]Ordsarch -DF [-CS] [-MD] -IF (-InputFile) InputFileNames

Page 45: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

45

All Info Action -GA (-GetAll) - retrieves dataset, group and file information for a given

dataset. This is a comprehensive action, combining all four Get Actions -GD (-GetDataset) -GG (-GetGroup) -GM (-GetMSSFile) -GW (-GetWebFile)

-SA (-SetAll) - creates and modifies dataset, group and file information into RDADB for a given dataset number. This is a comprehensive action, combining all four Set Actions -SD (-SetDataset) -SG (-SetGroup) -SM (-SetMSSFile) -SW (-SetWebFile)

Page 46: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

46

Action -GA (-GetAll)dsarch -DS (-Dataset) dsnnn.n -GA [-FN (-FieldNames) ALL] [-OF (-OutputFile) OutputFileName]

Page 47: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

47

Action -SA (-SetAll)dsarch -SA -IF (-InputFile) InputFileNames

Page 48: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

48

MSS File Name Actions -GC (-GetCard) - retrieves MSS file names from

RDADB card bank -AC (-ArchiveCard) - archives auto-generated MSS file

names into RDADB card bank -RC (-ReleaseCard) - releases back VSN numbers

being currently Held for a given card volume by the current DSS staff or given MSS file names that were auto-generated from RDADB card bank before

-GH (-GetHistory) - retrieves historical changes of MSS file names from RDADB card bank if the file names were recycled before

Page 49: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

49

Action -GC (-GetCard)dsarch -GC [-HC (-HeldCard)] -CD (-Card) CardVolume [-NC (-NumberCard) NumberOfCards] [-LN (-LoginName) LoginUserName] [-OF (-OutputFile) OutputFileName]Or

dsarch -GC [-HC] -IF (-InputFile) InputFileNames

Page 50: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

50

Action -AC (-ArchiveCard)dsarch -AC -MF (-MSSFile) MSSFileNamesOrdsarch -AC -IF (-InputFile) InputFileName

Page 51: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

51

Action -RC (-ReleaseCard)dsarch -RC [-HC (-HeldCard)] [-MF (-MSSFile) MSSFileNames] [-LN (-LoginName) LoginName]Ordsarch -RC [-HC] -IF (-Inputfile) InputFileName

Page 52: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

52

Action -GH (-GetHistory)dsarch -GH -MF (-MSSFile) MSSFileNamesOrdsarch -GH -IF (-Inputfile) InputFileName

Page 53: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

53

CVS Actions -CB (-CVSBackup) - backs up changes of

file related information in RDADB made to a given dataset into CVS Archive

-CH (-CVSHistory) - checks and displays the CVS backup history of a given dataset

-CR (-CVSRestore) - restores one revision of CVS backup of a given dataset back into RDADB

Page 54: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

54

Action -CB (-CVS Backup)dsarch [-DS (-Dataset)] dsnnn.n -CB -CC (-CVSComment) CVSCommentString

Page 55: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

55

Action -CH (-CVSHistory)dsarch [-DS (-Dataset)] dsnnn.n -CH

Page 56: 1 DSARCH USAGE Dataset Archiving Utility Usage By Zaihua Ji

56

ACTION -CR (-CVSRestore)dsarch [-DS (-Dataset)] dsnnn.n -CR -CV (-CVSRevision) CVSRevisionNumber