Introduction to CEA TSO/E address space services

The z/OS® CEA TSO/E address space manager provides services to programmatically start and manage TSO/E address spaces and provides a communications mechanism for use between the caller and the programs running in these managed address spaces.

CEA TSO/E address space services allow callers to:

Start a new TSO/E address space.
End a TSO/E address space started by CEA.
Send an attention interrupt to a TSO/E address space started by CEA.
Obtain information about a TSO/E address space started by CEA.
Obtain information about all the TSO/E address spaces that CEA started for an application.
Ping a TSO/E address space that was started by CEA to prevent the address space from ending because it has been idle too long.

Two versions of TSO/E Address Space Services are available: Version 1 and Version 2.

Version 1 TSOASMGR services: Version 1 TSOASMGR services allow a calling application to create sessions on only the system on which the function was invoked (the local system). Version 1 exploiters of TSO/E Address Space Services use msgsnd() and msgrcv() functions to directly receive data to and from the z/OS UNIX queue.
Version 2 TSOASMGR services: Version 2 TSOASMGR services allow a calling application to create and log in to a TSO/E address space on a different system in the sysplex (a remote system). With the Version 2 request structures, two new CEA provided APIs, CEAmsgsnd and CEAmsgrcv, are used to perform message send and message receive. Callers using the new APIs use the CEA connection handle.