Procedure

     EKSRCH ( EK, search for events )

     ENTRY EKSRCH ( EQRYI, EQRYC, EQRYD, NMROWS, SEMERR, ERRMSG )

Abstract

     Search for EK events matching a specified set of constraints.

Required_Reading

     EK

Keywords

     EK
     EVENT
     FILES
     SEARCH

Declarations

    INTEGER               EQRYI  ( LBCELL : * )
    CHARACTER*(*)         EQRYC
    DOUBLE PRECISION      EQRYD  ( * )
    INTEGER               NMROWS
    LOGICAL               SEMERR
    CHARACTER*(*)         ERRMSG

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     EQRYI      I   Integer component of encoded query.
     EQRYC      I   Character component of encoded query.
     EQRYD      I   D.p. component of encoded query.
     NMROWS     O   Number of rows matching query constraints.
     SEMERR     O   Flag indicating whether semantic error occurred.
     ERRMSG     O   Message describing semantic error, if any.

Detailed_Input

     EQRYI,
     EQRYC,
     EQRYD    are, respectively, the integer, character, and
              double precision portions of an encoded query.
              The query must have been parsed and must have
              its table and column names resolved. Time values
              must have been resolved. The query is expected
              to be semantically correct.

Detailed_Output

     NMROWS   is the number of rows matching the input query
              constraints.

     SEMERR   is a logical flag indicating whether a semantic
              error was detected while attempting to respond to
              the input query.

     ERRMSG   is a descriptive error message that is set if a
              semantic error is detected. Otherwise, ERRMSG
              is returned blank.

Parameters

     LBCELL   is the SPICE cell lower bound.

Exceptions

     1)  If this routine is called when no files are loaded, the
         error SPICE(NOLOADEDFILES) is signaled.

     2)  If the structure of the input query is invalid, this routine
         may fail in mysterious ways.

Files

     See the header of EKQMGR for a description of files used
     by this routine.

Particulars

     NAIF Toolkit-based applications will rarely need to call this
     routine directly; the high-level routine EKFIND should normally
     be used to query the EK system.

     Because the structure of encoded queries is not part of the
     SPICELIB user interface, we strongly recommend that users'
     applications not call this routine directly.

Examples

     See the header of the umbrella subroutine EKQMGR for a
     comprehensive example of the use of EKQMGR's entry points.

Restrictions

     1)  This routine should normally not be called directly from
         users' applications.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)
     B.V. Semenov       (JPL)

Version

    SPICELIB Version 2.1.0, 27-AUG-2021 (JDR)

        Added IMPLICIT NONE statement.

        Edited the header to comply with NAIF standard.

    SPICELIB Version 2.0.1, 10-FEB-2014 (BVS)

        Added description of LBCELL to the $Parameters section of the
        header.

    SPICELIB Version 2.0.0, 16-NOV-2001 (NJB)

        Bug fix: When an already loaded kernel is opened with EKOPR,
        it now has its link count reset to 1 via a call to EKCLS.

    SPICELIB Version 1.2.0, 21-JUL-1998 (NJB)

        ZZEKJSQZ call was added after the ZZEKJOIN call. This change
        reduces the scratch area usage for intermediate results of
        joins. It also prevents ZZEKJOIN from being handed a join
        row set containing a segment vector having no corresponding
        row vectors.

        Removed a comment in the join loop indicating that non-join
        constraints involving comparisons of column entries in the
        table were being activated. This comment was incorrect; the
        constraints in question were applied earlier.

    SPICELIB Version 1.0.1, 07-JUL-1996 (NJB)

        Previous version line was changed from "Beta" to "SPICELIB."

    SPICELIB Version 1.0.0, 23-OCT-1995 (NJB)