User's Guide

PRODGEN_DAEMON

Continually generate AVHRR products.

Function:

Calls PRODGEN continuously to generate standing order products for all AVHRR archive images located in the prodgen subdirectory of ADAPSARC.

Parameters:

PROCOPT
Processing option. Dictates the processing that will take place on the images.

  = OPS:    Operator present
  = NO_OPS: Operator not present
  = HOLD:   Retain image for
            later processing
  = RM:     Remove image, later
            process from archive

PROCOPT should be set to NO_OPS over the weekends and during holidays. This option indicates that an operator will not be present to respond to tape mount requests and assist in the creation of products. If the creation of a product requires operator assistance, the image will be moved to the soli DMF . When PROCOPT=OPS, PRODGEN_DAEMON will first process all images that were copied to the silo while PROCOPT=NO_OPS. Images will be moved from the /avhrr/prodgen directory on the silo to the prodgen subdirectory of ADAPSARC, appropriate products will be created, and the images will be removed from disk. After the silo directory has been emptied, processing will continue with those images located in the prodgen subdirectory of ADAPSARC. When PROCOPT=HOLD, those images within the prodgen subdirectory of ADAPSARC that require product generation will be moved into the hold subdirectory located in the prodgen subdirectory of ADAPSARC. These images will be retained on disk for later processing. Images for which no products are required are deleted from disk. When PROCOPT=RM, those images within the prodgen subdirectory of ADAPSARC are deleted from disk. An informational message is logged for each image that requires product generation so that the appropriate images can be retrieved from archive and processed.

Examples:

  1. LAS> prodgen_daemon procopt=ops

    First, process all images that have been copied to the silo. Each of these images will be processed by PRODGEN with PROCOPT=OPS. Once the silo has been cleared, continually process the images located in the prodgen subdirectory of ADAPSARC. Each of these images will be processed by PRODGEN with PROCOPT=OPS. After each image is processed by PRODGEN, it is deleted from disk and the silo if it was retrieved from there.

  2. LAS> prodgen_daemon procopt=no_ops

    Continually process images from the prodgen subdirectory of ADAPSARC. Each of these images will be processed by PRODGEN with PROCOPT=NO_OPS. If a product must be created that requires an operator's assistance, the image will be copied to the silo. After each image is processed by PRODGEN, it is deleted from disk.

  3. LAS> prodgen_daemon procopt=hold

    Continually process images from the prodgen subdirectory of ADAPSARC using PRODGEN with PROCOPT=HOLD. If a product is to be created, the image will be moved to the hold subdirectory of the prodgen subdirectory of ADAPSARC. These images are to be processed at a later time. If no products need to be generated, the image will be removed from disk.

  4. LAS> prodgen_daemon procopt=rm

    Continually process images from the prodgen subdirectory of ADAPSARC using PRODGEN with PROCOPT=RM. If a product is to be created, the image will be retained on disk to be processed at a later time. If no products need to be generated, the image will be removed from disk.

Description/Algorithm:

PRODGEN_DAEMON monitors the prodgen subdirectory of ADAPSARC for AVHRR archive images. The function locks an image, calls PRODGEN to produce the necessary standing order products, and deletes the image when appropriate.

When PROCOPT=OPS, the function will first retrieve images located in the /avhrr/prodgen directory on the silo. Each of these images is processed by PRODGEN with PROCOPT=OPS. After all of the images on the silo have been processed, PRODGEN_DAEMON will switch to processing those images located in the prodgen subdirectory of ADAPSARC. Each of these images is processed by PRODGEN with PROCOPT=OPS.

When PROCOPT=NO_OPS, the function will process the images located in the prodgen subdirectory of ADAPSARC. Each of these images is processed by PRODGEN with PROCOPT=NO_OPS.

When PROCOPT=HOLD, the function will process the images located in the prodgen subdirectory of ADAPSARC. Each of these images is processed by PRODGEN with PROCOPT=HOLD.

When PROCOPT=RM, the function will process the images located in the prodgen subdirectory of ADAPSARC. Each of these images is processed by PRODGEN with PROCOPT=RM.

PRODGEN_DAEMON will continually produce products. To stop the function, run ADAPSTOP-FUNC with FUNCNAM=PRODGEN.

Nonfatal Error Messages:

  1. [daemon-del] Error deleting archive <xxxxx> on <yyyyy>

    An error was encountered deleting the archive image or header file on disk or silo. The log file PRODGEN.LOG should be examined, and this file should be deleted manually.

  2. [daemon-prodgen] Error returned by PRODGEN

    An error was encountered producing the necessary products for an image. The log file PRODGEN.LOG should be examined, and the appropriate products will have to be created manually.

  3. [daemon-ucfmread] Error reading archive image from silo

    An error was encountered reading an archive image from the silo. The log file PRODGEN.LOG should be examined and the specified archive image should be unlocked in the prodgen directory on the silo. This error normally occurs when there is a problem accessing the silo over the network. Once the network problems have been corrected and the image(s) are unlocked, this function should be stopped and restarted in order to retry processing the images on the silo.

  4. [daemon-ucfmstop] Error accessing silo. Switching to disk.

    An error was encountered accessing the silo through NFS. PRODGEN_DAEMON will stop processing those images located on the silo and will switch to processing those images located on disk. When the problem is resolved, this function should be stopped and restarted.

  5. [daemon-stage] Error staging archive image

    An error was encountered staging an image from the silo. The log file PRODGEN.LOG should be examined, and the specified archive image should be unlocked in the prodgen directory on the silo. This error normally occurs when there is a problem accessing the silo over the network. Once the network problems have been corrected, this function should be stopped and restarted.

  6. [daemon-unlock] Error unlocking archive image on <xxxxx>

    An error was encountered unlocking the archive image on disk or silo. The log file PRODGEN.LOG should be examined and the appropriate lock file should be removed manually.

Fatal Error Messages:

  1. [daemon-fatal] Fatal error encountered

    A fatal error was encountered. The message displayed preceding this message is the error that was encountered. Processing terminates.

  2. [daemon-findfiles] Error returned by FINDFILES

    An error was returned by the FINDFILES function. Consult the User's Guide for this function to determine the appropriate action.

  3. [daemon-lock] Error locking archive image

    This function was unable to lock an archive image. Ensure the permissions are set appropriately for the prodgen subdirectory of ADAPSARC and the /avhrr/prodgen directory on the silo.

  4. [daemon-split] Error splitting file names

    An error was returned by the SPLITNAME function. Consult the User's Guide for this function to determine the appropriate action.

  5. [daemon-wait] Error waiting for <xxxxx> minutes

    An error was encountered waiting for the specified number of minutes. This error will normally appear if the user aborts the function. Re-run the function.

User Note:

  1. The ADAPSTOP function may be used to stop this function at any time. If multiple copies of this function are running and the user wishes to reduce the number of running copies, all copies must be stopped and the desired number of copies must be restarted.

  2. This function should be stopped before a weekend or holiday and restarted with PROCOPT=NO_OPS. It should then be stopped and restarted with PROCOPT=OPS when the operators return to work. If processing is to be deferred, PROCOPT=HOLD will move the images into a holding directory for later processing. Note that this option will quickly fill up disk space. If processing is to be deferred but sufficient disk space to store the images is unavailable, PROCOPT=RM will remove the images and log the images for which products are required. These images will need to be restored from archive tape and processed at a later time.

  3. Associated functions are ADAPSTOP, PRODEDIT, and PRODGEN.