wlm_initkey Subroutine

Purpose

Allocates and initializes the classes to keys translation table.

Library

Workload Manager Library (libwlm.a)

Syntax

#include <sys/wlm.h

int wlm_initkey ( struct wlm_args *args, void **ctx)

Description

The wlm_initkey subroutine allocates a block of memory, builds the keys == class names translation table and returns its address into the ctx argument.

Parameters

Item Description
args Only 2 fields need to be initialized in the wlm_args structure pointed to by args:
  • confdir specifies the null-terminated name of the WLM configuration to be searched (the name can be "current" to specify the current configuration). If the configuration name passed is an empty string (starts with '\0'), then all the configurations in /etc/wlm are searched.
  • versflags initialized with WLM_VERSION and optionally WLM_MUTE.

Return Values

If the wlm_initkey subroutine is successful, a value of 0 is returned. If the wlm_initkey subroutine is unsuccessful, an error code is returned.

Error Codes

If the wlm_initkey subroutine is unsuccessful, one of the following error codes is returned:

Item Description
WLM_BADVERS Bad version number.
WLM_NOT_INITED Missing call to wlm_init.
WLM_NOMEM Not enough memory.
WLM_NOCLASS Specified configuration does not exist.
WLM_EFAULT Invalid ctx or args argument.