grpc_handle_attr_set

NAME

grpc_handle_attr_set_np - Sets handle attributes.

SYNOPSIS


  grpc_error_t grpc_handle_attr_set_np(grpc_handle_attr_t_np *attr,
                              grpc_handle_attr_name_t_np name,
                              void *value)

ARGUMENTS

grpc_handle_attr_t_np *attr: The handle attributes
grpc_handle_attr_name_t_np name: The names of the attributes to be set
void *value: The values to be set

typedef enum {                           /* Format for passing to value */
    GRPC_HANDLE_ATTR_HOSTNAME,          /* char */
    GRPC_HANDLE_ATTR_PORT,              /* int */
    GRPC_HANDLE_ATTR_JOBMANAGER,        /* char */
    GRPC_HANDLE_ATTR_SUBJECT,           /* char */
    GRPC_HANDLE_ATTR_FUNCNAME,          /* char */
    GRPC_HANDLE_ATTR_JOBSTARTTIMEOUT,   /* int */
    GRPC_HANDLE_ATTR_JOBSTOPTIMEOUT,    /* int */
    GRPC_HANDLE_ATTR_WAIT_ARG_TRANSFER, /* grpc_argument_transfer_t_np */
    GRPC_HANDLE_ATTR_QUEUENAME,         /* char */
    GRPC_HANDLE_ATTR_MPI_NCPUS,         /* int */
} grpc_handle_attr_name_t_np;

GRPC_HANDLE_ATTR_HOSTNAME
GRPC_HANDLE_ATTR_PORT
GRPC_HANDLE_ATTR_JOBMANAGER
GRPC_HANDLE_ATTR_SUBJECT
GRPC_HANDLE_ATTR_FUNCNAME
Those are the same as the arguments of the existing grpc_function_handle_init() function.
GRPC_HANDLE_ATTR_JOBSTARTTIMEOUT
This specifies the time-out value in seconds for when a job is started.

When the grpc_call() function *1 is called and the job has not started, if the time specified by job_timeout elapses after the job start-up request was issued, then grpc_call() ends with a time-out error.

If the value 0 is specified, the process continues to wait for the job to start without timing out.
GRPC_HANDLE_ATTR_JOBSTOPTIMEOUT
The time out time for job completion is specified in seconds.

If the value 0 is specified, the process continues to wait for the job to end without timing out.
GRPC_HANDLE_ATTR_WAIT_ARG_TRANSFER
This flag specifies whether or not to wait for the transfer of arguments in an asynchronous RPC.

The default is to wait for the transfer.

The value set up with this attribute is shown below.
- GRPC_ARGUMENT_TRANSFER_WAIT
  It waits for the end of transfer argument.
- GRPC_ARGUMENT_TRANSFER_NOWAIT
  It does not wait for the end of transfer argument.
- GRPC_ARGUMENT_TRANSFER_COPY
  The copy of an argument is made.
GRPC_HANDLE_ATTR_QUEUENAME
Target the GRAM job to a queue (class) name as defined by the scheduler at the defined (remote) resource.
GRPC_HANDLE_ATTR_MPI_NCPUS
This specifies the number of CPUs for MPI function.

DESCRIPTION

The grpc_handle_attr_set_np() function sets the values of handle attributes.

This function is MT-safe.

RETURN VALUE

If successful, GRPC_NO_ERROR is returned. In the case of an error, Error code is returned.

ERRORS

GRPC_NOT_INITIALIZED: GRPC client is not initialized yet.
GRPC_OTHER_ERROR_CODE: Internal error detected.

last update : $Date: 2005/08/04 03:26:22 $