wlm_get_procinfo Subroutine

Purpose

Retreives per-process Workload Manager information.

Library

Workload Manager Library (libwlm.a)

Syntax

#include <sys/wlm.h>

int wlm_get_procinfo (pid, wlmpinfop)
pid_t pid;
struct wlm_procinfo *wlmpinfop;

Description

The wlm_get_procinfo subroutine returns Workload Manager information for the process associated with the pid parameter, into the buffer pointed to by the wlmpinfop parameter. If process total accounting is disabled, the related fields (totalconnecttime, termtime, totalcputime, and totaldiskio) are set to -1. When WLM is on, the class name of the process is set in the classname field of the wlm_procinfo structure. When WLM is off, this field is set to Unclassified.

Parameters

Item Description
pid Indicates from which process to retrieve the Workload Manager information.
wlmpinfop Points to the buffer where the Workload Manager information is stored.
wlminfop The address of a struct wlm_procinfo data structure. The following fields of the wlm_procinfo structure need to be provided:

version

Needs to be initialized with WLM_VERSION.

Return Values

Upon successful completion, the wlm_get_procinfo subroutine returns a zero. If the wlm_get_procinfo subroutine is unsuccessful, a nonzero value is returned.

Error Codes

For a list of the possible error codes returned by the WLM API functions, see the description of the wlm.h header file.