DeleteWorkUnit() — Delete a WLM work unit
Standards
| Standards / Extensions | C or C++ | Dependencies |
|---|---|---|
| z/OS® UNIX | both |
Format
#include <sys/__wlm.h>
int DeleteWorkUnit(wlmetok_t *enclavetoken);General description
The DeleteWorkUnit() function provides the ability for an application
to delete a WLM work unit.
- *enclavetoken
- Points to a work unit enclave token that was returned from a call to CreateWorkUnit() or ContinueWorkUnit().
Returned value
If successful, DeleteWorkUnit() returns 0.
If unsuccessful, DeleteWorkUnit() returns -1 and sets errno to
one of the following values:
- Error Code
- Description
- EFAULT
- An argument of this function contained an address that was not accessible to the caller.
- EINVAL
- An argument of this function contained an incorrect value.
- EMVSSAF2ERR
- An error occurred in the security product.
- EMVSWLMERROR
- The WLM delete enclave failed. Use __errno2() to obtain the WLM service reason code for the failure.
- EPERM
- The calling thread's address space is not permitted to the BPX.WLMSERVER Facility class. The caller's address space must be permitted to the BPX.WLMSERVER Facility class if it is defined. If BPX.WLMSERVER is not defined, the calling process is not defined as a superuser (UID=0).
Related information
- sys/__wlm.h — WorkLoad Manager functions
- CheckSchEnv() — Check WLM scheduling environment
- ConnectServer() — Connect to WLM as a server manager
- ConnectWorkMgr() — Connect to WLM as a work manager
- ContinueWorkUnit() — Continue WLM work unit
- DisconnectServer() — Disconnect from WLM server
- ExtractWorkUnit() — Extract enclave service
- JoinWorkUnit() — Join a WLM work unit
- LeaveWorkUnit() — Leave a WLM work unit
- QueryMetrics() — Query WLM system information
- QuerySchEnv() — Query WLM scheduling environment