NAME
     drmaa_strerror,      drmaa_get_contact,       drmaa_version,
     drmaa_get_DRM_system - Miscellaneous DRMAA functions.

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 associ-
     ated  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 recon-
     nect to the current session instead of creating a  new  ses-
     sion.  drmaa_init(3) function.

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

  drmaa_version()
     The  drmaa_version()  function  returns  into  the  integers
     pointed  to  by major and minor, the major and minor version
     numbers of the DRMAA library.  For  a  DRMAA  1.0  compliant
     implementation  `1'  and  `0'  will be returned in major and
     minor, respectively.

  drmaa_get_DRM_system()
     The drmaa_get_DRM_system() function returns into  drm_system
     up  to  drm_system_len characters of a string containing Sun
     Grid Engine product and version information.

     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 con-
     taining the Sun Grid  Engine  DRMAA  implementation  version
     information.     In    the   current   implementation,   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 Sun Grid Engine
                    standard configuration files.

     SGE_CELL       If set, specifies the default Sun Grid Engine
                    cell to be used. To address a Sun Grid Engine
                    cell Sun 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 written 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 com-
                    munication 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 indicate an error.  Up  to
     error_diag_len  characters of error related diagnosis infor-
     mation 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
     Unexpected  or  internal  DRMAA  error,  like  system   call
     failure, etc.

  DRMAA_ERRNO_DRM_COMMUNICATION_FAILURE
     Could not contact DRM system for this request.

  DRMAA_ERRNO_AUTH_FAILURE
     The specified request is not processed successfully  due  to
     authorization failure.

  DRMAA_ERRNO_INVALID_ARGUMENT
     The input value for an argument is invalid.

  DRMAA_ERRNO_NO_MEMORY
     Failed allocating memory.

     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).