Programming Requirements
- The macro CVT must be included to use this macro.
- The macro IWMYCON must be included to use this macro.
- The macro IWMPB must be in the library concatenation, since it
is included by IWMYCON.
- Note that the high order halfword of 31-BIT register 0, and the
reason code variable when specified, may be non-zero and represents
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.
- 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.
- 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.
- If the parameter EWLMMODE=EXPLICIT_SINGLE is specfied, some 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 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.
- All data in the optional classify parameter list (CLSFY=xxx) are
ignored, including the EWLM_CORR. If the application wants to specify
an EWLM parent correlator or classification attributes for an EWLM
hop0 work request, these data have to be passed in the classification
parameter list on the IWM4ECRE (IWMECREA) call and thus will be the
same for all work requests on the enclave.
|