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 ConnectExportImport(const char *subsystype,
                                  const char *subsysname);
AMODE 64: 
#include <sys/__wlm.h>

unsigned int ConnectExportImport(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