HMC Command Line Interface

HMC Command Line Interface HMC Command Line Interface (CLI) support is provided so that users can write scripts to automate their system management tasks. Therefore, it is the intent to provide a command line interface for every HMC function that users may want to automate. Command line interfaces for other HMC functions will also be provided as required. The command line interface is not available from a remote HMC. From a local HMC, the interface is available by right-clicking on the desktop (outside of the HMC web user interface screen). Click on 'Terminals' and 'rshlogin'. A restricted shell command line window will appear. AudienceAll parts of this course are directed toward IBM customers. Prerequisites A basic understanding of web site navigation is all you need. No prior knowledge of command line interface information is assumed. However, before doing any work with managed systems, be sure you have an understanding of the difference between logical partitions (LPARs), partition profiles, and system profiles. Migration Considerations While the HMC for Power6 systems does not support legacy systems, it is still desirable to support the existing syntax when possible. Because eServer p6 hardware and requirements are vastly different from legacy hardware and requirements, the syntax of many commands has been changed, and the old syntax has been deprecated. Deprecated syntax is not supported on eServer p6 and OpenPower systems. When a command is issued using deprecated syntax, if there is a replacement command that performs an equivalent function then an error message is displayed that gives the new command syntax to use. If there is not a replacement command available, then a general invalid syntax error message is displayed. Command Help Help text is available for each HMC command. The help text for a command consists of the command usage statement, a brief description of the command's function, a brief description of each of the command's parameters, and a list of any attributes that can be specified with the command. (An index of all Command Attributes can be found here.) The help text refers you to the man pages and publications for examples and additional information. The intent of a command's help text is to remind you what the parameters and attribute names are for the command. As such, it is not intended to give detailed information for the first-time user. First-time users should go to the man pages or publications for detailed information about commands. To display help text, all HMC commands support the --help parameter. In addition, the help text is displayed for a command when a command is entered without any parameters. When the --help parameter is included with a command, any other parameters entered with the command are ignored, and the help text for the command is displayed. Command Conventions The following UNIX conventions are used for command names: mk is used for create/make actions. ls is used for list/query actions. ch is used for change/modify actions. rm is used for remove/delete actions. Commands are of the form: verb followed by an abbreviated name of the object on which

the command will be performed. For example, lssyscfg is the command to list system configuration, lshmcusr is the command to list HMC users, etc. Commands must always have a return value. A return code of 0 is returned if the command was successful, and a non-zero return code is returned if the command failed. If a command fails, an appropriate error message is printed. All command error messages are printed to stderr. All other command output are printed to stdout. In general, commands should not print warning messages, and should not require interactive input from users. Since many users will write scripts to issue HMC commands, warning messages and interactive input would not be useful. Whenever parameter data consists of non-alphanumeric characters, the data must be enclosed in double quotes. All parameters that are a single character must be preceded with a single dash. All parameters longer than a single character must be preceded with a double dash. Non-numerical parameter and attribute values should be meaningful. Meaningful string values are preferred over arbitrary numerical values. Attribute names should be consistent across all commands. The same is true for parameter names, parameter values, filter names, and attribute values. Words that are abbreviated should always be abbreviated in the same way. Common abbreviations should be used to reduce the number of characters the user needs to type. The names of attributes and filters that accept lists should be plural. All commands must have man pages. All commands must support the --help parameter. All list commands must support the -F parameter. This facilitates tokenizing the output. List commands should also print a well-formatted report if the -F parameter is not specified. Note: throughout this course, command elements that are representative examples are enclosed in "arrow" brackets. Here is an example: lssyscfg -r sys -m In this example, means that in a real command, you would enter the actual name of the managed system. A value for is required for most commands. This can either be the user-defined name for the managed system, or be in the form MODEL-TYPE*SERIAL. A value for is always preceded by the -m flag. Setting the Power Off Policy The default power off policy for a managed system is that the system powers itself down when the last partition has been powered down. It is recommended that the managed system's power off policy be set to 1, so that the managed system continues to run after the last partition has been powered off. To do this, type the following command: chsyscfg -r sys -m -i "power_off_policy=1" Powering Off the Manufacturing Installed Partition The preconfigured manufacturing partition with an ID of 1 has been assigned all of the system's resources. You will need some free resources when you create partitions. Therefore, it is recommended that you power off the manufacturing installed partition before creating partitions. To do this, type the following command: chsysstate -r lpar -m -o off --id l Commands by Task: Activate CoD Advanced Functions - chvet Activate On/Off CoD resources - chcod

