clean

pfm_rls_cleanup(3ncs)													     pfm_rls_cleanup(3ncs)

Name
       pfm_rls_cleanup - release clean-up handlers

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

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

Arguments
       cleanup_record	   The clean-up record for the first clean-up handler to release.

       status		   The	completion status.  If status is pfm_$bad_rls_order, it means that the caller attempted to release a clean-up han-
			   dler before releasing all handlers established after it.  This status is only a warning; the intended clean-up  handler
			   is  released,  along with all clean-up handlers established after it.  If the completion status returned in is equal to
			   status_$ok, then the routine that supplied it was successful.

Description
       The routine releases the clean-up handler associated with cleanup_record and all clean-up handlers established after it.

Diagnostics
       This section lists the status codes for errors returned by this routine in

       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_$cleanup_set_signalled
			   Attempted to use pfm_$cleanup_set as a signal.

       pfm_$invalid_cleanup_rec
			   Passed an invalid clean-up record to a routine.

Files
See Also
       intro(3ncs)

															     pfm_rls_cleanup(3ncs)