pfm_$reset_cleanup Library Routine

Purpose

Resets a cleanup handler.

Syntax

#include <idl/c/base.h>
#include <idl/c/pfm.h>

void
pfm_$reset_cleanup ( cleanup_record status)
pfm_$cleanup_rec *cleanup_record;
status_$t *status;

Description

The pfm_$reset_cleanup routine re-establishes the cleanup handler last entered so that any subsequent errors enter it first. This procedure should only be used within cleanup handler code.

Parameters

Input

Item Description
cleanup_ record Indicates a record of the context at the cleanup handler entry point. It is supplied by the pfm_$cleanup routine when the cleanup handler is first established.

Output

Item Description
status Points to the completion status.

Examples

To re-establish a cleanup handler, enter:

pfm_$reset_cleanup(crec, st);

where the crec cleanup record is a valid cleanup handler.