Activate partition - chsysstate Activate system profile - chsysstate Add memory to a partition - chhwres Add processors to a partition - chhwres Change the number of Utility CoD processors - chcod Create LPAR - mksyscfg Create LPAR profile - mksyscfg Create system profile - mksyscfg Deactivate all On/Off CoD processors - chcod Deactivate all On/Off CoD resources - chcod Delete LPAR - rmsyscfg Delete LPAR profile - rmsyscfg Delete system profile - rmsyscfg Display activation code generation information - lsvet Display activation history log - lsvet Enter a Capacity on Demand (CoD) code - chcod Fast power off the managed system - chsysstate Get LPAR state - lssyscfg Hard partition reset - chsysstate List all partitions in a managed system - lssyscfg List all systems managed by the HMC - lssyscfg List CoD capacity information - lscod List CoD code generation information - lscod List CoD history log - lscod List HMC remote access settings - lshmc List HMC network settings - lshmc List HMC VPD information - lshmc List HMC version - lshmc List I/O resources for a managed system - lshwres List Licensed Internal Code levels - lslic List LPAR profile properties - lssyscfg List LPAR properties - lssyscfg List managed system properties - lssyscfg List memory resources - lshwres List On/Off CoD billing information - lscod List processor resources - lshwres List reference code entries - lsrefcode List system profile properties - lssyscfg List virtual I/O resources for a managed system - lshwres Modify LPAR profile properties - chsyscfg Modify LPAR properties - chsyscfg Modify managed system properties - chsyscfg Modify system profile properties - chsyscfg Move a physical I/O slot from one partition to another - chhwres Move memory from one partition to another - chhwres Move processors from one partition to another - chhwres Power off the managed system - chsysstate Power on the managed system - chsysstate Re-IPL the managed system - chsysstate

Remove a physical I/O slot from a partition - chhwres Remove memory from a partition - chhwres Remove processors from a partition - chhwres Set a Utility CoD processor minute usage limit - chcod Soft partition reset - chsysstate Update Licensed Internal Code - updlic Validate a system profile - chsysstate Commands by Name: asmmenu - launch the ASM interfacebkconsdata - back up critical HMC databkprofdata back up profile data for the managed-systemchaccfg - change access control configuration chcod - perform Capacity on Demand (CoD) operations enter a CoD code activate an amount of CoD resources change the number of Utility CoD processors deactivate all On/Off CoD processors deactivate all On/Off CoD resources set a Utility CoD processor minute usage limit chhmc - change HMC configuration informationchhmcusr - change HMC user attributechhwres - change system memory and processor resources add memory to a partition add processors to a partition move memory from one partition to another move processors from one partition to another remove memory from a partition remove processors from a partition chkmedia - check media readinesschled - change LEDchlparutil - change utilization data collection settingschsacfg - change Service Agent configurationchsvcevent - update serviceable events on the HMCchsyscfg - change system configuration modify LPAR properties modify LPAR profile properties modify managed system properties modify system profile properties chsyspwd - change system passwordchsysstate - change system state activate partition activate system profile fast power off the managed system hard partition reset power off the managed system power on the managed system re-IPL the managed system soft partition reset chvet - activate Capacity on Demand advanced funtions enter an activation code cpdump - copy dumpscpsysplan - copy system plandefsysplanres - define system plan resourcedeploysysplan - deploy system plandump - perform dump operationgetdump - get dumpgetupgfiles - get upgrade fileshmcshutdown - shut down the HMChmcwin - proide screen capture on the HMCinstallios - install the Virtual I/O Serverlogssh - log ssh command usagelpar_netboot - retrieve MAC address and physical location code from

