Read the characteristics of superclasses or subclasses.
Workload Manager Library (libwlm.a)
The wlm_get_info subroutine is used to get the characteristics of the classes defined in the active Workload Manager (WLM) configuration, together with their current resource usage statistics. For a detailed description of the fields of the structure wlm_info, refer to the description of the wlm.h header file in the AIX® Version 7.1 Files Reference documentation.
By default, the scope of the wlm_get_info subroutine is all the superclasses and all the subclasses. This scope can be limited to a subset of the classes using flags in the versflags field of wlm_args or a superclass or subclass name in the name field of the substructure class_definition of wlm_args.
The information related to the superclasses and subclasses within the scope of wlm_get_info are copied to the array of wlm_info structures pointed to by info. The total number of classes for which information is copied to the array at info is limited to the value of the integer pointed to by count. If the routine is successful, the value of the integer pointed to by count is set to the actual number of classes copied. If the value passed to the routine for the count is equal to zero (0), wlm_get_info does not copy any class statistics but sets this count to the number of classes in scope for the specific set of parameters. This is a way of finding out how big an array is needed to get all the information for a given set of classes (superclasses or subclasses).
This is a way of finding out how big an array is needed to get all the information for a given set of classes (superclasses or subclasses).
The wlm_get_info subroutine does not require any special privileges and is accessible to all users. wlm_get_info fails if WLM is off.
The following fields of the wlm_args structure and the embedded substructures need to be provided:
WLM_SUPER_ONLY and WLM_SUB_ONLY are mutually exclusive.
All the other fields of the wlm_args structure can be left uninitialized.
Upon successful completion, the wlm_get_info subroutine returns a value of 0. If the wlm_get_info subroutine is unsuccessful a non-0 value is returned.
For a list of the possible error codes returned by the WLM API functions, see the description of the wlm.h header file.