CDBFB

Summary

Description

Usage

The positional parameters 'release_name' and 'path_name' are required and MUST occur in the order listed.   The flags indicated by "-" can occur in any order following the positional parameters.

Input

CDBS catalog file(s).

Output log from CDBDB application of SQL to the database.

OPUS path file.

OPUS resource file.

Output

none

Resource File

The following parameters appear in the CDBFB resource file. Their values can be specified directly in the resource file itself, or setting values to names from the path file, can be pulled through from the path 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.
CDB_RETRIEVAL_IN_DIR
The directory where incoming reference files and tables listed in a catalog will be found. Successfully installed files will be removed from this directory.
CDB_SQL_DIR
The directory searched for SQL files matching the mask provided for the release_name parameter. This value is usually the same as CDB_CATALOG_IN_DIR, but can be different. Use of the -localfiles qualifier supercedes this value.
CDB_EXTENSION_FOR_SQL_OUTPUT
The file extension that will be applied to the release catalog rootname to form the name of the name of the feedback file (of SQL output) that is sent back to CDBS to indicate a delivery was processed.  Usually '.sqlout'.
CDB_FEEDBACK_LOCAL_DIR
The directory where the SQL output (if not suppressed) will be placed. This file will also be copied to a remote node for CDBS pick-up. CDBS will use this file to confirm that a catalog installation has been performed.
CDB_FEEDBACK_REMOTE_DIR
The directory on the remote machine serving as the destination for the feedback file. CDBS will watch for files in this directory to indicate that a release catalog has been installed.
CDB_FEEDBACK_ADDRESS
The internet name of the remote machine that will serve as the destination for the feedback file.
FIREWALL
The name of the firewall, if any, through which the feedback file will be delivered. Special FTP syntax is used if this field is filled.
CDB_FEEDBACK_USER
The user login for the remote machine serving as the destination for the feedback file.
CDB_TEMP_DIR
The directory where temporary work files used by the program are created. Severe program errors can leave files in this directory for user inspection. Under UNIX, this value is set to '/', which results in temp files created in the system temp directory, usually /tmp.

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.
 

Required Command-Line Arguments

 
release_catalog_mask (required)
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.
 
path_file_name (required)
An OPUS path file providing resource values. The full path name is required (OPUS_DEFINITIONS_DIR is not automatically prepended).
 

Optional Command-Line Arguments

-l[ocal]

Indicates that the catalog and SQL files are to be found in the current working directory, instead of CDB_CATALOG_IN_DIR and CDB_SQL_DIR

-i[npass]

Used to pass an encrypted password for accessing the remote CDBS system.  If this parameter is not supplied, then an interactive prompt for the password value is initiated.  Even in interactive mode, the password should be entered in encrypted format.

Examples

$ cdbfb opus_101_z.cat OPUS_DEFINITIONS_DIR:blue.path

Locates the output from the CDBDB SQL execution, called opus_101_z.sqlout and uses FTP to transfer this file to a CDBS remote machine.