network adapters for a partition or instruct a partition to network bootlpcfgop - perform a partition configuration image operationlsaccfg - list access control configuration informationlscod - list Capacity on Demand resources for a managed system list CoD capacity information list CoD code generation information list CoD history log list On/Off CoD billing information lsdump - lists dump informationlshmc - List HMC Configuration Information list HMC remote access settings list HMC network settings list HMC VPD information list HMC version lshmcusr - list HMC user informationlshwinfo - list environmental informationlshwres - list the hardware resources of a managed system determine DRC indexes for physical I/O slots determine memory region size list I/O resources for a managed system list memory resources list processor resources list virtual I/O resources for a managed system lsled - list LEDslslic - list Licensed Internal Code (LIC) levels list LIC levels active on a managed system list LIC levels available in a repository lslock - list lock informationlslparutil - list utilization datalsmediadev - list storage media deviceslsrefcode - list reference code entries for partitions or managed systems list reference code entries for all partitions list reference code entries for a managed system lssacfg - list Service Agent configuration informationlssvcevents - list console or serviceable eventslssyscfg - list system configuration information get LPAR state list all partitions in a managed system list all systems managed by the HMC list LPAR profile properties list LPAR properties list managed system properties list system profile properties lssysconn - list system connectionslssysplan - list system planslssysplanres - list system plan resources lvet - list Capacity on Demand advanced functions display activation code generation information display activation history log migrcfg - migrate configurationmkaccfg - create access control objectmahmcusr - create an HMC usermksyscfg - create system configuration create LPAR profile

create system profile mksysconn - create system connectionmksysplan - make system plan filemkvterm - open a virtual terminal sessionmonhmc - monitor HMC subsystems and system resourcespedbg Product Engineering debug toolspesh - provide PE Shell accessrmaccfg - remove access control objectrmhmcusr - remove an HMC userrmlock - remove lockrmlparutil - remove utilization datarmprofdata - remove profile datarmsyscfg - remove system configuration delete LPAR delete LPAR profile delete system profile rmsysconn - remove system connectionrmsysplan - remove system planrmsysplanres remove system plan resourcermvterm - close a vertual terminal sessionrsthwres - restore hardware resourcesrstprofdata - restore profile datarstupgdata - restore upgrade datasaveupgdata - save upgrade datasendfile - transfer file from the HMC to a remote systemstartdump - start dumpupdhmc - update code on the HMCupdlic- update Licensed Internal Code (LIC) retrieve, install, activate updates retrieve and install updates remove the last update change LIC update control to HMC change LIC update control to operating system viosvrcmd - issue virtual I/O server command Powering On the Managed System Use the chsysstate command to power on the managed system. This power on option is similar to a "White Button" power on. Enter the following:chsysstate -r sys -m -o on Powering Off the Managed System Use the chsysstate command to power off the managed system. This can be done in two ways. To power off a managed system normally, type the following: chsysstate -r sys -m -o off You can also perform a fast power off (operator panel function 8) of a managed system. To do this, type the following command: chsysstate -r sys -m -o off --immed Updating Licensed Internal Code Use the updlic command to retrieve, install, and activate Licensed Internal Code on a managed system. Use the -q parameter to determine if the update is disruptive. To determine if the latest CPC update from IBM Retain is disruptive: updlic -m -o a -t cpc -l latest -r ibmretain -q To change LIC update control on the managed system from HMC to operating system: updlic -m -o o Listing HMC Current Configuration Use the lshmc command to list the current remote access settings, network settings, version, and Vital Product Data (VPD) information for the HMC. To list the remote access settings for ssh, websm, and http: lshmc -r To list the HMC hostname and network IP address: lshmc -n -F hostname,ipaddr

