IBM SC34-6814-04 User Manual
RESPONSE
REASON
NO_TRANSACTION_ENVIRONMENT
NO_TRANSACTION_ENVIRONMENT
DISASTER
None
INVALID
None
KERNERROR
None
PURGED
None
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.
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.
subspace and for some reason need to switch into basespace.
SWITCH_SUBSPACE
DFHSMSRX
[CALL,]
[CLEAR,]
[IN,
FUNCTION(SWITCH_SUBSPACE),
SPACE(BASESPACE),]
[OUT,
RESPONSE (name1 | *),
REASON (name1 | *)]
[IN,
FUNCTION(SWITCH_SUBSPACE),
SPACE(BASESPACE),]
[OUT,
RESPONSE (name1 | *),
REASON (name1 | *)]
This command is threadsafe.
SPACE(BASESPACE)
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.
currently executing within a subspace. This enables the task to read and write
to another task’s user-key task-lifetime storage.
RESPONSE and REASON values for SWITCH_SUBSPACE:
RESPONSE
REASON
OK
None
DISASTER
None
KERNERROR
None
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:
user exit point in the:
v
Dispatcher domain
v
Dump domain
v
Monitor domain
v
Statistics domain
v
Transient data program.
Chapter 3. The user exit programming interface (XPI)
399