IVM lslparutil Command

Purpose

List utilization metrics for the managed system and partitions. This command is available only in an Integrated Virtualization Manager environment.

Syntax

To list utilization metrics:

lslparutil {-r sys | pool | lpar } [ --startyear Year ] [ --startmonth Month ] [ --startday Day ] [ --starthour Hour ] [ --startminute Minute ] [ --endyear Year ] [ --endmonth Month ] [ --endday Day ] [ --endhour Hour ] [ --endminute Minute ] [ -n NumberOfEvents ] [ --filter "FilterData" ] [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

To list utilization configuration attributes:

lslparutil -r config [ -F "AttributeNames" ] [ --header ] [ -m ManagedSystem ]

Description

The lslparutil command lists utilization metrics for the managed system and partitions. The sample rate at which these metrics are gathered can be changed, or disabled. The information gathered from this command allows for the determination of processor utilization on a system and partition level over a given period of time.

Flags

-r ResourceType The type of resources to list:
  • -r config: List configuration attributes for utilization monitoring
    • Attributes: sample_rate
    • Filters: None
  • -r lpar: List utilization data for partitions
    • Attributes: time, sys_time, event_type, resource_type, time_cycles, lpar_id, uptime, curr_proc_mode, curr_proc_units, curr_procs, curr_sharing_mode, curr_uncap_weight, curr_5250_cpw_percent, curr_mem,entitled_cycles, capped_cycles, uncapped_cycles
    • Filters: { lpar_ids | lpar_names}
  • -r pool: List utilization data for shared processor pools
    • Attributes: time, sys_time, event_type, resource_type, time_cycles, shared_proc_pool_id, curr_avail_pool_proc_units, configurable_pool_proc_units, borrowed_pool_proc_units, total_pool_cycles, utilized_pool_cycles
    • Filters: None
  • -r sys: List utilization data for the managed system
    • Attributes: time, sys_time, event_type, resource_type, state, configurable_sys_proc_units, configurable_sys_mem, curr_avail_sys_proc_units, curr_avail_5250_cpw_percent, curr_avail_sys_mem, sys_firmware_mem, proc_cycles_per_second
    • Filters: None
--startyear Year Starting year filter (default 1970)
--startmonth Month Starting month filter (default 1) January is 1. December is 12
--startday Day Starting day filter (default 1)
--starthour Hour Starting hour filter (default 0)
--startminute Minute Starting minute filter (default 0)
--endyear Year Ending year filter (default now)
--endmonth Month Ending month filter (default now)
--endday Day Ending day filter (default now)
--endhour Hour Ending hour filter (default now)
--endminute Minute Ending minute filter (default now)
--n NumberOfEvents Starting from the most recent event, the maximum number of samples to return.
-m ManagedSystem The name of the managed system. This attribute is optional because there is only one system to manage. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*ssssssss, where tttt is the machine type, mmm is the model, and ssssssss is the serial number of the managed system.
--filter FilterData The filters to apply to the resources to be listed. Filters are used to select which resources of the specified resource type are to be listed. If no filters are used, then all of the resources of the specified resource type will be listed. For example, specific partitions can be listed by using a filter to specify the names or IDs of the partitions to list. Otherwise, if no filter is used, then all the partitions in the managed system will be listed.

The filter data consists of filter name/value pairs, which are in comma separated value (CSV) format. The filter data must be enclosed in double quotes.

The format of the filter data is as follows: 

"filter-name=value,filter-name=value,..."

Note that certain filters accept a comma separated list of values, as follows:

""filter-name=value,value,...",..."

When a list of values is specified, the filter name/value pair must be enclosed in double quotes. Depending on the shell being used, nested double quote characters may need to be preceded by an escape character, which is usually a '\' character.

Unless otherwise indicated, multiple values can be specified for each filter.

Valid filter names for -r lpar

lpar_ids
ID of the partitions to view
lpar_names
Name of the partitions to view
-F AttributeNames A delimiter separated list of attribute names for the desired attribute values to be displayed for each resource. If no attribute names are specified, then values for all of the attributes for the resource will be displayed.

When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option.

This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

Attribute Names:

borrowed_pool_proc_units
Processing units that are being borrowed from powered off partitions with dedicated processors.
capped_cycles
The number of capped processing cycles utilized by this partition since the system started.
configurable_pool_proc_units
The number of configurable processing units in the shared pool at the time of the sample
configurable_sys_mem
The amount of configurable system memory (in megabytes) at the time of the sample.
configurable_sys_proc_units
The number of configurable system processing units at the time of the sample.
curr_5250_cpw_percent
The 5250 CPW percent assigned to the partition at the time of the sample.
curr_avail_5250_cpw_percent
The 5250 CPW percent available to be assigned to partitions at the time of the sample.
curr_avail_pool_proc_units
The number of processing units available to be assigned to partitions at the time of the sample.
curr_avail_sys_mem
The amount of memory (in megabytes) available to be assigned to partitions at the time of the sample.
curr_avail_sys_proc_units
The number of processing units available to be assigned to partitions at the time of the sample.
curr_mem
The amount of memory (in megabytes) assigned to the partition at the time of the sample.
entitled_cycles
The number of processing cycles to which the partition has been entitled since the system started. This value is based on the number of processing units assigned to the partition, and may be greater than, or smaller than the number of cycles actually used.
curr_proc_mode
The processing mode for the partition at the time of the sample. Valid values
  • ded: dedicated processor mode
  • shared: shared processor mode curr_proc_units
curr_procs
The number of processors or virtual processors assigned to the partition at the time of the sample.
curr_sharing_mode
The sharing mode of the partition at the time of the sample. Valid values:
  • keep_idle_procs: valid with dedicated processor mode
  • share_idle_procs: valid with dedicated processor mode
  • cap: capped mode. valid with shared processor mode
  • uncap: uncapped mode. valid with shared processor mode
curr_uncap_weight
The current weighted average of processing priority when in uncapped sharing mode at the time of the sample. The smaller the value, the lower the weight. Valid values are 0-255
event_type
The type of event. This will be displayed with a constant value of sample for all samples except the config resource type.
lpar_id
The unique integer identifier for the partition
proc_cycles_per_second
Processing cycles per second on one physical processor. This value is static for a particular managed system.
resource_type
The resource type queried. Valid values are sys, pool, and lpar, depending on which value is supplied for the -r flag.
sample_rate
The rate at which samples are obtained. This can be changed with the chlparutil command. Valid values:
  • 0: Samples will not be retrieved.
  • 30: Samples will be retrieved every 30 seconds. This is the default value.
shared_proc_pool_id
The unique decimal identifier for a shared processing pool.
state
The state of the managed system at the time of the sample.
sys_firmware_mem
Amount of memory, in megabytes, on the managed system that is being used by system firmware at the time of the sample.
sys_time
The time on the managed system that the sample was taken. The time and sys_time attributes will have the same value.
time
The time on the management partition that this sample was taken. The time and sys_time attributes will have the same value.
time_cycles
The number of time cycles since the system was started.
total_pool_cycles
The total number of processing cycles available in the shared pool since the system was started.
uncapped_cycles
The number of uncapped processing cycles utilized by this partition since the system was started.
uptime
The amount of time (in seconds) that the partition has been running at the time of the sample.
utilized_pool_cycles
The number of processing cycles in the shared pool that have been utilized since the system was started.
--header Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.

Exit Status

This command has a return code of zero on success.

Security

This command is accessible by all users.

Examples

  1. To list the last five shared processing pool utilization metrics, type: 
    lslparutil -r pool -n 5
  2. To calculate the shared processing pool utilization in percent over a five-minute time period, type: 
    lslparutil -r pool --startyear 2005 --startmonth 6 --startday 26 --starthour 12 --startminute 8 \
 --endyear 2005 --endmonth 6 --endday 26 --endhour 12 --endminute 13 -F time,total_pool_cycles, \
utilized_pool_cycles
    06/26/2005 12:08:01,134841811733640,467081011935
06/26/2005 12:08:31,134854347365860,467116506907
06/26/2005 12:09:02,134866883128692,467152556956
06/26/2005 12:09:32,134879415157938,467188374373
06/26/2005 12:10:02,134891946956456,467223704573
06/26/2005 12:10:32,134904482088726,467258616569
06/26/2005 12:11:03,134917026289150,467295577359
06/26/2005 12:11:33,134929553859752,467333227651
06/26/2005 12:12:03,134942086330068,467368397739
06/26/2005 12:12:33,134954622214624,467403199531
06/26/2005 12:13:04,134967149091025,467439053292
    Pool utilization = (utilized_pool_cycle / total_pool_cycles) * 100
Pool utilization = ((467439053292 - 467081011935) / (134967149091025 - 134841811733640)) * 100
Pool utilization = 0.29%
  3. To calculate the processing utilization in percent for partition 1 over the last 11 samples, type: 
    lslparutil -r lpar -F time,lpar_id,entitled_cycles,capped_cycles,uncapped_cycles --filter lpar_ids=1 -n 11
    06/26/2005 12:08:01,1,13475439617080,353179654833,93964052971
06/26/2005 12:08:31,1,13476693184663,353213970760,93964052971
06/26/2005 12:09:02,1,13477946765207,353248812551,93964052971
06/26/2005 12:09:32,1,13479199972343,353283141535,93964052971
06/26/2005 12:10:02,1,13480453156357,353317211748,93964052971
06/26/2005 12:10:32,1,13481706673802,353350985013,93964052971
06/26/2005 12:11:03,1,13482961098044,353386674795,93964052971
06/26/2005 12:11:33,1,13484213859686,353423048854,93964052971
06/26/2005 12:12:03,1,13485467110700,353456792591,93964052971
06/26/2005 12:12:33,1,13486720703117,353490258336,93964052971
06/26/2005 12:13:04,1,13487973395246,353524992184,93964052971
    Processor utilization = ((capped_cycles + uncapped_cycles) / entitled_cycles) * 100
Processor utilization = (((353524992184 - 353179654833) + (93964052971 - 93964052971)) / (13487973395246 - 13475439617080)) * 100
Processor utilization = 2.76%

Related Information

The chlparutil and lssyscfg commands.

Send feedback |  Rate this page