NAME

grpc_function_handle_init - Initializes a function handle.

SYNOPSIS

INTEGER FUNCTION GRPC_FUNCTION_HANDLE_INIT(HANDLE, SERV_NAME, FUNC_NAME)

ARGUMENTS

INTEGER(KIND=8) HANDLE
The function handle to be initialized
CHARACTER(*) SERV_NAME
The host name of the remote machine.
CHARACTER(*) FUNC_NAME
The function to be executed on the remote machine

DESCRIPTION

The GRPC_FUNCTION_HANDLE_INIT() function initializes a function handle.

If a user defines tag name in <SERVER> section, tag name can be specified in the SERV_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$