Data Structures

struct globus_gram_client_job_info_s
Extensible job information structure.

Typedefs

typedef void(* globus_gram_client_callback_func_t) (void *user_callback_arg, char *job_contact, int state, int errorcode)
Signature for GRAM state notification callback functions. typedef struct globus_gram_client_job_info_s globus_gram_client_job_info_t
Extensible job information structure. typedef void(* globus_gram_client_info_callback_func_t) (void *user_callback_arg, const char *job_contact, globus_gram_client_job_info_t *job_info)
Signature for GRAM state notification callback functions with extension support. typedef void(* globus_gram_client_nonblocking_func_t) (void *user_callback_arg, globus_gram_protocol_error_t operation_failure_code, const char *job_contact, globus_gram_protocol_job_state_t job_state, globus_gram_protocol_error_t job_failure_code)
Signature for callbacks signalling completion of non-blocking GRAM requests.

Functions

int globus_gram_client_callback_allow (globus_gram_client_callback_func_t callback_func, void *user_callback_arg, char **callback_contact)
Begin listening for job state change callbacks. int globus_gram_client_info_callback_allow (globus_gram_client_info_callback_func_t callback_func, void *user_callback_arg, char **callback_contact)
Begin listening for job state change callbacks. int globus_gram_client_callback_disallow (char *callback_contact)
Stop listening for job state change callbacks.

typedef void(* globus_gram_client_callback_func_t) (void *user_callback_arg, char *job_contact, int state, int errorcode)

Signature for GRAM state notification callback functions. The globus_gram_client_callback_func_t type describes the function signature for job state callbacks. A pointer to a function of this type is passed to the globus_gram_client_callback_allow() function to create a callback contact. The contact string can be passed to globus_gram_client_job_request() or globus_gram_client_job_callback_register() to let the job management service know to where to send information on GRAM job state changes.

Parameters

typedef void(* globus_gram_client_info_callback_func_t) (void *user_callback_arg, const char *job_contact, globus_gram_client_job_info_t *job_info)

Signature for GRAM state notification callback functions with extension support. The globus_gram_client_info_callback_func_t type describes the function signature for job state callbacks that carry any GRAM protocol extensions beyond the set used in GRAM2. A pointer to a function of this type is passed to the globus_gram_client_info_callback_allow() function to create a callback contact that can handle extensions. The contact string can be passed to globus_gram_client_job_request() or globus_gram_client_job_callback_register() to let the job management service know to where to send information on GRAM job state changes.

Parameters

See also

typedef struct globus_gram_client_job_info_s globus_gram_client_job_info_t

Extensible job information structure. The globus_gram_client_job_info_t data type is used to pass protocol extensions along with the standard job status information included in the GRAM2 protocol. This structure contains the information returned in job state callbacks plus a hash table of extension entries that contain #globus_gram_protocol_extension_t name-value pairs.

typedef void(* globus_gram_client_nonblocking_func_t) (void *user_callback_arg, globus_gram_protocol_error_t operation_failure_code, const char *job_contact, globus_gram_protocol_job_state_t job_state, globus_gram_protocol_error_t job_failure_code)

Signature for callbacks signalling completion of non-blocking GRAM requests. The globus_gram_client_info_callback_func_t type describes the function signature for callbacks which indicate that a GRAM operation has completed. A pointer to a function of this type is passed to the following functions:

• globus_gram_client_register_job_request()
• globus_gram_client_register_job_cancel()
• globus_gram_client_register_job_status()
• globus_gram_client_register_job_refresh_credentials()
• globus_gram_client_register_job_signal()
• globus_gram_client_register_job_callback_registration()
• globus_gram_client_register_job_callback_unregistration()
• globus_gram_client_register_ping()

Parameters

int globus_gram_client_callback_allow (globus_gram_client_callback_func_t callback_func, void * user_callback_arg, char ** callback_contact)

Begin listening for job state change callbacks. The globus_gram_client_callback_allow() function initializes a GRAM protocol service in the current process which will process job state updates from GRAM Job Managers. The URL to contact this service is returned and may be used with the globus_gram_client_job_request() or globus_gram_client_callback_register() family of functions.

Parameters

Returns

Return values

int globus_gram_client_callback_disallow (char * callback_contact)

Stop listening for job state change callbacks. The globus_gram_client_callback_disallow() function stops the GRAM protocol handler associated with a callback contact from receiving further messages. After this function returns, no further callbacks for this contact will be called. Furthermore, the network port associated with the protocol handler will be released.

This function can only be used to disable a callback contact created in the current process.

Parameters

Returns

Return values

int globus_gram_client_info_callback_allow (globus_gram_client_info_callback_func_t callback_func, void * user_callback_arg, char ** callback_contact)

Begin listening for job state change callbacks. The globus_gram_client_info_callback_allow() function initializes a GRAM protocol service in the current process which will process job state updates from GRAM Job Managers. The URL to contact this service is returned and may be used with the globus_gram_client_job_request_with_info() or globus_gram_client_register_job_status_with_info() family of functions.

Parameters

Returns

Return values