1 02/08/84  run_
 2 
 3 The run_ subroutine manages the environment for a run unit and invokes
 4 the main program of a run unit.  See the run command for an
 5 explanation of run units.
 6 
 7 
 8 Entry points in run_:
 9    (List is generated by the help command)
10 
11 
12 :Entry: run_: 02/08/84  run_
13 
14 Function: This entry sets up the run unit environment, invokes the
15 main program, and restores the environment when the run ends.
16 
17 
18 Syntax:
19 declare run_ entry (entry, ptr, ptr, fixed bin(35));
20 call run_ (main_entry, arglist_ptr, run_cs_ptr, code);
21 
22 
23 Arguments:
24 main_entry
25    is the entry point to be called as the main program of the run unit.
26    (Input)
27 arglist_ptr
28    is a pointer to the argument list for the main program.  (Input)
29 run_cs_ptr
30    is a pointer to the structure which is declared in
31    run_control_structure.incl.pl1.  (Input)
32 code
33    is a standard status code.  (Output)
34 
35 
36 :Entry:  environment_info:  02/08/84 run_$environment_info
37 
38 
39 Function:  This entry enables the symbolic debugging tools to obtain
40 the saved stack header information used by a given stack frame.
41 
42 
43 Syntax:
44 declare run_$environment_info entry (ptr, ptr, fixed bin(35));
45 call run_$environment_info (stack_frame_ptr, info_ptr, code);
46 
47 
48 Arguments:
49 stack_frame_ptr
50    is a pointer to an active stack frame on the current stack.  (Input)
51 info_ptr
52    is a pointer to the env_ptrs structure declared in
53    env_ptrs.incl.pl1.  (Input)
54 code
55    is a standard system status code.  (Output)