NAME

SYNOPSIS

ARGUMENTS

INTEGER(KIND=8) ATTR

The function handle attributes to be initialized

DESCRIPTION

The GRPC_HANDLE_ATTR_INITIALIZE_NP() function initializes function handle attributes.

This function is MT-safe.

ATTRIBUTES

The function handle attributes has the following members.

• Hostname

  This is the same as "SERV_NAME" argument of the existing GRPC_FUNCTION_HANDLE_INIT() function.

  GRPC_HANDLE_ATTR_SET_HOSTNAME_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_HOSTNAME_NP() can be used for getting this form the handle attributes.

• Port number

  This is a port number on which the server is listening. The value 0 indicates that the default port number of each Invoke Server is used.

  GRPC_HANDLE_ATTR_SET_PORT_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_PORT_NP() can be used for getting this form the handle attributes.

• Job manager

  This is job manager to be used on the server machine. Available values depend on the Invoke Server and the configuration of the server.

  GRPC_HANDLE_ATTR_SET_JOBMANAGER_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_JOBMANAGER_NP() can be used for getting this form the handle attributes.

• Subject

  This is Globus certificate subject.

  GRPC_HANDLE_ATTR_SET_SUBJECT_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_SUBJECT_NP() can be used for getting this form the handle attributes.

• Function name

  This is the same as "FUNC_NAME" argument of the existing GRPC_FUNCTION_HANDLE_INIT() function.

  GRPC_HANDLE_ATTR_SET_FUNCNAME_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_FUNCNAME_NP() can be used for getting this form the handle attributes.

• Job start timeout

  This is the time-out value for invoking a job. The value is in seconds.

  If the specified time passes since a job start-up request, An RPC-executing API(e.g. 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 time out.

  GRPC_HANDLE_ATTR_SET_JOB_START_TIMEOUT_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_JOB_START_TIMEOUT_NP() can be used for getting this form the handle attributes.

• Job stop timeout

  This is the time-out value for job completion. The value is 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_SET_JOB_STOP_TIMEOUT_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_JOB_STOP_TIMEOUT_NP() can be used for getting this form the handle attributes.

• Argument transfer

  This is a flag indicating whether or not to wait for the transfer of arguments in an asynchronous RPC. The value can be one of the followings.

  • 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 and it waits for the completion of the copy.

  GRPC_HANDLE_ATTR_SET_WAIT_ARG_TRANSFER_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_WAIT_ARG_TRANSFER_NP() can be used for getting this form the handle attributes.

• Queue name

  This is the name of the queue of the remote job scheduler.

  GRPC_HANDLE_ATTR_SET_QUEUE_NAME_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_QUEUE_NAME_NP() can be used for getting this form the handle attributes.

• Number of MPI CPUs

  This is the number of CPUs for MPI function.

  GRPC_HANDLE_ATTR_SET_MPI_NCPUS_NP() can be used for setting this to the handle attributes. GRPC_HANDLE_ATTR_GET_MPI_NCPUS_NP() can be used for getting this form the handle attributes.

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.