ConnectServer() — Connect to WLM as a server manager
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).
Related information
- sys/__wlm.h
- CheckSchEnv() — Check WLM scheduling environment
- ConnectWorkMgr() — Connect to WLM as a work manager
- ContinueWorkUnit() — Continue WLM work unit
- CreateWorkUnit() — Create WLM work unit
- DeleteWorkUnit() — Delete a WLM work unit
- DisconnectServer() — Disconnect from WLM server
- JoinWorkUnit() — Join a WLM work unit
- LeaveWorkUnit() — Leave a WLM work unit
- QueryMetrics() — Query WLM system information
- QuerySchEnv() — Query WLM scheduling environment