Index for Section 3

Alphabetical listing for C

Bottom of page

class_change(3)
NAME
  class_change - change the allotted resources of an existing scheduling
  class

SYNOPSIS
  #include <apar_types.h>
  #include <sys/class.h>

  class_change(
	  class_apar_handle_t handle,
	  char *class_name,
	  struct resource_limits *limits );

LIBRARY
  Class Scheduling Library (libclass.a)

  This library is not available as a shared library.

PARAMETERS
  handle
      The partition descriptor returned by class_open().

  class_name
      The name of the class to change.

  limits
      The input is the new resource limits, the output is the resources
      available.

DESCRIPTION
  The class_change() routine changes the limits of the CPU resources that an
  existing class is allowed to use. If the requested percentage would cause
  the total resource percentage of all classes to exceed 100 percent, then
  the call will fail. On output, the structure contains the remaining CPU
  resource percentages available.

  Specify CLASS_RESOURCE_NO_CHANGE for all resources that are to remain
  unchanged if you only need to change some resources.

  Specify CLASS_RESOURCE_SCHED_DISABLED for the target limit of any resource
  that is not needed.

RETURN VALUES
  [CLASS_SUCCESS]
      The operation completed successfully.

  [CLASS_INVAL_PARTITION]
      An invalid partition handle was specified.

  [CLASS_NAME_INVALID]
      The class_name is not an ASCII string.

  [CLASS_NOT_EXIST]
      The class_name does not exist.

  [CLASS_INVAL_PERCENT]
      The requested percentage was not in the range 0 - 100 or was not
      CLASS_RESOURCE_SCHED_DISABLED or CLASS_RESOURCE_SCHED_DISABLED.

  [CLASS_TOO_HIGH_PERCENT]
      The requested percentage is not available. The struct resource_percent
      <xxx-available> (where xxx is an integer in the range 0-100
      representing percentage) will contain the maximum available percentage.

SEE ALSO
  Commands: runclass(1), class_admin(8)

  Functions: class_add(3), class_create(3), class_close(3),
  class_configure(3), class_get_config_stats(3), class_open(3),
  class_delete(3), class_destroy(3), class_disable(3), class_enable(3),
  class_save_database(3), class_restore_database(3), class_load_database(3),
  class_change_name(3), class_database_file_exists(3),
  class_database_name(3), class_database_modified(3), class_get_classes(3),
  class_get_class_members(3)

  Files: class_scheduling(4)

  System Administration

Index for Section 3

Alphabetical listing for C

Top of page