CeaTsoQueryApp - Querying TSO/E sessions by application

Use the CeaTsoQueryApp request type to obtain information from the CEA TSO/E address space manager about all the TSO/E address spaces that CEA started that are associated with a specific application identifier.

To perform this request, the CEA TSO/E address space manager extracts the caller’s security UTOKEN from the caller’s environment and uses it when needed.

Table 1 lists the input callers must provide for each structure used for this request type and the output that will be provided. No other fields in the structures are used. The value for the unused fields is indeterminate. For more details about the fields listed for each structure, see Parameters.

Attention: It is the caller’s responsibility to free the storage associated with the query structures that are returned.

Table 1. Input and output for each structure used for the CeaTsoQueryApp request type
Structure	Required Input	Output
CeaTsoRequestStruct	eyecatcher ceatso_version ceatso_requesttype ceatso_asid ceatso_numqueryreq ceatso_apptag ceatso_stoken ceatso_index	If the return code is CEASUCCESS, the following field is returned: ceatso_numqueryrslt
CeaTsoQueryStruct	None	If the return code is CEASUCCESS, an array of query structures are allocated and the following fields are returned for each: eyecatcher ceatso_version ceatso_userid ceatso_asid ceatso_logonproc ceatso_msgqueueid ceatso_charset ceatso_codepage ceatso_screenrows ceatso_screencols ceatso_account ceatso_group ceatso_region ceatso_apptag ceatso_stoken ceatso_index
CeaTsoErrorStruct	eyeCatcher version	returnCode reasonCode diag