Programming Requirements

1. The macro CVT must be included to use this macro.
2. The macro IWMYCON must be included to use this macro.
3. The macro IWMPB must be in the library concatenation, since it is included by IWMYCON.
4. Note that the high-order halfword of 31-bit register 0, and the reason code variable when specified, may be non-zero and represent diagnostic data which is not part of the external interface. The high-order halfword should thus be excluded from comparison with the reason code values described above. The constant, IWMRSNCODE_MASK_CONST defined in IWMYCON, may be used for this purpose.
5. All character data, unless otherwise specified, is assumed to be left-justified and padded with blanks on the right, as needed, to occupy the specified number of bytes.
6. Since this service may only be used by system-like code, some validity checking on the parameter list is not performed. These checks would only be needed if the macro were not used to invoke the service routine.
7. If the parameter EWLMMODE=EXPLICIT_SINGLE is specified, the following restrictions apply:
   • No other task or SRB is allowed to issue other enclave services for the same enclave concurrently.
   • The caller must be in primary ASC mode before invocation.
   • The parameter list, the classification parameters and the savearea pointed to by GPR13 must be addressable in AMODE 31 and primary ASC mode.
   • No recovery environment is set up by the service. The caller is responsible to provide an appropriate error recovery environment to handle abnormal terminations.
   • The enclave must have been created with option ESTRT=EXPLICIT_SINGLE on the IWM4ECRE (or IWMECREA) invocation.
   • The caller must provide the ETOKEN parameter.