User's Guide

STOPSTACK

Create stop files for the AVHRRSTACK batch function

Function:

Create stop files for the AVHRRSTACK function. Create a stop file in the ADAPSTABLES directory which signals AVHRRSTACK to stop stacking images to tape. Only the AVHRRSTACK that has DRIVE allocated will be stopped. When the stop file(s) exists AVHRRSTACK will stop at the next convenient time (see User Notes).

Parameters:

DRIVE(--)
Tape drive. The tape drive that AVHRRSTACK is currently using. Only the AVHRRSTACK that has DRIVE allocated will be stopped when more than one version of AVHRRSTACK is running. The default will create a stop file for all drives that AVHRRSTACK has allocated. This is determined by looking for the AVHRRSTACK lock files in ADAPSTABLES.

Examples:

  1. LAS> stopstack drive=sg2@2

    A stop file for the AVHRRSTACK function will be created in the ADAPSTABLES directory. It will signal the AVHRRSTACK function using the remote drive sg2@2 to stop processing at the next convenient time.

  2. LAS> stopstack

    A stop file will be created in the ADAPSTABLES directory for each AVHRRSTACK function that has a lock file. These stop files will signal each of the AVHRRSTACK functions running to stop processing at the next convenient time.

Description/Algorithm:

Create a stop file in the ADAPSTABLES directory for the specified DRIVE(s). When the stop file "avhrrstack_DRIVE;stop" exists, only the AVHRRSTACK function that has the specified DRIVE locked will stop at the next convenient time. When AVHRRSTACK is running, it creates a lock file in ADAPSTABLES for the drive it is using. If the lock file doesn't exist for the specified DRIVE, AVHRRSTACK is not using that drive and no stop file is created. By default, a stop file will be created in ADAPSTABLES for each lock file found in ADAPSTABLES.

Nonfatal Error Messages:

  1. [stopstack-nonftl] Nonfatal error encountered

    A nonfatal error was encountered during processing. The message that is displayed immediately preceding this error message is the specific error that was encountered.

  2. [stopstack-norun] AVHRRSTACK not using drive <XXXXX>

    AVHRRSTACK is not currently stacking AVHRR archive images to tape drive <XXXXX>. Ensure the correct tape drive was specified.

Fatal Error Messages:

  1. [stopstack-fatal] Fatal error encountered

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

User Notes:

  1. STOPSTACK is used to stop the tape stacking function. A stop file is created for each drive that an AVHRRSTACK function is using. When AVHRRSTACK finds the stop file in the ADAPSTABLES directory it will stop at a convenient time (after a file is copied to 8mm tape or when the 3480 tape is full, ...). See the AVHRRSTACK user's guide to determine what constitutes a convenient time.

  2. STOPSTACK and AVHRRSTACK do not remove the stop file(s) when completed. ADAPSTOP runs STOPSTACK and CKQUE to create the stop file(s), monitor the batch queues for the AVHRRSTACK processes, and remove the stop file(s). The user is responsible for removing the stop file(s) in ADAPSTABLES when STOPSTACK is run stand-alone.

  3. No checks are made to determine if the user running STOPSTACK is the same as the user running AVHRRSTACK. If the ADAPSTABLES directory has write permission for a user, they are able to stop the AVHRRSTACK function.

  4. The stop file is a TAE parameter file that contains the stop file name and the name of the function that is to be stopped.