NAME

pfm_$reset_cleanup − reset a cleanup handler

SYNOPSIS

C Syntax

#include <idl/c/base.h>
#include <ppfm.h>
 
void pfm_$reset_cleanup(
pfm_$cleanup_rec *cleanup_record,
status_$t *status)

Pascal Syntax

%include ’/sys/ins/base.ins.pas’;
%include ’/sys/ins/pfm.ins.pas’;
 
procedure pfm_$reset_cleanup(
in cleanup_record: pfm_$cleanup_rec;
out status: status_$t);

Remarks

To view this manual entry via the man(1) command, use the function name shown above without the “$” character. 

DESCRIPTION

pfm_$reset_cleanup 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. 

A pfm_$reset_cleanup implicitly performs a pfm_$enable, thereby undoing the implicit pfm_$inhibit that pfm_$cleanup performs. 

cleanup_record
A record of the context at the cleanup handler entry point. It is supplied by pfm_$cleanup when the cleanup handler is first established. 

status The completion status. 

NOTE

This note concerns use of pfm_$reset_cleanup on Apollo systems. 

In the SR10.0 and SR10.1 versions of <apollo/pfm.h>, the first argument of pfm_$reset_cleanup is incorrectly preceded by an ampersand (&).  In the SR10.2 version, the first argument is correctly preceded by an asterisk (∗). 

Programs compiled under SR10.0 or SR10.1 will continue to run correctly, since the implementation of pfm_$reset_cleanup has not changed, but you may need to modify these programs in order to compile them under SR10.2.  Invocations of pfm_$reset_cleanup that looked like

pfm_$reset_cleanup(crec, &st)

when compiled under SR10.0 and SR10.1 must be modified to

pfm_$reset_cleanup(&crec, &st)

when compiled under SR10.2. 

Hewlett-Packard Company  —  HP-UX Release 8.05: June 1991