grpc_function_handle

NAME

grpc_function_handle_init - Initializes a function handle.

SYNOPSIS


  grpc_error_t grpc_function_handle_init(
                   grpc_function_handle_t *handle,
                   char *server_name,
                   char *func_name)

ARGUMENTS

grpc_function_handle_t *handle: The function handle to be initialized
char *server_name: The host name (resource manager contact) of the remote machine.
char *func_name: The function to be executed on the remote machine

DESCRIPTION

The grpc_function_handle_init() function initializes a function handle.

Every Globus Toolkit GRAM resource manager contact can be specified as a server_name argument. Resource manager contact can be one of the followings:

host name

host name:port number

host name:port number/jobmanager

host name/jobmanager

host name:/jobmanager

host name::subject

host name:port number:subject

host name/jobmanager:subject

host name:/jobmanager:subject

host name:port number/jobmanager:subject

If a user defines tag name in <SERVER> section, tag name can be specified in the host name of the Resource Manager Contact in server_name argument.

The API searches corresponding tag name in a client configuration file. If the tag name is not found, the API searches corresponding server name. The first match will be selected if multiple sections have the same host name.

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_SERVER_NOT_FOUND: GRPC client cannot find any server.
GRPC_FUNCTION_NOT_FOUND: GRPC client cannot find the function on the default server.
GRPC_RPC_REFUSED: GRPC server refused the initialization.
GRPC_OTHER_ERROR_CODE: Internal error detected.

last update : $Date: 2006/01/16 09:39:26 $