To list the HMC Vital Product Data (VPD) information: lshmc -v Display the HMC version information: lshmc -V Listing all Systems Managed by the HMC Use the lssyscfg command to list system configuration and managed system MTMS information. To list the properties of all systems managed by this HMC, enter the following: lssyscfg -r sys To list only the user-defined names, model types, serial numbers, and states for all of the systems managed by this HMC, enter: lssyscfg -r sys -F name,type_model,serial_num,state --header Note that after executing this command, concatenated with * then with represents the MODEL-TYPE*SERIAL, or MTMS, for the managed system. Listing a Managed System's Properties To list a specific managed system's properties, enter: lssyscfg -r sys -m Modifying the Managed System Properties Use the chsyscfg command to change the properties of a managed system. The following example shows how to change the managed system's user-defined name and power off policy: chsyscfg -r sys -m i "new_name=newsys1,power_off_policy=0" Valid attributes, specified with the i flag, include: new_name power_on_side power_off_policy power_on_speed service_lpar_id power_on_speed_override service_lpar_name Instead of entering configuration information on the command line with the -i flag, the information can be placed in a file and the filename specified with the -f flag. For more information about the valid attributes listed in this command example, refer to the Command Attributes table. Listing Reference Codes for a Managed System or Partition Use the lsrefcode command to list SRC entries for a managed system or partition. Entries may be filtered by lpar name or lpar id. To list the last 10 SRC entries for the managed system: lsrefcode -m -r sys -n 10 To list the current SRC entry for each partition on the managed system: lsrefcode -m -r lparDisplay the last 50 SRC entries for partition p1: lsrefcode -m -r lpar -n 50 --filter "lpar_names=p1" Restarting the Managed System To restart the managed system, enter: chsysstate -r sys -m -o off --immed --restart Listing Licensed Internal Code Levels for a Managed System Use the lslic command to list the LIC levels (cpc or power) on a partition or managed system that have been installed, activated, and accepted. You may also list available levels in a repository.

To list current CPC LIC levels on a managed system: lslic -m -t cpc To list available POWER LIC levels in a repository: lslic -m -t power -r Listing Capacity on Demand Information for a Managed System Use the lscod command to list memory and processor Capacity on Demand information for a managed system, including capacity, code generation, and CoD history logs for Capacity Upgrade on Demand (CUoD) and On/Off Capacity on Demand (OOCoD). More CoD operations are covered in 10.0 CLI: Performing Capacity on Demand (CoD) Operations. To list On/Off CoD processor capacity information: lscod -m -t cap -r proc -c onoff To list CUoD memory activation code generation information: lscod -m -t code -r mem -c cuod To list the Capacity on Demand history log: lscod -m -t hist To Display On/Off Capacity on Demand memory billing information: lscod -m -t bill -r mem -c onoff Creating LPARs Use the mksyscfg command to create a partition. The following is an example of how to create an AIX/Linux partition: mksyscfg -r lpar -m i "lpar_id=2,name=aixlinux_lpar2,profile_name=prof1, lpar_type=aixlinux,boot_mode=norm, desired_procs=1,min_procs=1, max_procs=1,min_proc_units=0.1, desired_proc_units=0.5,max_proc_units=0.5, proc_type=shared,sharing_mode=cap,desired_mem=400, min_mem=400, max_mem=400,auto_start=1, power_ctrl_lpar_ids=0,io_slots=553713666/65535/1" The following is an example of how to create an i5/OS (OS/400) partition: mksyscfg -r lpar -m i "lpar_id=3,name=os400_lpar3,profile_name=prof1, lpar_type=os400, desired_procs=1,min_procs=1,max_procs=1, min_proc_units=0.1,desired_proc_units=0.5, max_proc_units=0.5,proc_type=shared, sharing_mode=cap,desired_mem=400, min_mem=400, max_mem=400,auto_start=1,power_ctrl_lpar_ids=0, io_slots=553713699/65535/1, load_source_slot=553713699, console_slot=553713699,min_interactive=0, desired_interactive=0, max_interactive=0" Valid attributes, specified with the i flag, include: name desired_proc_units min_proc_units lpar_id max_proc_units ecs_slot profile_name lpar_io_pool_ids sni_windows lpar_type io_slots alt_console_slot cluster_id boot_mode sni_device_ids

