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,]
       [CLEAR,]
       [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.

RESPONSE and REASON values for SWITCH_SUBSPACE

RESPONSE	REASON
OK	None
DISASTER	None
KERNERROR	None