Error Handling for Fortran

Set the behavior if an error is encountered in Fortran. More...

Functions/Subroutines
subroutine	piolib_mod::seterrorhandlingfile (file, method, oldmethod)
	File descriptor structure. More...
subroutine	piolib_mod::seterrorhandlingiosystem (iosystem, method, oldmethod)
	The error handling setting controls what happens if errors are encountered by PIO. The three types of error handling methods are: More...
subroutine	piolib_mod::seterrorhandlingiosysid (iosysid, method, oldmethod)
	The error handling setting controls what happens if errors are encountered by PIO. The three types of error handling methods are: More...

Detailed Description

Set the behavior if an error is encountered in Fortran.

Use the generic functions to call the underlying Fortran functions.

Generic Function	Function(s)
PIO_seterrorhandling()	seterrorhandlingfile(), seterrorhandlingiosystem(), seterrorhandlingiosysid()

Function/Subroutine Documentation

seterrorhandlingfile()

subroutine piolib_mod::seterrorhandlingfile	(	type(file_desc_t), intent(inout)	file,
		integer, intent(in)	method,
		integer, intent(out), optional	oldmethod
	)

File descriptor structure.

Set the pio error handling method for a file.

Parameters

file	This structure holds information associated with each open file
method	error handling method
oldmethod	old error handling method

Author

Jim Edwards

seterrorhandlingiosysid()

subroutine piolib_mod::seterrorhandlingiosysid	(	integer, intent(in)	iosysid,
		integer, intent(in)	method,
		integer, intent(out), optional	oldmethod
	)

The error handling setting controls what happens if errors are encountered by PIO. The three types of error handling methods are:

Set the pio error handling method for a pio system or globally.

Parameters

iosysid	a pio system ID (pass PIO_DEFAULT to change the global default error handling)
method	PIO_INTERNAL_ERROR : abort on error from any task

• PIO_BCAST_ERROR : broadcast an error from io_rank 0 to all tasks in comm
• PIO_RETURN_ERROR : do nothing - allow the user to handle it

  Parameters

  oldmethod

  old error handling method

  Author

  Jim Edwards

seterrorhandlingiosystem()

subroutine piolib_mod::seterrorhandlingiosystem	(	type(iosystem_desc_t), intent(inout)	iosystem,
		integer, intent(in)	method,
		integer, intent(out), optional	oldmethod
	)

The error handling setting controls what happens if errors are encountered by PIO. The three types of error handling methods are:

Set the pio error handling method for a pio system.

Parameters

iosystem	a defined pio system descriptor, see PIO_types
method	PIO_INTERNAL_ERROR : abort on error from any task

• PIO_BCAST_ERROR : broadcast an error from io_rank 0 to all tasks in comm
• PIO_RETURN_ERROR : do nothing - allow the user to handle it

  Parameters

  oldmethod

  old error handling method

  Author

  Jim Edwards