sharing_mode max_virtual_slots console_slot desired_procs auto_start sni_config_mode min_procs power_ctrl_lpar_ids alt_load_source_slot max_procs virtual_opti_pool_id virtual_serial_adapters desired_mem hsl_opti_pool_id load_source_slot min_mem min_interactive virtual_scsi_adapters max_mem desired_interactive uncap_weight proc_type max_interactive virtual_eth_adapters lnstead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag. For more information about the valid attributes listed in this command example, refer to the Command Attributes table. Listing All Partitions in a Managed System Use the lssyscfg command to list all partitions in a managed system. To do this, enter: lssyscfg -r lpar -m To list only the names, IDs, and states of all partitions in a managed system, enter: lssyscfg -r lpar -m -F name,lpar_id,state --header Listing LPAR Properties Use the lssyscfg command to list the properties of a specific partition. Type the following: lssyscfg -r lpar -m --filter "lpar_ids=" Note that the partition name can be specified instead of the partition ID by using the lpar_names filter in place of the lpar_ids filter. Also, more than one partition may be specified in the filter list. For information on using the lshwres command to list a partition's I/O, virtual I/O, processor, and memory resources, see Listing Hardware Resources. Getting the LPAR State Use the lssyscfg command to display the state of a partition. Type the following: lssyscfg -r lpar -m --filter "lpar_names=" -F state Note that the partition ID can be specified instead of the partition name by using the lpar_ids filter in placeof the lpar_names filter. Also, more than one partition may be specified in the filter list. Listing All Partitions in a Managed System Use the lssyscfg command to list all partitions in a managed system. To do this, enter:

lssyscfg -r lpar -m To list only the names, IDs, and states of all partitions in a managed system, enter: lssyscfg -r lpar -m -F name,lpar_id,state --header Listing LPAR Properties Use the lssyscfg command to list the properties of a specific partition. Type the following: lssyscfg -r lpar -m --filter "lpar_ids=" Note that the partition name can be specified instead of the partition ID by using the lpar_names filter in place of the lpar_ids filter. Also, more than one partition may be specified in the filter list. For information on using the lshwres command to list a partition's I/O, virtual I/O, processor, and memory resources, see Listing Hardware Resources. Getting the LPAR State Use the lssyscfg command to display the state of a partition. Type the following: lssyscfg -r lpar -m --filter "lpar_names=" -F state Note that the partition ID can be specified instead of the partition name by using the lpar_ids filter in placeof the lpar_names filter. Also, more than one partition may be specified in the filter list. Using a Soft Partition Reset Use the chsysstate command to perform a soft reset of a partition. Type the following: chsysstate -r lpar -m -o reset -n The partition ID can be specified instead of the partition name by using the --id parameter instead of the -n parameter. Using a Hard Partition Reset Use the chsysstate command to perform a hard reset of a partition. Type the following: chsysstate -r lpar -m -o off --id The partition name can be specified instead of the partition ID by using the -n parameter instead of the --id parameter. Deleting an LPAR Use the rmsyscfg command to remove a partition. Type the following:rmsyscfg -r lpar -m -n This command removes the specified partition and all of its associated partition profiles from the specified managed system. The partitions profiles are also removed from any system profiles that contain them. The partition ID can be specified instead of the partition name by using the --id parameter instead of the -n parameter Use the chhwres command to to perform dynamic logical partitioning (DLPAR) operations on running partitions. DLPAR operations can be performed for memory, physical I/O slots, and processor resources. Memory Memory can be dynamically added to a partition, removed from a partition, or moved from one partition to another. In the following commands, the quantity of memory to be added, removed, or moved must be specified with the -q flag. This quantity is in megabytes, and must be a multiple of the memory region size for the managed system. Determining Memory Region Size To see what the memory region size is for the managed system, enter this command: lshwres -r mem -m -level sys -F mem_region_size The value returned is the memory region size in megabytes. Adding Memory to a Partition To add memory to a partition, enter this command:

