pfm_reset_cleanup(3ncs)
Name
pfm_reset_cleanup − reset a clean-up 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;
Arguments
cleanup_record A record of the context at the clean-up handler entry point. It is supplied by pfm_$cleanup, when the clean-up handler if first established.
status The completion status. If the completion status returned in status.all is equal to status_$ok, then the routine that supplied it was successful.
Description
The pfm_$reset_cleanup routine reestablishes the clean-up handler last entered so that any subsequent errors enter it first. This procedure should only be used within clean-up handler code.
Diagnostics
This section lists status codes for errors returned by this pfm_$ routine in status.all.
pfm_$bad_rls_order
Attempted to release a clean-up handler out of order.
pfm_$cleanup_not_found
There is no pending clean-up handler.
pfm_$cleanup_set A clean-up handler was established successfully.
pfm_$invalid_cleanup_rec
Passed an invalid clean-up record to a routine.
pfm_$no_space Cannot allocate storage for a clean-up handler.
Files
/usr/include/idl/c/base.h
/usr/include/idl/base.idl
/usr/include/c/pfm.h