3 - ACTION OPTIONS

Action options tell dsarch what to do. They take no values. Some actions perform a single task; others bundle multiple tasks together and may trigger additional steps when certain Mode options are present. Only one Action option may be specified per execution.

Write actions require the -UD (-UseDSARCH) flag to be set to ‘Y’, ‘I’, ‘P’, or ‘W’ for the target dataset before they can modify GDEXDB. Read actions have no such requirement.

Actions are grouped into seven categories based on the information they handle:

Dataset Actions	create, modify and retrieve dataset information in GDEXDB
DOI/Version Actions	add, modify, view and terminate DOI/Version control for a given dataset
Group Actions	create, delete, modify and retrieve group information in GDEXDB, of a given dataset
File Actions	archive local data files as Saved/Web/Help files; move and delete archived files on GDEX Server; create, delete, modify and retrieve information of archived files in GDEXDB, of a given dataset, and groups if specified
All Info Actions	create, modify and retrieve all information, of dataset, groups and files of a given dataset in GDEXDB
Webpage Actions	regenerate dataset main and filelist webpages

Table of Contents

• 3.1 - Dataset Actions
  • 3.1.1 - Set Dataset Information
  • 3.1.2 - Get Dataset Information
• 3.2 - DOI/Version Actions
  • 3.2.1 - Set Version Control
  • 3.2.2 - Get Version Control
  • 3.2.3 - Terminate Version Control
• 3.3 - Group Actions
  • 3.3.1 - Set Group Information
  • 3.3.2 - Get Group Information
  • 3.3.3 - Delete Group Information
  • 3.3.4 - Change Group Information
• 3.4 - File Actions
  • 3.4.1 - Set Saved File Information
  • 3.4.2 - Get Saved File Information
  • 3.4.3 - Set Web File Information
  • 3.4.4 - Get Web File Information
  • 3.4.5 - Set Help File Information
  • 3.4.6 - Get Help File Information
  • 3.4.7 - Set Quasar File Information
  • 3.4.8 - Get Quasar File Information
  • 3.4.9 - Archive Saved Files
  • 3.4.10 - Archive Web Files
  • 3.4.11 - Archive Help Files
  • 3.4.12 - Backup Quasar Files
  • 3.4.13 - Restore Quasar Files
  • 3.4.14 - Move Saved/Web/Help/Quasar Files
  • 3.4.15 - Delete Saved/Web/Help/Quasar Files
• 3.5 - All Info Actions
  • 3.5.1 - Get All Information
  • 3.5.2 - Set All Information
• 3.6 - Webpage Actions
  • 3.6.1 - Regenerate Dataset Webpages
  • 3.6.2 - Increment Cache Number

Appendix A: List of Examples

• A.1. Action Option -SD (-SetDataset)

• A.2. Action Option -GD (-GetDataset)

• A.3. Action Option -SV (-SetVersion)

• A.4. Action Option -GV (-GetVersion)

• A.5. Action Option -TV (-TerminateVersion)

• A.6. Action Option -SG (-SetGroup)

• A.7. Action Option -GG (-GetGroup)

• A.8. Action Option -DG (-DeleteGroup)

• A.9. Action Option -CG (-ChangeGroup)

• A.10. Action Option -GW (-GetWebFile)

Back to Top

Back to Table of Contents