CEE3SRC—Set the enclave return code

CEE3SRC sets the user enclave return code. The value set is used in the calculation of the final enclave return code at enclave termination.
Read syntax diagramSkip visual syntax diagram
Syntax

>>-CEE3SRC--(--return_code--,--fc--)---------------------------><

return_code (input)
An INT4 data type. The enclave return code to be set should be <= 999,999 and >= 0 to be in the Language Environment-preferred range. (The initial value is 0.)
fc (output)
A 12-byte feedback code, optional in some languages, that indicates the result of this service. If you choose to omit this parameter, refer to Invoking callable services for the appropriate syntax to indicate that the feedback code was omitted.

The following symbolic conditions can result from this service:

Code Severity Message number Message text
CEE000 0 The service completed successfully.
CEE0HA 1 0554 A value outside the preferred range of 0 through 999,999 was supplied. However, the value was still used as the enclave return code.

Usage notes

  • z/OS UNIX consideration—CEE3SRC is not supported in multithread applications.
  • PL/I MTF consideration—For PL/I multitasking applications, the user return code value set during invocation of CEE3SRC affects the current task only. If a PL/I program causes an enclave to terminate, the value set by CEE3SRC at the associated task level is reflected in the final return code at enclave termination.
  • PL/I consideration—When running PL/I with POSIX(ON), CEE3SRC is not supported.

For more information

Examples

CEE3SRC is used with CEE3GRC; see the examples for CEE3GRC show in Examples.