1 02/23/84  cancel_cobol_program, ccp
 2 
 3 Syntax:  ccp names {-control_arg}
 4 
 5 
 6 Function: cancels one or more programs in the current COBOL run unit.
 7 
 8 
 9 Arguments:
10 names
11    are reference names of COBOL programs active in the current run
12    unit.
13 
14 
15 Control arguments:
16 -retain_data, -retd
17    leaves the data segment associated with the program intact for
18    debugging purposes (see "Notes").
19 
20 
21 Notes: The results of this command and the execution of the CANCEL
22 statement from within a COBOL program are similar.  The only
23 difference is that if a name argument is not actually a component of
24 the current run unit, an error message is issued and no action is
25 taken; for the CANCEL statement no warning is given in such a case.
26 
27 To preserve program data for debugging purposes, -retain_data should
28 be used.  The data associated with the canceled program is in its last
29 used state; it is not restored to its initial state until the next
30 time the program is invoked in the run unit.
31 
32 
33 Canceling ensures that the next time the program is invoked within the
34 run unit its data is in its initial state.  Any files that have been
35 opened by the program and are still open are closed, and the COBOL data
36 segment is truncated.
37 
38 Refer to display_cobol_run_unit (dcr), stop_cobol_run (scr), and
39 run_cobol for more information.