chhwres -r mem -m -o a -p -q Removing Memory from a Partition To remove memory from a partition, enter this command: chhwres -r mem -m -o r -p -q Moving Memory from One Partition to Another To move memory from one partition to another partition, enter this command: chhwres -r mem -m -o m -p -t -q Physical I/O Slots A physical I/O slot can be dynamically added to a partition, removed from a partition, or moved from one partition to another. In the following commands, the DRC index of the I/O slot to be added, removed, or moved must be specified with the -s flag. Note that only one physical I/O slot can be added, removed, or moved at a time. Determining DRC Indexes for Physical I/O Slots To see the DRC indexes for all of the physical I/O slots that are on the managed system, enter this command: lshwres -r io --rsubtype slot -m The DRC index for each slot is returned via the drc_index attribute. Adding a Physical I/O Slot to a Partition To add a physical I/O slot to a partition, enter this command: chhwres -r io -m -o a -p -s Removing a Physical I/O Slot from a Partition To remove a physical I/O slot from a partition, enter this command: chhwres -r io -m -o r -p -s Moving a Physical I/O Slot from One Partition to Another To move a physical I/O slot from one partition to another partition, enter this command: chhwres -r io -m -o m -p -t -s Processors Processing resources can be dynamically added to a partition, removed from a partition, or moved from one partition to another. These processing resources depend on the type of processors used by the partitions: For partitions using dedicated processors, processing resources are dedicated processors. For partitions using shared processors, processing resources include virtual processors and processing units. Note: Currently, AIX/Linux partitions using shared processors do not support processor DLPAR operations. In the following commands, for partitions using dedicated processors, the quantity of processors to be added, removed, or moved are specified with the --procs flag. For partitions using shared processors, the quantity of virtual processors to be added, removed, or moved are also specified with the --procs flag. The quantity of processing units to be added, removed, or moved are specified with the --procunits flag. Both of these flags can be specified, but only one is required. Note that the quantity of processing units must be multiplied by 100 for the command. For example, to add, remove, or move .5 processing units, specify a quantity of 50. Adding Processors to a Partition To add processors to a partition using dedicated processors, enter this command: chhwres -r proc -m -o a -p --procs To add processors to a partition using shared processors, enter this command: chhwres -r proc -m -o a -p --procs --procunits

Removing Processors from a Partition To remove processors from a partition using dedicated processors, enter this command: chhwres -r proc -m -o r -p --procs To remove processors from a partition using shared processors, enter this command: chhwres -r proc -m -o r -p --procs --procunits Moving Processors from One Partition to Another To move processors from a partition using dedicated processors to another, enter this command: chhwres -r proc -m -o m -p -t --procs To move processors from a partition using shared processors to another, enter this command: chhwres -r proc -m -o m -p -t --procs --procunits Processing resources can also be moved between partitions using dedicated processors and partitions using shared processors. To move processing resources from a partition using dedicated processors to a partition using shared processors, specify the quantity of processors using the --procs flag. This quantity is converted to processing units (by multiplying the quantity by 100) by the HMC for the target partition. To move processing resources from a partition using shared processors to a partition using dedicated processors, specify the quantity of processing units (which must be a multiple of 100) using the --procunits flag. This quantity is converted to processors (by dividing the quantity by 100) by the HMC for the target partition. The --procs flag cannot be specified in this case. Creating an LPAR Profile Use the mksyscfg command to create a partition profile. The following is an example of how to create a partition profile: mksyscfg -r prof -m -i "name=prof3,lpar_id=2,boot_mode=norm, sfp_surveillance=1,desired_procs=2, min_procs=1,max_procs=2,min_proc_units=0.1, desired_proc_units=0.5,max_proc_units=0.5, proc_type=shared,sharing_mode=cap, desired_mem=400,min_mem=400,max_mem=400, auto_ipl=1,power_ctrl_lpar_ids=0, io_slots=553713666/65535/1" Valid attributes, specified with the -i flag, include: name lpar_id lpar_name power_ctrl_lpar_ids desired_procs min_procs max_procs desired_mem min_mem max_mem proc_type uncap_weight sharing_mode load_source_slot alt_load_source_slot console_slot alt_console_slot

