NAME

SYNOPSIS

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 -1 value is specified, there is no time-out and the process waits until the job stops. If the 0 value is specified, the process doesn't wait for the job to stop.

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