SYNOPSIS
       #include "drmaa.h"

       const char *drmaa_strerror(
              int drmaa_errno
       );

       int drmaa_get_contact(
              char *contact,
              size_t contact_len,
              char *error_diagnosis,
              size_t error_diag_len
       );

       int drmaa_version(
              unsigned int *major,
              unsigned int *minor,
              char *error_diagnosis,
              size_t error_diag_len
       );

       int drmaa_get_DRM_system(
              char *drm_system,
              size_t drm_system_len,
              char *error_diagnosis,
              size_t error_diag_len
       );

       int drmaa_get_DRMAA_implementation(
              char *drm_impl,
              size_t drm_impl_len,
              char *error_diagnosis,
              size_t error_diag_len
       );


DESCRIPTION
       The drmaa_strerror() function returns a message  text  associated  with
       the  DRMAA  error  number,  drmaa_errno.  For invalid DRMAA error codes
       `NULL' is returned.

   drmaa_get_contact()
       The drmaa_get_contact() returns an  opaque  string  containing  contact
       information  related  to  the current DRMAA session to be used with the
       drmaa_init(3) function. The  opaque  string  contains  the  information
       required by drmaa_init() to reconnect to the current session instead of
       creating a new session.  drmaa_init(3) function.

       The drmaa_get_contact() function returns  the  same  value  before  and
       after drmaa_init(3) is called.
       The drmaa_get_DRM_system() function returns the same value  before  and
       after drmaa_init(3) is called.


   drmaa_get_DRMAA_implementation()
       The  drmaa_get_DRMAA_implementation()  function returns into drm_system
       up to drm_system_len characters of a string containing the  Univa  Grid
       Engine DRMAA implementation version information.  In the current imple-
       mentation, the drmaa_get_DRMAA_implementation()  function  returns  the
       same result as the drmaa_get_DRM_system() function.

       The  drmaa_get_DRMAA_implementation()  function  returns the same value
       before and after drmaa_init(3) is called.


ENVIRONMENTAL VARIABLES
       SGE_ROOT       Specifies the location of the Univa Grid Engine standard
                      configuration files.

       SGE_CELL       If  set, specifies the default Univa Grid Engine cell to
                      be used. To address a Univa Grid Engine cell Univa  Grid
                      Engine uses (in the order of precedence):

                             The name of the cell specified in the environment
                             variable SGE_CELL, if it is set.

                             The name of the default cell, i.e. default.


       SGE_DEBUG_LEVEL
                      If set, specifies that debug information should be writ-
                      ten  to stderr. In addition the level of detail in which
                      debug information is generated is defined.

       SGE_QMASTER_PORT
                      If set, specifies the tcp port on  which  sge_qmaster(8)
                      is  expected to listen for communication requests.  Most
                      installations will use a services map entry  instead  to
                      define that port.

RETURN VALUES
       Upon  successful  completion, drmaa_get_contact(), drmaa_version(), and
       drmaa_get_DRM_system() return DRMAA_ERRNO_SUCCESS. Other  values  indi-
       cate  an error.  Up to error_diag_len characters of error related diag-
       nosis information is then provided in the buffer error_diagnosis.


ERRORS
       The drmaa_get_contact(), drmaa_version(),  drmaa_get_DRM_system(),  and
       drmaa_get_DRMAA_implementation() will fail if:

   DRMAA_ERRNO_INTERNAL_ERROR

       The drmaa_get_contact() and drmaa_get_DRM_system() will fail if:

   DRMAA_ERRNO_NO_ACTIVE_SESSION
       Failed because there is no active session.

SEE ALSO
       drmaa_session(3).



UGE 8.0.0                $Date: 2008/07/08 09:10:04 $            drmaa_misc(3)