Querying an Enclave's Classification Information

A caller can use the IWM4EQRY macro to determine the classification information about an enclave. The classification information is that information passed on the IWM4CLSY macro for an independent enclave or inherited from the owning address space for a dependent enclave. For details on IWM4CLSY, see IWM4CLSY – Classifying Work.

Example

To determine the classification attributes associated with an enclave represented by ETOKEN, first issue IWM4EQRY to determine the length of the storage required to contain the classification information. The length of the area is dependent on the MVS™ release. Specify the following:

IWM4EQRY ETOKEN=etoken,
         ANSAREA=ansarea,
         ANSLEN=anslen,
         QUERYLEN=querylen

where the calling program has defined the following, and ansarea and anslen are set to zero:

etoken    DS    FL4          enclave token
ansarea   DS    A            Area to contain address of
                             classification
anslen    DS    A            Length of the answer area
querylen  DS    A            Length of storage required

Obtain the amount of storage passed back in querylen and set anslen equal to querylen. Set ansarea to point to the storage and issue IWM4EQRY again for the enclave classification information:

IWM4EQRY ETOKEN=etoken,
         ANSAREA=ansarea,
         ANSLEN=anslen,
         QUERYLEN=querylen