COBOL Manual for TNS/E Programs (H06.03+)

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-24
COBOL_COMPLETION_
termination-info
is a numeric operand, the evaluation of which includes truncation as necessary to
an integer result with a value in the range of -32,768 through 32,767. If this
parameter is present, the value is passed to STOP or ABEND as the
termination-info parameter for that routine.
subsys-id
is a data item occupying at least twelve character positions. If this parameter is
present, a reference to the data item is passed to STOP or ABEND as the
subsys-id parameter for that routine.
text
is an alphanumeric data item containing at least as many characters as specified
by the value of text-length (alphabetic and alphanumeric-edited data items are
also permissible). If this parameter is present, a reference to the data item is
passed to STOP or ABEND as the text parameter for that routine.
Usage Considerations:
•
Parameters Are Not Validated
When the run unit calls COBOL_COMPLETION_, the HP COBOL run-time
routines terminate execution of the run unit in an orderly fashion. The final step in
the termination logic is to call either the STOP or the ABEND routine of the
operating environment (as specified by the implicit or explicit abend-or-stop
parameter value). All other parameters are made available to the STOP or ABEND
routine as described previously. It is the application’s responsibility to verify that the
combination of supplied parameters and their values meet the expectations of the
STOP or ABEND routine. The COBOL_COMPLETION_ routine does not validate
the parameters.
.