User's Guide

DBTRANS

Transfer database files

Function:

Transfer database files across the network to the database management system.

Example:

  1. LAS> ush $adapsbase/dbtrans

    The appropriate database records will be transferred across the network to the database management system.

Description/Algorithm:

Concatenate the appropriate database records into a file and transfer them to the database manager host system. The database records to be copied to the database manager host system include:

(1) Records to update indicating that an AVHRR scene has
    now become a part of a stitched half orbit.
(2) New AVHRR archive scenes (including orbital
    stitched images).

The database record file names to be transferred match the following UNIX syntax:

(1) ADAPSDB/[01]*.orb		(See description (1) above)

(2) ADAPSDB/a[ghlo]*.dat	(ADAPSDB configured for the
				 ADAPS production environment,
				 see description (2) above)

The database record files are concatenated into the following files (UNIX syntax):

(1) ADAPSDB/ORBITddHHMMSS.orbit
(3) ADAPSDB/NEWddHHMMSS.new

where dd = the current system day
      HH = the current system hour
      MM = the current system minute
      SS = the current system second

These file specifications coincide to the descriptions 1 through 2 above. The ADAPSDB in (1) and (2) must be configured for the ADAPS production environment.

The destination of the concatenated files on the database manager host system is:

(1) DBUSRDBSYS:DBDIR/avhrr.orbit.SYSDATE
(2) DBUSRDBSYS:DBDIR/avhrr.new.SYSDATE

where DBUSR = user ID transfering data records
      DBSYS = database manager host system
      DBDIR = directory on host system
      SYSDATE = current system date

On the original source system, the concatenated record files are copied into the 'old' subdirectory below their current directory. The concatenated record files are also renamed so that their suffix is ";pr". All processing messages will be written to the log file 'dbtrans;log' in the ADAPSLOG directory.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

    None.

User Notes:

  1. Each processing system within ADAPS (ADAPS, and Global 1KM) requires a set of environment variables to point to its own set of directories. For example, ADAPS, KM1, and ARCH each have their own directory used for ADAPSDB. To ensure the database records are being transferred from the correct directory, the user should verify that ADAPSDB is set to the database directory for the correct processing system.

  2. For more information on the archive database records, refer to the AVHRRDB and UPDATEDB User's Guides. For more information on orbital stitch database records, refer to the ORBSTITCH User's Guide.

  3. DBTRANS has been written without a procedure PDF so that it may be executed as a UNIX cron job. This approach will facilitate the automation of the database transfer requirements.