CheckSchEnv() — Check WLM scheduling environment
Standards
Standards / Extensions | C or C++ | Dependencies |
---|---|---|
z/OS® UNIX | both |
Format
#include <sys/__wlm.h>
int CheckSchEnv(const char *sched_env,
const char *system_name);
General description
The CheckSchEnv() function provides the ability for an application
to connect to check the WLM scheduling environment.
- *sched_env
- Points to a 16 byte character string that represents the WLM scheduling environment to be queried. If the environment name is less than 16 characters, the name should be right padded with blanks.
- *sys_name
- Points to a 8 bytes character string that represents the system name to be queried. If the system name is less than 8 characters, the name should be right padded with blanks.
Returned value
If successful, CheckSchEnv() returns 0.
If unsuccessful, CheckSchEnv() 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 check scheduling environment 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
- ConnectServer() — Connect to WLM as a server manager
- 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