mpiControlRecorderCancel

Declaration

long  mpiControlRecorderCancel(MPIControl   control,
                               long         recorderNumber);
Required Header: stdmpi.h
Change History: Added in the 03.03.00

Description

mpiControlRecorderCancel provides a way to cancel the reservation for an abandoned recorder.

It is possible for a fatal error to occur in your application where mpiRecorderDelete(...) is not called, which will leave your recorders abandoned.

An abandoned recorder number cannot be reused until the recorder's reservation is canceled or the reservation is explicitly overwritten by specifying the recorder number (i.e. a number other than -1) when calling mpiRecorderCreate(...).

Use mpiControlRecorderStatus(...) to make sure you have no reason to believe a recorder is being used before canceling the recorders reservation.

control a handle to the Control object.
recorderNumber the index of the abandoned recorder object.
Return Values
MPIMessageOK
MPIMessageARG_INVALID If recorderNumber is less than 0 or greater than MPIRecorderRECORDERS_MAX

See Also

mpiRecorderStatus | mpiRecorderCreate | mpiRecorderDelete | mpiControlRecorderStatus

recorderinuse.c