Set Error Handling

Set the error handling method in case error is encountered in C. More...

Functions
int	PIOc_Set_File_Error_Handling (int ncid, int method)
	Set the error handling method to be used for subsequent pio library calls, returns the previous method setting. More...
int	PIOc_Set_IOSystem_Error_Handling (int iosysid, int method)
	Set the error handling method used for subsequent calls. More...
int	PIOc_set_iosystem_error_handling (int iosysid, int method, int *old_method)
	Set the error handling method used for subsequent calls for this IO system. More...

Detailed Description

Set the error handling method in case error is encountered in C.

Function Documentation

PIOc_Set_File_Error_Handling()

int PIOc_Set_File_Error_Handling	(	int	ncid,
		int	method
	)

Set the error handling method to be used for subsequent pio library calls, returns the previous method setting.

Note that this changes error handling for the IO system that was used when this file was opened. Other files opened with the same IO system will also he affected by this call. This function is supported but deprecated. New code should use PIOc_set_iosystem_error_handling(). This method has no way to return an error, so any failure will result in MPI_Abort.

Parameters

ncid	the ncid of an open file
method	the error handling method

Returns

old error handler

Author

Jim Edwards

PIOc_Set_IOSystem_Error_Handling()

int PIOc_Set_IOSystem_Error_Handling	(	int	iosysid,
		int	method
	)

Set the error handling method used for subsequent calls.

This function is deprecated. New code should use PIOc_set_iosystem_error_handling(). This method has no way to return an error, so any failure will result in MPI_Abort.

Parameters

iosysid	the IO system ID
method	the error handling method

Returns

old error handler

Author

Jim Edwards

PIOc_set_iosystem_error_handling()

int PIOc_set_iosystem_error_handling	(	int	iosysid,
		int	method,
		int *	old_method
	)

Set the error handling method used for subsequent calls for this IO system.

Parameters

iosysid	the IO system ID. Passing PIO_DEFAULT instead changes the default error handling for the library.
method	the error handling method
old_method	pointer to int that will get old method. Ignored if NULL.

Returns

0 for success, error code otherwise.

Author

Jim Edwards, Ed Hartnett