Return codes

Table 1 lists and describes the return codes that are typically returned after the CEATsoRequest API processes a request.

Table 1. Return codes
Hexadecimal Return Code	Equate Symbol, Meaning, and Action
FFFFFFFF	Equate symbol: CEAFAILURE Meaning: One or more errors occurred during CEATSOREQUEST processing. Action: Check the reason and diagnostic codes to obtain additional information, and correct any errors.
00000000	Equate symbol: CEASUCCESS Meaning: No errors occurred during CEATSOREQUEST processing. The meaning of a CEASUCCESS return code for each request type follows: CeaTsoStart. A new TSO/E address space was started, or the user was connected to a dormant TSO/E session. The caller can now read from and write to the z/OS® UNIX message queue. CeaTsoAttn. The attention interrupt request was sent to the specified TSO/E address space. CeaTsoEnd. The specified TSO/E address space was ended or placed into a dormant state. If the session was ended, all associated resources were returned to the system. Otherwise, the resources were retained so that they can be reused when the user reconnects to the session. CeaTsoPing. The ping request was performed, and the timestamp for the specified TSO/E session was updated. CeaTsoQuery. The query completed with no errors. CeaTsoQueryApp. The query by application completed with no errors. An array of query structures were allocated and populated with information about the sessions. Action: None.
00000004	Equate symbol: CEAWARNING Meaning: One or more warnings occurred during CEATSOREQUEST processing. Action: Check the reason and diagnostic codes to obtain additional information, and correct any errors.