(term) — terminate environment

This invocation of CEEPIPI terminates the environment identified by the value given in token. This service is used for terminating environments created for subroutines or main routines.

Syntax

>>-CALL--CEEPIPI--(--term--,--token--,--env_return_code--)-----><

term (input)

A fullword function code (integer value = 5) containing the termination request.

token (input)

A fullword with the value of the token of the environment to be terminated. This token is returned by a (init_main), (init_main_dp), (init_sub), or (init_sub_dp) request during the initialization call.

The token must identify a previously preinitialized environment that is dormant at the time of the call.

env_return_code (output)

A fullword integer which is set to the return code from the environment termination.

If the environment was initialized for a main routine or a subroutine, and the last (call_sub) or (call_sub_addr) issued stop semantics, the value of env_return_code is zero.

If the environment was initialized for a subroutine and the last (call_sub) or (call_sub_addr) did not terminate with stop semantics, env_return_code contains the same value as that in sub_ret_code from the last (call_sub) or (call_sub_addr).