__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.

Related information