query_capacity.h

Go to the documentation of this file.

/* Copyright IBM Corp. 2013, 2019 */

#ifndef QUERY_CAPACITY
#define QUERY_CAPACITY


/* Build Customization */
#define CONFIG_DEBUG_TIMESTAMPS         // Print timestamps in log
//#define CONFIG_DUMP_READING           // Allow to read in dumps
//#define CONFIG_V1_COMPATIBILITY       // Support functionality deprecated in v1.x
//#define CONFIG_TEXTUAL_HYPFS          // Use data from textual hypfs if available

enum qc_layer_types {
        QC_LAYER_TYPE_CEC = 1,
        QC_LAYER_TYPE_LPAR_GROUP = 8,
        QC_LAYER_TYPE_LPAR = 2,
        QC_LAYER_TYPE_ZVM_HYPERVISOR = 3,
        QC_LAYER_TYPE_ZVM_CPU_POOL = 4,
        QC_LAYER_TYPE_ZVM_RESOURCE_POOL = 4,
        QC_LAYER_TYPE_ZVM_GUEST = 5,
        QC_LAYER_TYPE_KVM_HYPERVISOR = 6,
        QC_LAYER_TYPE_KVM_GUEST = 7,
        QC_LAYER_TYPE_ZOS_HYPERVISOR = 9,
        QC_LAYER_TYPE_ZOS_TENANT_RESOURCE_GROUP = 10,
        QC_LAYER_TYPE_ZOS_ZCX_SERVER = 11,
};

enum qc_layer_categories {
        QC_LAYER_CAT_GUEST = 1,
        QC_LAYER_CAT_HOST = 2,
        QC_LAYER_CAT_POOL = 3,
};

enum qc_part_chars {
        QC_PART_CHAR_DEDICATED = 1,
        QC_PART_CHAR_SHARED = 2,
        QC_PART_CHAR_LIMITED = 4,
};

enum qc_cappings {
        QC_CAPPING_OFF = 0,
        QC_CAPPING_SOFT = 1,
        QC_CAPPING_HARD = 2,
};

enum qc_model_families {
        QC_TYPE_FAMILY_IBMZ = 0,
        QC_TYPE_FAMILY_LINUXONE = 1,
};

enum qc_attr_id {
        qc_adjustment = 0,
        qc_capability = 1,
        qc_capacity_adjustment_indication = 2,
        qc_capacity_change_reason = 3,
        qc_capping = 4,
        qc_capping_num = 5,
        qc_cluster_name = 6,
        qc_control_program_id = 7,
        qc_cp_absolute_capping = 8,
        qc_cp_capacity_cap = 9,
        qc_cp_capped_capacity = 10,
        qc_cp_dispatch_limithard = 11,
        qc_cp_dispatch_type = 12,
        qc_cp_limithard_cap = 13,
        qc_cp_weight_capping = 14,
        qc_limithard_consumption = 15,
#ifdef CONFIG_V1_COMPATIBILITY

        qc_hardlimit_consumption = 15,
#endif

        qc_has_multiple_cpu_types = 16,
        qc_ifl_absolute_capping = 17,
        qc_ifl_capacity_cap = 18,
        qc_ifl_capped_capacity = 19,
        qc_ifl_dispatch_limithard = 20,
        qc_ifl_dispatch_type = 21,
        qc_ifl_limithard_cap = 22,
        qc_ifl_weight_capping = 23,
        qc_ziip_absolute_capping = 66,
        qc_ziip_capacity_cap = 67,
        qc_ziip_capped_capacity = 68,
        qc_ziip_dispatch_limithard = 69,
        qc_ziip_dispatch_type = 70,
        qc_ziip_limithard_cap = 71,
        qc_ziip_weight_capping = 72,
        qc_layer_category = 24,
        qc_layer_category_num = 25,
        qc_layer_extended_name = 26,
        qc_layer_name = 27,
        qc_layer_type = 28,
        qc_layer_type_num = 29,
        qc_layer_uuid = 30,
        qc_manufacturer = 31,
        qc_mobility_enabled = 32,
#ifdef CONFIG_V1_COMPATIBILITY

        qc_mobility_eligible = 32,
#endif

        qc_has_secure = 77,
        qc_secure = 78,
        qc_model = 33,
        qc_model_capacity = 34,
        qc_type_family = 65,
        qc_num_cp_dedicated = 35,
        qc_num_cp_shared = 36,
        qc_num_cp_total = 37,
        qc_num_cpu_configured = 38,
        qc_num_cpu_dedicated = 39,
        qc_num_cpu_reserved = 40,
        qc_num_cpu_shared = 41,
        qc_num_cpu_standby = 42,
        qc_num_cpu_total = 43,
        qc_num_ifl_dedicated = 44,
        qc_num_ifl_shared = 45,
        qc_num_ifl_total = 46,
        qc_num_ziip_dedicated = 73,
        qc_num_ziip_shared = 74,
        qc_num_ziip_total = 75,
        qc_partition_char = 47,
        qc_partition_char_num = 48,
        qc_partition_number = 49,
        qc_plant = 50,
        qc_secondary_capability = 51,
        qc_sequence_code = 52,
        qc_type = 53,
        qc_prorated_core_time = 54,
        qc_num_cp_threads = 55,
        qc_num_ifl_threads = 56,
        qc_num_ziip_threads = 76,
        qc_num_core_total = 57,
        qc_num_core_configured = 58,
        qc_num_core_standby = 59,
        qc_num_core_reserved = 60,
        qc_num_core_dedicated = 61,
        qc_num_core_shared = 62,
        qc_type_name = 63,
        qc_lic_identifier = 64,
};


void *qc_open(int *rc);

void qc_close(void *hdl);

int qc_get_num_layers(void *hdl, int *rc);

int qc_get_attribute_string(void *hdl, enum qc_attr_id id, int layer, const char **value);

int qc_get_attribute_int(void *hdl, enum qc_attr_id id, int layer, int *value);

int qc_get_attribute_float(void *hdl, enum qc_attr_id id, int layer, float *value);

void qc_export_json(void *hdl);

#endif