The Switch_Subspace Call; Trace Control Xpi Function - IBM SC34-6814-04 Customization Manual

RESPONSE
DISASTER
INVALID
KERNERROR
PURGED

The SWITCH_SUBSPACE call

SWITCH_SUBSPACE causes CICS to switch from a subspace to base space, if the
task is not already executing in the base space. If the task is already in the base
space, storage manager ignores the call.
This function can be used by global user exit programs that receive control in
subspace and for some reason need to switch into basespace.
SWITCH_SUBSPACE
DFHSMSRX [CALL,]
This command is threadsafe.
SPACE(BASESPACE)
RESPONSE and REASON values for SWITCH_SUBSPACE:
RESPONSE
OK
DISASTER
KERNERROR

Trace control XPI function

There is one XPI trace control function. This is the DFHTRPTX call TRACE_PUT.
DFHTRPTX calls cannot be used in any exit program invoked from any global
user exit point in the:
v Dispatcher domain
v Dump domain
v Monitor domain
v Statistics domain
v Transient data program.
[CLEAR,]
[IN,
FUNCTION(SWITCH_SUBSPACE),
SPACE(BASESPACE),]
[OUT,
RESPONSE (name1 | *),
REASON (name1 | *)]
specifies that CICS is to switch the task issuing the call to the basespace, if it is
currently executing within a subspace. This enables the task to read and write
to another task's user-key task-lifetime storage.
REASON
NO_TRANSACTION_ENVIRONMENT
None
None
None
None
REASON
None
None
None
Chapter 3. The user exit programming interface (XPI)
399