ecs_slot min_proc_units desired_proc_units max_proc_units lpar_io_pool_ids io_slots boot_mode sfp_surveillance sni_windows virtual_opti_pool_id hsl_opti_pool_id min_interactive desired_interactive max_interactive max_virtual_slots virtual_eth_adapters virtual_scsi_adapters virtual_serial_adapters sni_config_mode sni_device_ids auto_ipl The profile name (name) and the partition (lpar_id or lpar_name) must be specified. Instead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag. For more information about the valid attributes listed in this command example, refer to the Command Attributes table. Listing LPAR Profile Properties Use the lssyscfg command to list a partition profile. Type the following: lssyscfg -r prof -m -filter"lpar_names=, profile_names=" Use the --filter parameter to specify the partition for which partition profiles are to be listed, and to specify which profile names to list. While the filter can only specify a single partition, it can specify multiple profile names for that partition. Note that the partition ID can be specified instead of the partition name by using the lpar_ids filter in place of the lpar_names filter. Modifying LPAR Profile Properties Use the chsyscfg command to modify a partition profiles properties. The following example shows how to change prof1's memory amounts: chsyscfg -r prof -m -i "name=prof1,lpar_name=lpar3,min_mem=256, max_mem=512,desired_mem=512" Valid attributes, specified with the -i flag, include: name lpar_name lpar_id new_name desired_procs min_procs max_procs

desired_mem min_mem max_mem proc_type uncap_weight sharing_mode load_source_slot alt_load_source_slot console_slot alt_console_slot ecs_slot min_proc_units desired_proc_units max_proc_units lpar_io_pool_ids io_slots boot_mode sfp_surveillance sni_windows virtual_opti_pool_id hsl_opti_pool_id min_interactive desired_interactive max_interactive max_virtual_slots virtual_eth_adapters virtual_scsi_adapters virtual_serial_adapters sni_config_mode sni_device_ids auto_ipl power_ctrl_lpar_ids Instead of entering configuration information on the command line with the -i flag, the information can instead be placed in a file, and the filename specified with the -f flag. For more information about the valid attributes listed in this command example, refer to the Command Attributes table. Deleting an LPAR Profile Use the rmsyscfg command to remove a partition profile. Type the following: rmsyscfg -r prof -m -n -p The partition ID can be specified instead of the partition name by using the --id parameter in place of the -p parameter. Creating a System Profile Use the mksyscfg command to create a system profile. In the following example, the user is making a system profile named sysprof1, with partition profile prof1 for partition lpar1 and partition profile prof1 for partition lpar2. mksyscfg -r sysprof -m i "name=sysprof1,\"lpar_names=lpar1,lpar2\", \"profile_names=prof1,prof1\""

