Standards
| Standards / Extensions |
C or C++ |
Dependencies |
|---|
| z/OS® UNIX |
both |
|
Format
#include <sys/__wlm.h>
int QueryMetrics(struct sysi *sysi_ptr, int *anslen);
General description
The QueryMetrics() function provides the ability for an application
to query WLM system information.
- *sysi_ptr
- Points to a buffer that the service is to return the WLM system
information. The data returned is in the format of the structure
sysi.
- *anslen
- Points to an integer data field that contains the length of
the buffer to return the WLM system information into.
Returned value
If successful, QueryMetrics() returns 0.
If unsuccessful, QueryMetrics() returns -1 and sets errno to one
of the following values. If the returned errno and __errno2() indicate
the supplied buffer is too small, the
anslen argument is
updated to contain the length required to hold WLM system information.
- 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 query system information 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).