1 02/13/84  add_epilogue_handler_
 2 
 3 
 4 Entry points in add_epilogue_handler_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: add_epilogue_handler_: 02/13/84  add_epilogue_handler_
 9 
10 Function: adds an entry to the list of those handlers called when a
11 process or run unit is terminated.  A program established as an
12 epilogue handler during a run unit is called when the run unit is
13 terminated.  If the process continues after the run unit is
14 terminated, the handler is discarded from the list of those called
15 when the process is terminated.  Hence, epilogue handlers established
16 during a run unit are not retained beyond the life of the run unit.
17 
18 
19 Syntax:
20 declare add_epilogue_handler_ entry (entry, fixed bin (35));
21 call add_epilogue_handler_ (ev, code);
22 
23 
24 Arguments:
25 ev
26    is an entry value to be placed on the list of such values to be
27    called when the run unit or process is cleaned up.  (Input)
28 code
29    is a standard status code.  (Output)
30 
31 
32 Notes: This subroutine effectively manages two lists of epilogue
33 handlers: those for the run unit, if a run unit is active, and those
34 for the process.  While a run unit is active, it is not possible to
35 add entries to the list for the process.  There is no way to establish
36 a process epilogue handler while a run unit is active.  The caller of
37 execute_epilogue_ (logout, new_proc, etc.) must indicate whether all
38 or just the run unit handlers are to be invoked.