ExportWorkUnit() — WLM export service

Standards

Standards / Extensions C or C++ Dependencies
z/OS® UNIX both OS/390 V2R9

Format

#include <sys/__wlm.h>

int ExportWorkUnit(wlmetok_t *enclavetoken,
                   wlmxtok_t *exporttoken,
                   unsigned long *conntoken);
AMODE 64:
#include <sys/__wlm.h>

int ExportWorkUnit(wlmetok_t *enclavetoken,
                   wlmxtok_t *exporttoken,
                   unsigned int *conntoken);

General description

Exports an enclave to all systems in a parallel sysplex, enabling dispatchable units on other systems to join the enclave.

The ExportWorkUnit() function uses the following parameters:
*enclavetoken
Points to a work unit enclave token that was returned from a call to CreateWorkUnit() or ContinueWorkUnit().
*exporttoken
Points to a data field of type wlmxtok_t where the ExportWorkUnit() function is to return the WLM work unit export token.
*conntoken
Specifies the connect token that represents the connection to WLM.

Returned value

If successful, ExportWorkUnit() returns 0.

If unsuccessful, ExportWorkUnit() 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 a value that is not correct.
EMVSSAF2ERR
An error occurred in the security product.
EMVSWLMERROR
A WLM service 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 the BPX.WLMSERVER class is defined. If BPX.WLMSERVER is not defined, the calling process is not defined as a superuser (UID=0).

Related information