ConnectExportImport() — WLM connect for export or import use
Standards
Standards / Extensions | C or C++ | Dependencies |
---|---|---|
z/OS® UNIX | both | OS/390 V2R9 |
Format
#include <sys/__wlm.h>
unsigned long ConnextExportImport(const char *subsystype,
const char *subsysname);
AMODE 64:
#include <sys/__wlm.h>
unsigned int ConnextExportImport(const char *subsystype,
const char *subsysname);
General description
Provides the ability for an application to connect to WLM to use the ExportWorkUnit(), UndoExportWorkUnit(), ImportWorkUnit(), and UndoImportWorkUnit() functions.
Note that if you need to use the CreateWorkUnit() function, you should use ConnectWorkMgr() instead.
The ConnectExportImport() function uses the following parameters:
- *subsystype
- Points to a NULL-terminated character string containing the subsystem type by which to identify the connector. The export and import functions do not use the string. A meaningful string should be used since it can appear in WLMDATA IPCS reports. The character string can be up to 4 bytes in length.
- *subsysname
- Points to a NULL-terminated character string containing the subsystem name by which to identify the connector. The export and import functions do not use the string. A meaningful string should be used since it can appear in WLMDATA IPCS reports. The character string can be up to 8 bytes in length.
Returned value
If successful, ConnectExportImport() returns 0.
If unsuccessful, ConnectExportImport() 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.
- EMVSWLMERROR
- A WLM service failed. Use __errno2() to obtain the WLM service reason code for the failure.
Related information
- sys/__wlm.h
- ExportWorkUnit() — WLM export service
- ImportWorkUnit() — WLM import service
- QueryWorkUnitClassification() — WLM query enclave classification service
- UnDoExportWorkUnit() — WLM undo export service
- UnDoImportWorkUnit() — WLM undo import service
- For more information, see z/OS MVS Programming: Workload Management Services.