Main_dp environments can be initialized by calling CEEPIPI(init_main_dp)
from an active main_dp environment. From an active main_dp environment,
nested calls to CEEPIPI can be made with a token returned from (init_main_dp)
to perform certain other functions:
(call_main)
(add_entry)
(delete_entry)
(term)
(set_user_word)
(get_user_word)
(identify_entry)
(identify_environment)
(identify_attributes)
Restrictions for nested main_dp environments:
When the calling environment has a user-provided @EXCEPRTN, the
nested main_dp environment must also have a user-provided @EXCEPRTN.
If the user-written preinitialization driver program has established
a SPIE or ESPIE routine, the nested main_dp environment must have
a user-provided @EXCEPRTN.
All CEEPIPI calls that use a token must be made from the same
TCB.
The INTERRUPT(ON) runtime option is not supported when using nested
main_dp environments under TSO/E.
When the TRAP runtime option is used with nested main_dp environments,
use of the TSO/E attention key is not supported.
If an ABEND (40XX, for example) causes the immediate ending of
a nested main_dp environment without orderly Language Environment® termination,
the user-provided preinitialization driver program cannot be returned
to. The calling main_dp environment will also end without orderly Language Environment termination
If the ABTERMENC(ABEND) runtime option is in effect and an unhandled
condition causes a nested main_dp environment to ABEND, Language Environment will not
return to the preinitialization assembler driver program. The calling
main_dp environment will also ABEND without orderly Language Environment termination.
Consider using ABTERMENC(RETCODE) in nested main_dp environments
If a main_dp environment which uses the TRAP(ON,SPIE) runtime
option does (call_main) to a nested main_dp environment which uses
TRAP(ON,NOSPIE), language environment issues an ESPIE macro to prevent
program checks from being passed to any existing ESPIE routine.
If this ESPIE call must be avoided, do not call a nested main_dp environment
with TRAP(ON,NOSPIE) from a main_dp environment that uses TRAP(ON,SPIE).