ExtractWorkUnit() — Extract enclave service

Standards

Standards / Extensions C or C++ Dependencies

z/OS® UNIX

both OS/390 V2R8

Format

#include <sys/__wlm.h>

int ExtractWorkUnit(wlmetok_t *enclavetoken);

General description

The ExtractWorkUnit() function will allow the task to retrieve the enclaves token for the purpose of performance management.

The ExtractWorkUnit() function uses the following parameter:
*enclavetoken
Points to a data field of type wlmetok_t where the ExtractWorkUnit() function is to return the WLM work unit token to which the current process is joined.

Returned value

If successful, ExtractWorkUnit() returns 0.

If unsuccessful, ExtractWorkUnit() returns -1 and sets errno to one of the following values:
Error Code
Description
EFAULT
An argument of this service contained an address that was not accessible to the caller.
EINVAL
The Functioncode parm contains a value that is not correct or the function parmlist data is incorrect.
EMVSSAF2ERR
An error occurred in the security product. Consult the reason code, which can be retrieved using the __errno2() function.
EMVSWLMERROR
A WLM service failed. Consult the reason code, which can be retrieved using the __errno2() function.
EPERM
Do not have appropriate permissions and privilege.
ESRCH
A WLM_EXTRACT_WORKUNIT request was issued but the WLM enclave token was not returned.

Related information