User's Guide

STOPMICRO

Create stop files for the MICRO batch function

Function:

Create stop files for the MICRO batch function. Create a stop file in the ADAPSTABLES directory which signals MICRO to stop generating microfiche. Only the MICRO that is running for the specified IMGTYPE will be stopped. When the stop file(s) exist, MICRO will stop at the next convenient time (see User Notes).

Parameters:

IMGTYPE(BOTH)
Type of image. Stop the MICRO function that is generating microfiche for the specified image type. There may be one MICRO function running for each image type. By default a stop file is created for both MICRO functions.

  = AMER:  North America HRPT images.
  = WORLD: World-wide HRPT and LAC images.
  = BOTH:  Both MICRO processes

Examples:

  1. LAS> stopmicro imgtyp=amer

    A stop file for the MICRO function will be created in the ADAPSTABLES directory. It will signal the MICRO function that is generating North America HRPT microfiche to stop processing at the next convenient time.

Description/Algorithm:

Create a stop file in the ADAPSTABLES directory for the specified IMGTYPE. When the stop file "micro_IMGTYP;stop" exists, the MICRO function that is running for the specified IMGTYPE will stop at the next convenient time.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [stopmicro-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. STOPMICRO is used to stop the microfiche generation function. A stop file is created for each microfiche image type. When MICRO finds the stop file in the ADAPSTABLES directory it will stop at a convenient time (after the generation of a microfiche has completed, ...). See the MICRO user's guide to determine what constitutes a conveniant time.

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

  3. No checks are made to determine if the user running STOPMICRO is the same as the user running the function to be stopped. If the ADAPSTABLES directory has write permission for a user, they are able to stop the MICRO 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.