NAME
     drmaa_allocate_job_template,      drmaa_delete_job_template,
     drmaa_set_attribute,                    drmaa_get_attribute,
     drmaa_set_vector_attribute,      drmaa_get_vector_attribute,
     drmaa_get_next_attr_value,        drmaa_get_num_attr_values,
     drmaa_release_attr_values - Sun Grid Engine DRMAA  job  tem-
     plate handling

SYNOPSIS
     #include "drmaa.h"

     int drmaa_allocate_job_template(
          drmaa_job_template_t **jt,
          char *error_diagnosis,
          size_t error_diag_len
     );

     int drmaa_delete_job_template(
          drmaa_job_template_t *jt,
          char *error_diagnosis,
          size_t error_diag_len
     );

     int drmaa_set_attribute(
          drmaa_job_template_t *jt,
          const char *name,
          const char *value,
          char *error_diagnosis,
          size_t error_diag_len
     );

     int drmaa_get_attribute(
          drmaa_job_template_t *jt,
          const char *name,
          char *value,
          size_t value_len,
          char *error_diagnosis,
          size_t error_diag_len
     );

     int drmaa_set_vector_attribute(
          drmaa_job_template_t *jt,
          const char *name,
          const char *value[],
          char *error_diagnosis,
          size_t error_diag_len
     );

     int drmaa_get_vector_attribute(
          drmaa_job_template_t *jt,
          const char *name,
          drmaa_attr_values_t **values,
          char *error_diagnosis,
          size_t error_diag_len
     );

     int drmaa_get_next_attr_value(
          drmaa_attr_values_t* values,
          char *value,
          int value_len
     );

     int drmaa_get_num_attr_values(
          drmaa_attr_values_t* values,
          int *size
     );

     void drmaa_release_attr_values(
          drmaa_attr_values_t* values
     );

DESCRIPTION
     The drmaa_allocate_job_template() function allocates  a  new
     DRMAA  job  template  into  jt. DRMAA job templates describe
     specifics of jobs that are submitted using  drmaa_run_job(3)
     and drmaa_run_bulk_jobs(3).

  drmaa_delete_job_template()
     The  drmaa_delete_job_template()   function   releases   all
     resources  associated  with  the DRMAA job template jt. Jobs
     that were submitted using the job template are not affected.

  drmaa_set_attribute()
     The drmaa_set_attribute() function stores  the  value  under
     name  for the given DRMAA job template, jt . Only non-vector
     attributes may be passed.

  drmaa_get_attribute()
     The drmaa_get_attribute() function returns into value up  to
     value_len  bytes  from  the string stored for the non-vector
     attribute, name, in the DRMAA job template, jt.

  drmaa_set_vector_attribute()
     The drmaa_set_vector_attribute() function stores the strings
     in value under name in the list of vector attributes for the
     given DRMAA job template, jt . Only vector attributes may be
     passed. The value pointer array must be NULL terminated.

  drmaa_get_vector_attribute()
     The  drmaa_get_vector_attribute()  function   returns   into
     values a DRMAA attribute string vector containing all string
     values stored in the vector attribute, name. The  values  in
     the  DRMAA  values  string  vector  can  be  extracted using
     drmaa_get_next_attr_value(3).  The caller is responsible for
     releasing  the  DRMAA  values  string  vector  returned into
     values using drmaa_release_attr_values(3).

  drmaa_get_next_attr_value()
     Each time drmaa_get_next_attr_value() is called  it  returns
     into value up to value_len bytes of the next entry stored in
     the DRMAA values string vector,  values.   Once  the  values
     list  has  been  exhausted,  DRMAA_ERRNO_NO_MORE_ELEMENTS is
     returned.

  drmaa_get_num_attr_values()
     The drmaa_get_num_attr_values() returns into size the number
     of entries in the DRMAA values string vector.  This function
     is only available in the 1.0 implementation.

  drmaa_release_attr_values()
     The  drmaa_release_attr_values()   function   releases   all
     resources  associated  with  the DRMAA values string vector,
     values.

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_allocate_job_template(),
     drmaa_delete_job_template(),          drmaa_set_attribute(),
     drmaa_get_attribute(),         drmaa_set_vector_attribute(),
     drmaa_get_vector_attribute(),                            and
     drmaa_get_next_attr_value()   return    DRMAA_ERRNO_SUCCESS.
     Other  values indicate an error.  Up to error_diag_len char-
     acters of error related diagnosis information is  then  pro-
     vided in the buffer error_diagnosis.

ERRORS
     The                           drmaa_allocate_job_template(),
     drmaa_delete_job_template(),          drmaa_set_attribute(),
     drmaa_get_attribute(),         drmaa_set_vector_attribute(),
     drmaa_get_vector_attribute(),                            and
     drmaa_get_next_attr_value() functions 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_ACTIVE_SESSION
     Failed because there is no active session.

  DRMAA_ERRNO_NO_MEMORY
     Failed allocating memory.

     The drmaa_set_attribute()  and  drmaa_set_vector_attribute()
     will fail if:

  DRMAA_ERRNO_INVALID_ATTRIBUTE_FORMAT
     The format for the attribute value is invalid.

  DRMAA_ERRNO_INVALID_ATTRIBUTE_VALUE
     The value for the attribute is invalid.

  DRMAA_ERRNO_CONFLICTING_ATTRIBUTE_VALUES
     The value of this attribute is conflicting with a previously
     set attributes.

     The drmaa_get_attribute()  and  drmaa_get_vector_attribute()
     will fail if:


  DRMAA_ERRNO_INVALID_ATTRIBUTE_VALUE
     The specified attribute is not set in  the  DRMAA  job  tem-
     plate.

     The drmaa_get_next_attr_value() will fail if:

  DRMAA_ERRNO_INVALID_ATTRIBUTE_VALUE
     When there are no more entries in the vector.

SEE ALSO
     drmaa_submit(3)and drmaa_attributes(3).










































Man(1) output converted with man2html