Standards
Standards / Extensions |
C or C++ |
Dependencies |
z/OS® UNIX |
both |
|
Format
#include <sys/__wlm.h>
unsigned long ConnectServer(const char *subsystype,
const char *subsysname,
const char *applenv,
int *paralleleu);
AMODE 64:
#include <sys/__wlm.h>
unsigned int ConnectServer(const char *subsystype,
const char *subsysname,
const char *applenv,
int *paralleleu);
General description
The ConnectServer function provides the ability for an application
to connect to WLM as a WLM server manager to perform WLM server 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.
- *applenv
- Points to a NULL-terminated character string that contains the
name of the application environment under which work requests are
processed. The character string can be up to 32 bytes in length.
- *paralleleu
- Points to an integer which contains the maximum number of tasks
within the address space which will be created to process concurrent
work requests.
Returned value
If successful, ConnectServer() returns a nonzero value representing
a WLM connect token.
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).