CDBDSK

Summary

This command installs calibration reference files and tables, listed by rootname in a release catalog, in the reference file directories if there is sufficient disk space. The installation can consist of converting incoming files from FITS to GEIS format when necessary and moving new files to the reference file directories.

Description

Reads each release catalog identified by the first command line argument, and verifies that reference files/tables listed in the catalog can be found on disk in either the incoming (CDB_RETRIEVAL_DIR) or reference file directories. The reference file directories are defined by environment variables (logicals) in opus_login (e.g. uref, nref, mtab, ttab, etc.) If files are found for every catalog entry, then a disk check is performed to ensure that there is sufficient disk space in each of the reference file directories to hold the files in the catalog installation. If all file checks and disk space checks succeed, the files are copied and/or converted from the incoming directory to the reference file directories. Resource items (CDB_PIPELINE_CAL_*) indicate the file type required by the pipeline for each reference file/table type. If the pipeline file type needed is GEIS and the incoming file is FITS, then the STSDAS task strfits is run to perform the conversion. If the pipeline requires FITS format and the incoming file is FITS, then the file is just moved into the reference file directory.

Usage

cdbdsk release_name path_name

[-localfiles] [-checkonly] [-nofitscheck] The flags (preceded by a dash '-') are optional and can be specified in any order by any number of unique characters (e.g. -localfiles, -loc, -l are treated equally). The positional parameters 'release_name' and 'path_name' are required and MUST occur in the order listed.

Input

OPUS path file.

OPUS resource file.

Output

- Convert the retrieved CDBS files from FITS format to GEIS format if necessary.

- Move the CDBS reference files from the retrieval directory to an OPUS instrument-specific reference file directory (as defined by environment variables in opus_login).

Constraint

The FITS-to-GEIS conversion task strfits will not overwrite an existing file with the same name in a reference file directory. A mangled name is used for the resulting file (usually a numeric string like "_01" is appended to the filename). This is done by the IRAF software that runs under strfits. Existing files with the same name will not occur under normal pipeline operation, but if you are attempting to install a catalog that might have been attempted before, carefully check the output messages for indications that file renaming occurred.

Resource File

CDB_CATALOG_IN_DIR

The directory searched for release catalogs matching the mask provided for the release_name parameter. Successfully installed catalogs and SQL files will be removed from this directory. Use of the -localfiles qualifier supercedes this value.

The directory where incoming reference files and tables listed in a catalog will be found. Successfully installed files will be removed from this directory.

NOTE: DO NOT USE A LOGICAL IN THE DEFINITION OF THIS PARAMETER.

VMS ONLY: THIS PARAMETER IS PASSED TO IRAF WHICH CURRENTLY CANNOT DEAL WITH A LOGICAL NAME. USE A FULL DIRECTORY PATH IN THE DEFINITION, EITHER IN CDB_UPDATE.RESOURCE, OR IN THE PATH FILE IF THIS PARAMETER IS LINKED TO A MNEMONIC IN THE PATH FILE.

The directory where default IRAF parameter files are stored. The IRAF task 'strfits' is used to convert files from FITS to GEIS format and default parameters supplied to the task are read from this directory. This parameter is not used under UNIX.

The percentage of the exact disk space required for installation that is added to the exact disk space required when determining if enough space exists for catalog installation. (e.g. Providing a value of "3" implies that "1.03*exact space required" will be used to determine if sufficient disk space exists, i.e. 3% slop)

not

Required Command-Line Arguments

A newly released catalog file name. Wild card names are permitted. Will be searched for in CDB_CATALOG_IN_DIR unless the -localfiles flag is set on the command line, in which case the current directory is used.

Optional Command-Line Arguments

-c[heck_only]

Optional flag specifying that only catalog verification is performed. This consists of locating the files listed in the catalog on disk and verifying that sufficient free disk space exists to perform the installation. No disk changes are made in this mode.

Optional flag specifying that CDBDSK will look in the current working directory for the release catalogs. If no catalogs are found, no processing will be performed.

Examples

$ cdbdsk opus_101_z.cat OPUS_DEFINITIONS_DIR:blue.path -check

Verifies that the files listed in the catalog OPUS_101_Z.CAT exist on disk in either the incoming (CDB_RETRIEVAL_IN_DIR) or reference file directories. If found in the incoming directory, disk space checks are made to verify that the installation can be performed. No file installations or conversions are performed in "check" mode.

$ cdbdsk opus_242_y.cat OPUS_DEFINITIONS_DIR:blue.path -local

Updates the reference file directories for all released files mentioned in the catalog OPUS_242_Y.CAT. The release catalog should reside in the current working directory.