COBOL Manual for TNS and TNS/R Programs

Program Compilation
HP COBOL Manual for TNS and TNS/R Programs—522555-006
11-110
SAVE
count
is an unsigned integer in the range 1 through 100, an estimate of the
number of messages to be saved. The default is 19.
The compiler uses count to estimate process data-space requirements
for the saved ASSIGN messages. In the non-CRE environment, the saved
ASSIGN messages are in the data block #HIGHBUF. (See Code and Data
Blocks). In the CRE, the saved ASSIGN messages are in the data block
#CRE_HEAP. If there is not enough space for all the ASSIGN messages
held by the command interpreter, the program terminates with a run-time
error message.
ALL
specifies that all messages are to be saved.
Whenever an HP COBOL program begins execution, its creator sends it a series of
initialization messages:
•
A startup message (always)
•
One PARAM message (if any parameters are active)
•
An ASSIGN message for each assignment active
In the non-CRE environment, space is reserved for 19 ASSIGN messages. If your
program will have more than 19 assignments active at one time, include a MEM option
in the RUN or RUND Command. Allow approximately one page of memory for every
19 ASSIGN messages.
You cannot directly manipulate saved messages as COBOL data items, but you can
use utility routines to retrieve and modify their contents (see Saved Message Utility
(SMU) Overview).
All combinations of SAVE options are legal, as are multiple SAVE directives.
Redundant options are ignored, except that the last-seen count overrides any previous
ones. The directive
SAVE ALL 17, ASSIGNS 10
is equivalent to
SAVE ALL, ASSIGNS 10
Default: The compiler does not save initialization messages.
Placement: Anywhere
Scope: Applies to the compilation unit
Dependencies: None