__server_threads_query() — Query the number of threads
Standards
Standards / Extensions | C or C++ | Dependencies |
---|---|---|
z/OS® UNIX |
both | OS/390 V2R10 |
Format
#include <sys/server.h>
int __server_threads_query(int *threads);
General description
Provides information about the number of threads a server should be using for this server environment. After a successful query, threads will contain the number of threads that the WorkLoad Manager (WLM) recommends for this address space.
Usage notes
This service is a privileged
service that requires the caller to be authorized in one of the following
ways:
- Have read access to the BPX.WLMSERVER FACILTY class profile
- Have a UID=0 when the BPX.WLMSERVER FACILTY class profile is not defined
Returned value
If successful, __server_threads_query() returns 0.
If unsuccessful, __server_threads_query() returns
-1 and sets errno to one of the following values:
- Error Code
- Description
- EINTR
- The wait was interrupted by an unblocked, caught signal. No further waiting will occur for this call. __server_threads_query() can be reissued to begin waiting again.
- EPERM
- The caller is not permitted to perform the specified operation.