MPI Programming Guide

MP_UNSET_CKPT_CALLBACKS, mpc_unset_ckpt_callbacks

Purpose

Unregisters checkpoint, resume, and restart application callbacks.

Library

libmpi_r.a

C synopsis

#include <pm_ckpt.h>
int mpc_unset_ckpt_callbacks(int handle);

FORTRAN synopsis

MP_UNSET_CKPT_CALLBACKS(INTEGER HANDLE, INTEGER RC)

Parameters

handle is an integer indicating the set of callback subroutines to be unregistered. This integer is the value returned by the subroutine used to register the callback subroutine.

In FORTRAN, RC contains one of the values listed under Return Values.

Description

The MP_UNSET_CKPT_CALLBACKS subroutine is called to unregister checkpoint, resume, and restart application callbacks that were registered with the MP_SET_CKPT_CALLBACKS subroutine.

Notes

If a call to MP_UNSET_CKPT_CALLBACKS is issued while a checkpoint is in progress, it is possible that the previously-registered callback will still be run during this checkpoint.

There are certain limitations associated with checkpointing an application. See Checkpoint/restart limitations for more information.

For general information on checkpointing and restarting programs, see IBM Parallel Environment for AIX: Operation and Use, Volume 1.

For more information on the use of LoadLeveler and checkpointing, see IBM LoadLeveler for AIX 5L: Using and Administering.

Return values

0

indicates that MP_UNSET_CKPT_CALLBACKS successfully removed the callback subroutines from the list of registered callback subroutines

-1

indicates that an error occurred. A message describing the error will be issued.

Examples

C Example

#include <pm_ckpt.h>
int ihndl;
callbacks_t cbs;
void foo(void); 
void bar(void); 
cbs.checkpoint_callback=foo;
cbs.resume_callback=bar;
cbs.restart_callback=bar;
ihndl = mpc_set_ckpt_callbacks(callbacks_t *cbs);

·
·
·

mpc_unset_ckpt_callbacks(ihndl);

·
·
·

FORTRAN Example

SUBROUTINE FOO

·
·
·

RETURN
END
SUBROUTINE BAR

·
·
·

RETURN 
END
PROGRAM MAIN
EXTERNAL FOO, BAR
INTEGER HANDLE, RC

·
·
·

CALL MP_SET_CKPT_CALLBACKS(FOO,BAR,BAR,HANDLE)
IF (HANDLE .NE. 0) STOP 666

·
·
·

CALL MP_UNSET_CKPT_CALLBACKS(HANDLE,RC)

·
·
·

END

Related information

Commands:

• poeckpt
• poerestart

Subroutines:

• MP_INIT_CKPT, mpc_init_ckpt
• MP_SET_CKPT_CALLBACKS, mpc_set_ckpt_callbacks