ConnectWorkMgr() — Connect to WLM as a work manager

#include <sys/__wlm.h>

unsigned long ConnectWorkMgr(const char *subsystype,
                             const char *subsysname);

AMODE 64:

#include <sys/__wlm.h>

unsigned int ConnectWorkMgr(const char *subsystype,
                             const char *subsysname);

The ConnectServer function provides the ability for an application to connect to WLM as a WLM work manager to perform WLM work manager functions.

*subsystype

Points to a NULL-terminated character string containing the generic subsystem type (CICS, IMS, WEB, etc.). This is the primary category under which WLM classification rules are grouped. The character string can be up to 4 bytes in length.

*subsysname

Points to a NULL-terminated character string containing the subsystem name used for classifying work requests. The character string can be up to 8 bytes in length.

If unsuccessful, ConnectServer() 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 connect 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).