ARCGEN
This command backups the datasets to tape, delete the datasets from the
OPUS pipeline directories, and updates the appropriate database
relations.
Format: ARCGEN ARCHCLASS /DEVICE /DATA_PATH [/CHECK] [/MATCH]
[/TAPE ] [/VERIFY] [/NOTIFY] [/DIR]
Context
Inputs
A valid Archive Class.
Valid archive classes are :
AAT - Analysed Astrometry Data ANC - Ancillary Data
AST - Astrometry CAL - Calibrated Science
DMP - Dump EDT - Edited Science
ENG - Engineering ORB - Definitive Orbit
MSC - SPSS mission schedule data MTL - SPSS mission timeline data
SMS - SPSS science mission spec. data OCX - OSS data quality comments
PDQ - PODPS data quality comments PRB - Problem science data
RPT - Pipeline daily reports SUB - Engineering subset data
OMS - OMS jitter data
ALL - All classes that have any
ARCHIVE_REQ records.
Outputs
Based on Qualifiers. See help on Qualifiers.
Constraints
This command must have OK_TO_UPDATE_DATABASE set to TRUE to
execute. ARCGEN is an interactive command and should not be brought up
under the PMG (Process Manager). Individual dataset names cannot be
specified as a parameter for this command.
Parameters
ARCHCLASS
3-character archive class designator. This can be a single archive class
or a list of archive classes separated by a comma. For a list of valid
archive classes, see Context, Inputs help.
Qualifiers
/DEVICE
The device qualifier specifies the magnetic tape device for which the
archive tapes are written.
/DATA_PATH
Specifies which data path the user would like to utilize.
/CHECK
When the /CHECK qualifier is specified, only those files that have
already been successfully archived by DADS will be backed up to tape and
cleaned out from the pipeline directories. For any file backed up to tape,
if the archive request for that file has been made to DADS, but DADS has
not successfully archived the dataset, and the response need not be
checked, then a TAPE archive request will be generated for the dataset
and sent to DADS so that DADS can archive from tape.
When the /NOCHECK qualifier is specified, every file available for
archiving under the active archive class will be backed up to tape
regardless of whether or not it has been archived to DADS. TAPE archive
requests will be generated for each dataset that has a pending status or
a failed DISK archive request.
The default is /CHECK.
/MATCH
When the /MATCH qualifier is specified, only those datasets that have the
correct file counts will be written to tape. A message will be displayed
to the operator when a dataset is skipped due to a file count mismatch.
The default is MATCH. Using the /NOMATCH qualifier will override the file
count checking.
/TAPE
NOTAPE specifies that no backup tape will be made.
The /TAPE qualifier specifies that copies to tape will be made in
accordance with the presence of the /CHECK or /NOCHECK qualifier. A value
of "SAME" for the /TAPE qualifier specifies that all archive classes will
be archived using the same backup_id number. Using the value "SEPARATE"
will cause ARCGEN to retrieve a new backup_id for each archive class and
put them on separate tapes.
The default is /TAPE=SAME.
/VERIFY
This qualifier specifies whether the archive tape is verified after it is
written. The default for tapes written on an EXABYTE device is /NOVERIFY
and the default for a standard magnetic tape device is /VERIFY.
/NOTIFY
This qualifier specifies whether the notify bell will sound when each
archive class has completed printing.
The default is NOTIFY.
/DIR
This is to be used for testing only. The directory qualifier will override
writing the saveset to tape. Instead the saveset will be written to the
disk directory specified. If the optional directory specification is
omitted, the saveset will be written to the default OPUS_HOME_DIR
directory. All the backup command procedures and saveset listings created
are retained on disk. These should be reviewed and deleted by operations
periodically.
Examples
$ARCGEN/device=mka500/data_path=opus_definitions_dir:science.path EDT
Archive EDT dataset to tape device mka500 using the data from the
science path.
$ARCGEN/device=mka500/data_path=opus_definitions_dir:noscience.path -
ENG,SUB,ANC
Archive the ENG, SUB, and ANC dataset to tape device mka500 using
the data from the nonscience path.