drmaa2_lasterror(3) - drmaa2_lasterror, Returns the last error occured within the thread.

drmaa2_lasterror(3)
DRMAA2
drmaa2_lasterror(3)

NAME

drmaa2_lasterror - drmaa2_lasterror, Returns the last error occured within the thread.

SYNOPSIS

#include "drmaa2.h"

typedef enum drmaa2_error { DRMAA2_SUCCESS = 0, DRMAA2_DENIED_BY_DRMS = 1, DRMAA2_DRM_COMMUNICATION = 2, DRMAA2_TRY_LATER = 3, DRMAA2_SESSION_MANAGEMENT = 4, DRMAA2_TIMEOUT = 5, DRMAA2_INTERNAL = 6, DRMAA2_INVALID_ARGUMENT = 7, DRMAA2_INVALID_SESSION = 8, DRMAA2_INVALID_STATE = 9, DRMAA2_OUT_OF_RESOURCE = 10, DRMAA2_UNSUPPORTED_ATTRIBUTE = 11, DRMAA2_UNSUPPORTED_OPERATION = 12, DRMAA2_IMPLEMENTATION_SPECIFIC = 13, DRMAA2_LASTERROR = 14 } drmaa2_error;

drmaa2_error drmaa2_lasterror(void)

DESCRIPTION

Returns the last DRMAA2 related error happend within the thread the function has called. Internally thread local storage is used by DRMAA2 functions for storing errors. This function is usually called when a previous DRMAA2 function call failed resulting in returning a NULL value. A detailed description of the error can be get by using the drmaa2_lasterror_text(3) call.

RETURN VALUES

Returns a drmaa2_error value of the last error occurred. If no error happend yet DRMAA2_SUCCESS is returned.

EXAMPLE

drmaa2_rsession rs = drmaa2_open_rsession(NULL);

if (rs == NULL) {
   if (drmaa2_listerror() == DRMAA2_UNSUPPORTED_OPERATION) {
      printf("Don't use reservations sessions again, they are not supported.\n");
   } else {
      /* handle real error ... */
   }
} else {
   /* Do something with the reservation session ... */
}

AUTHOR