User's Guide

CKQUE

Determine if the specified function is running in batch (part of ADAPSTOP)

Function:

Determine if the specified function is running in batch. When the function name isn't found in the batch queues, the stop file is removed. When the function name is found in the batch queues, the function is running and CKQUE returns without removing the stop file.

Parameters:

INSTOP
Input stop file. The name of the stop file that will be deleted when the specified procedure or function does not exist in the batch queues.

SRCHSTR
Search string. The string to be searched for in the output of the "qstat" (SGI) function. This should normally be the name of function running in batch.

Examples:

  1. LAS> ckque instop=bwtrans;stop srchstr=bwtrans

    The output from the UNIX function "qstat" is searched for the string "bwtrans". If it is not found, the stop file "bwtrans;stop" is removed. If it is found, BWTRANS is currently running, and the function returns without removing the stop file.

Description/Algorithm:

Get the input parameters and verify that the input stop file exists. Search for SRCHSTR in the output from the "qstat" function. If SRCHSTR is not found remove the input stop file; otherwise return without doing anything.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [ckque-fatal] Fatal error encountered

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

  2. [ckque-notsgi] CKQUE only supported on SGI systems

    CKQUE requires output from the "qstat" function to determine if the specified function is running in batch. The "qstat" function is only supported on the Silicon Graphics (SGI) systems at this time.

User Notes:

  1. CKQUE requires output from the "qstat" function to determine if the specified function is running in batch. The "qstat" function is only supported on the Silicon Graphics (SGI) systems at this time. The "qstat" function is accessed through the queuestat.csh script.

  2. CKQUE only removes the specified stop file if the search string is not found in the output of "qstat".

  3. SRCHSTR should be unique enough that it does not match anything other than the function name from the output of "qstat". Run qstat to determine if the search string is unique.

  4. Related functions are: ADAPSTOP, STOPFUNC, STOPSTACK, and the "qstat" (SGI) function.