Diagnostic codes

Table 1 lists and describes the diagnostic codes that are typically returned after the CEATsoRequest API processes a request. Additional diagnostic codes might also be returned from services that obtained an unexpected error. Those diagnostic codes are not listed in the table.

Table 1. Diagnostic code
Hexadecimal Diagnostic Code	Equate Symbol and Meaning
04	Equate symbol: kCEATsoBadRacRouteExtr Meaning: The TSO/E address space was not started because an error occurred while trying to authenticate the caller. The CEA TSO/E address space service could not complete one of the following actions: Extract the security identity of the caller. Log the caller into TSO/E. Authorize the caller to a required resource. The following fields are returned in the CEATsoErrorStruct structure: diag2 contains the SAF return code from RACRoute returned in R15. diag3 contains the RACF or installation return code from the SAF parameter list. diag4 contains the RACF or installation exit reason code from the SAF parameter list. Note that a value is not always returned in diag2, diag3, and diag4.
05	Equate symbol: kCEATsoBadRacRouteCreate Meaning: An error was encountered when requesting verification of the newly created security identity. The following fields are returned in the CEATsoErrorStruct structure: diag2 contains the SAF return code from RACRoute returned in R15. diag3 contains the RACF or installation return code from the SAF parameter list. diag4 contains the RACF or installation exit reason code from the SAF parameter list.
0A	Equate symbol: kCEATsoBadAddSession Meaning: Unable to create a new TSO/E address space. The return code received from the TSO/E session is provided in the diag2 field of the CEATsoErrorStruct structure.
0B	Equate symbol: kCEATsoBadQuerySession Meaning: Unable to query the attributes of TSO/E sessions that are associated with a specific application. The return code received from the method is provided in the diag2 field of the CEATsoErrorStruct structure.
0C	Equate symbol: kCEATsoBadASCBStoken Meaning: Unable to issue an attention interrupt or query the session table for information about the TSO/E address space because the STOKEN could not be found.
0D	Equate symbol: kCEATsoBadSessIndex Meaning: The value provided in the ceatso_index field in the CeaTsoRequestStruct is zero, which is not valid. The index must be greater than or equal to one.
0F	Equate symbol: kCEATsoBadLOGONMGCRE Meaning: The MGCRE service used to issue the start command to start a TSO/E address space failed. The register where MGCRE returned its return code is provided in the diag2 field of the CEATsoErrorStruct structure. In this case, the value in the diag2 field is R15 (register 15).
10	Equate symbol: SESS_SESSIONNOLONGERINTABLE Meaning: The TSO/E session no longer exists in the session table.
11	Equate symbol: kCEATsoBadSessENQreq Meaning: Unable to acquire the ENQ on the session table. The return code received from the method is provided in the diag2 field of the CEATsoErrorStruct structure.
13	Equate symbol: kCEATsoBadSessUpdateLastRef Meaning: The ping request failed because the CEA TSO/E address space manager was unable to update the last reference timestamp for that session. The return code received from the method is provided in the diag2 field of the CEATsoErrorStruct structure.
14	Equate symbol: kCEATsoBadQuerySessionForApptag Meaning: Unable to query the sessions table for the specified application identifier because an error occurred. The return code received from the method is provided in the diag2 field of the CEATsoErrorStruct structure.
15	Equate symbol: kCEATsoBadNumEntries Meaning: The number of entries found that match the query exceeds the maximum number of sessions that can be queried or exceeds the number of entries the query structure can accommodate. The number of entries found is provided in the diag2 field of the CEATsoErrorStruct structure.
18	Equate symbol: kCEATsoBadResmgrAdd Meaning: Unable to set the end of memory resource manager; an ABEND dump was taken.
19	Equate symbol: kCEATsoBadQueryAllSessions Meaning: Unable to perform a query of all TSO/E sessions in the session table. You must search for a specific TSO/E session, or search for TSO/E sessions that are associated with a specific application identifier. The return code received from the method is provided in the diag2 field of the CEATsoErrorStruct structure.
1A	Equate symbol: kCEATsoBadApptag Meaning: The value contained in the application identifier field is not valid.
1B	Equate symbol: kCEATsoBaduserid Meaning: The value contained in the user ID field is not valid.
1C	Equate symbol: kCEATsoBadlogonproc Meaning: The value contained in the logon procedure field is not valid.
1F	Equate symbol: kCEATsoBadscreenrows Meaning: The number of screen rows specified is out of range. The minimum number of screen rows is 24, and the maximum is 204.
20	Equate symbol: kCEATsoBadscreencols Meaning: The number of screen columns specified is out of range. The minimum number of screen columns is 80, and the maximum is 160.
21	Equate symbol: kCEATsoBadaccount Meaning: The value contained in the account field is not valid.
22	Equate symbol: kCEATsoBadgroup Meaning: The value contained in the TSO/E group name field is not valid.
23	Equate symbol: kCEATsoBadregion Meaning: The value contained in the TSO/E region size field is not valid.
26	Equate symbol: kCEATsoBadCharsetCodepage Meaning: The value contained in the codepage field is not valid because no match was found in the Coded Character Set Identifiers (CCSID) table.
27	Equate symbol: kCEATsoBadregionsize Meaning: The value contained in the region size field is not valid because it exceeds the maximum allowable region size of 2,096,128.