Partition IDs can be specified instead of partition names when creating a system profile. This is done by using the lpar_ids attribute instead of the lpar_names attribute. Instead of entering configuration information on the command line with the-i flag, the information can instead be placed in a file, and the filename specified with the -f flag. Activating a System Profile Use the chsysstate command to activate a system profile. Type the following: chsysstate -r sysprof -m -o on -n Validating a System Profile Use the chsysstate command to validate a system profile. Type the following: chsysstate -r sysprof -m -n - -test To validate a system profile, then activate that system profile if the validation is successful, type the following: chsysstate -r sysprof -m -o on -n - -test Deleting a System Profile Use the rmsyscfg command to remove a system profile. Type the following: rmsyscfg -r sysprof -m -n Listing System Profile Properties Use the lssyscfg command to list a system profiles properties. Type the following: lssyscfg -r sysprof -m --filter "profile_names=" To list all system profiles for the managed system, type the following:lssyscfg -r sysprof -m Modifying System Profile Properties Use the chsyscfg command to modify system profile properties. In the following example, the user is adding profiles prof1 for partition lpar3 and prof2 for partition lpar4 to system profile sysprof1: chsyscfg -r sysprof -m -i "name=sysprof1,\"lpar_names+=lpar3,lpar4\",\"profile_names+=prof1,prof2\"" Valid attributes, specified with the i flag, include: new_name profile_names lpar_names lpar_ids name Instead of entering configuration information on the command line with the-i flag, the information can instead be placed in a file, and the filename specified with the -f flag. For more information about the valid attributes listed in this command example, refer to the Command Attributes table. The lshwres command, which lists the hardware resources of a managed system, can be used to display I/O, virtual I/O, processor, and memory resources. Listing I/O Resources for a Managed System Use the following commands to list: I/O units on the managed systemlshwres -m -r io --rsubtype unit I/O buses on the managed systemlshwres -m -r io --rsubtype bus I/O slots on the managed systemlshwres -m -r io --rsubtype slot All partitions participating in an I/O pool and all slots assigned to an I/O poollshwres -m -r io --rsubtype iopool Tagged I/O for i5/OS (OS/400) partitionslshwres -m -r io --rsubtype taggedio Listing Processor Resources Use the following commands to list processor information for: The managed systemlshwres -m -r proc --level sys

 Partitionslshwres -m -r proc --level lpar The shared poollshwres -m -r proc --level pool Listing Virtual I/O Resources for a Managed System Use the following commands to list: Virtual Ethernet adapterslshwres -m -r virtualio --rsubtype eth --level lpar System level virtual Ethernet informationlshwres -m -r virtualio --rsubtype eth --level sys Virtual OptiConnect pool informationlshwres -m -r virtualio --rsubtype virtualopti --level lpar HSL OptiConnect pool informationlshwres -m -r virtualio --rsubtype hslopti --level lpar Virtual serial adapterslshwres -m -r virtualio --rsubtype serial --level lpar Virtual serial servers with open connectionslshwres -m -r virtualio --rsubtype serial --level openserial Virtual SCSI adapterslshwres -m -r virtualio --rsubtype scsi --level lpar Partition-level virtual slot informationlshwres -m -r virtualio --rsubtype slot --level lpar Virtual slot informationlshwres -m -r virtualio --rsubtype slot --level slot Listing Memory Resources Use the following commands to list: Memory information for a managed systemlshwres -m -r mem --level sys Memory information for partitionslshwres -m -r mem --level lpar Entering a Capacity on Demand Code To enter an CoD code: chcod -o e -m -k Activating an Amount of On/Off CoD Resources To activate an amount of On/Off CoD memory for a certain number of days: chcod -m -o a -c onoff -r mem -q -d Changing the Number of Utility CoD Processors To decrease the number of Activated Utility CoD processors: chcod -m -o a -c utility -r proc -q Deactivating all On/Off CoD Processors To deactivate all On/Off CoD processors: chcod -m -o d -c onoff -r proc Deactivating all On/Off CoD Resources To deactivate all On/Off CoD resources: chcod -m -o d -c onoff -r mem Setting a Utility CoD Processor Minute Usage Limit To set a Utility CoD processor minute usage limit:: chcod -m -o s -c utility -r proc -l Activating Capacity on Demand (CoD) Advanced Functions CoD advanced functions include Advanced POWER Virtualization and Endterprise Enablement. CoD advanced functions are sometimes referred to as Virtualization Engine systems technologies. To enter an activation code: chvet -m -o e -k Displaying Activation Code Generation Information To display activation code generation information: lsvet -m -t code Displaying the Activation History Log

To display activation history log: lsvet -m -t his