wlm_check subroutine

Purpose

Check a WLM configuration.

Library

Workload Manager Library (libwlm.a)

Syntax

#include <sys/wlm.h>

int wlm_check ( config)

char *config;

Description

The wlm_check subroutine checks the class definitions and the coherency of the assignment rules file(s) (syntax, existence of the classes, validity of user and group names, application path names, etc.) for the configuration whose name is passed as an argument.

If config is a null pointer or points to an empty string, wlm_check performs the checks on the configuration files, in the configuration pointed to by /etc/wlm/current.

The wlm_check subroutine can apply to a configuration set. If config is a configuration set name (or if config is not provided and current is a configuration set), the checks mentioned above are performed on all configurations of the set, after checking the set itself.

Parameter

Item Description
config A pointer to a character string. This pointer should be:
  • The address of a character string representing the name of a valid configuration (a subdirectory of /etc/wlm)
  • A null pointer
  • A pointer to a null string ("")

If config is a null pointer or a pointer to a null string, the configuration files in the directory pointed to by /etc/wlm/current (active configuration) is checked for errors. Otherwise, the configuration files in directory /etc/wlm/<config_name> is checked.

Return Values

Upon successful completion, a value of 0 is returned. If the wlm_check subroutine is unsuccessful a non 0 value is returned.

Error Codes

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