HMC tasks, user roles, IDs, and associated commands

The roles discussed in this section refer to HMC users; operating systems running on logical partitions has its own set of users and roles.

Each HMC user has an associated task role and a resource role. The task role defines the operations the user can perform. The resource role defines the systems and partitions for performing the tasks. The users may share task or resource roles. The HMC is installed with five predefined task roles. The single predefined resource role allows access to all resources. The operator can add customized task roles, customized resource roles, and customized user IDs.

Some tasks have an associated command. For more information about accessing the HMC command line, see Using the HMC remote command line.

Some tasks can only be performed using the command line. For a listing of those tasks, see Table 7.

For more information about where to find task information, see the following table:

Table 1. HMC task groupings
HMC tasks and the corresponding user roles, IDs, and commands	Associated table
HMC Management	Table 2
Service Management	Table 3
Systems Management	Table 4
Frame Management	Table 5
Control Panel Functions	Table 6

This table describes the HMC management tasks, commands, and default user roles associated with each HMC Management task.

Table 2. HMC Management tasks, commands, and default user roles
HMC Interface Tasks and Associated Commands	User roles and IDs
HMC Interface Tasks and Associated Commands	Operator (hmcoperator)	Super Administrator (hmcsuperadmin)	Viewer (hmcviewer)	Service Representative (hmcservicerep)
Back up HMC Data Back up HMC Data bkconsdata	X	X		X
Change Date and Time Change Date and Time chhmc lshmc	X	X		X
Change Language and Locale Change Language and Locale chhmc lshmc	X	X	X	X
Change Network Settings Change Network Settings chhmc lshmc	X	X		X
Change User Interface Settings Change User Interface Settings	X	X	X	X
Change User Password Change User Password chhmcusr	X	X	X	X
Configure KDC KDC Configuration chhmc lshmc getfile rmfile		X
Configure LDAP Configuring the HMC so that it uses LDAP authentication lshmcldap chhmcldap		X
Create Welcome Text Create Welcome Text chusrtca lsusrtca	X	X
Launch Guided Setup Wizard Launch Guided Setup Wizard		X
Launch Remote Hardware Management Console	X	X	X	X
Lock HMC Screen Lock HMC Screen	X	X	X	X
Logoff or Disconnect	X	X	X	X
Manage Certificates Manage Certificates		X
Manage Data Replication Manage Data Replication	X	X
Manage Install Resources Managing Install Resources	X	X
Manage Task and Resource Roles Manage Task and Resource Roles chaccfg lsaccfg mkaccfg rmaccfg		X
Manage User Profiles and Access Manage User Profiles and Access chhmcusr lshmcusr mkhmcusr rmhmcusr		X
Manage Users and Tasks Manage Users and Tasks lslogon termtask	X	X	X	X
Open 5250 Console	X	X		X
Open Restricted Shell Terminal Open Restricted Shell Terminal	X	X	X	X
Remote Command Execution Remote Command Execution chhmc lshmc	X	X		X
Remote Operation Remote operations chhmc lshmc	X	X	X	X
Remote Virtual Terminal Remote Virtual Terminal	X	X		X
Restore HMC Data Restore HMC Data	X	X		X
Save Upgrade Data Save Upgrade Data saveupgdata	X	X		X
Schedule Operations Schedule Operations	X	X
Shut Down or Restart Shut Down or Restart hmcshutdown	X	X		X
Test Network Connectivity Test Network Connectivity ping	X	X	X	X
Tip of the Day Tip of the Day	X	X	X	X
View HMC Events View HMC Events lssvcevents	X	X		X
View Licenses View Licenses	X	X	X	X
View Network Topology View Network Topology	X	X	X	X
Change Default User Interface Settings	X	X	X	X

This table describes the Service Management tasks, commands, and default user roles.

Table 3. Service Management tasks, commands, and default user roles
HMC Interface Tasks and Associated Commands	User roles and IDs
HMC Interface Tasks and Associated Commands	Operator (hmcoperator)	Super Administrator (hmcsuperadmin)	Viewer (hmcviewer)	Service Representative (hmcservicerep)
Create Serviceable Event Create Serviceable Event		X		X
Manage Serviceable Events Manage Serviceable Events chsvcevent lssvcevents		X		X
Manage Remote Connections Manage Remote Connections	X	X		X
Manage Remote Support Requests Manage Remote Support Requests	X	X	X	X
Format Media Format Media	X	X		X
Manage Dumps Manage Dumps dump cpdump getdump lsdump startdump lsfru	X	X		X
Transmit Service Information Transmit Service Information chsacfg lssacfg	X	X
Enable Electronic Service Agent Manage Systems Call-Home	X	X		X
Manage Outbound Connectivity Manage Outbound Connectivity	X	X		X
Manage Inbound Connectivity Manage Inbound Connectivity	X	X		X
Manage Customer Information Manage Customer Information	X	X		X
Authorize User Authorize User		X
Manage Serviceable Event Notification Manage Serviceable Event Notification chsacfg lssacfg	X	X		X
Manage Connection Monitoring Manage Connection Monitoring	X	X	X	X
Electronic Service Agent Setup Wizard Call-Home Setup Wizard		X		X

This table describes the Systems Management tasks, commands, and default user roles.

Table 4. Systems Management tasks, commands, and default user roles
HMC Interface Tasks and Associated Commands	User roles/IDs
HMC Interface Tasks and Associated Commands	Operator (hmcoperator)	Super Administrator (hmcsuperadmin)	Viewer (hmcviewer)	Service Representative (hmcservicerep)
Managed System Properties Properties lshwres	X	X	X	X
lsled	X	X	X	X
lslparmigr	X	X	X	X
lssyscfg	X	X	X	X
chhwres	X	X	X	X
chsyscfg	X	X	X	X
migrlpar	X	X	X	X
optmem	X	X		X
lsmemopt	X	X	X	X
Update Password Update Password chsyspwd		X
Change Default Profile Change Default Profile chsyscfg lssyscfg	X	X
Change Default User Interface Settings	X	X	X	X
Operations
Power On Power On chsysstate	X	X		X
Power Off Power Off chsysstate	X	X		X
Activate: Profile Activate chsysstate	X	X		X
Activate: Current Configuration Activate chsysstate	X	X		X
Restart Restart chsysstate	X	X		X
chlparstate	X	X		X
Shut Down Shut Down chsysstate	X	X		X
chlparstate	X	X		X
Suspend Operations Suspend operations chlparstate	X	X
LED Status: Deactivate Attention LED Manage Attention LED chled	X	X
LED Status: Identify LED Manage Attention LED	X	X	X	X
LED Status: Test LED Manage Attention LED	X	X	X	X
Schedule Operations Schedule Operations	X	X
Launch Advanced System Management (ASM) Advanced System Management asmmenu	X	X		X
Utilization Data: Change Sampling Rate Utilization Data chlparutil lslparutil	X	X		X
Utilization Data: View Utilization Data lslparutil	X	X	X	X
Rebuild Rebuild chsysstate	X	X
Change Password Change Password chsyspwd		X
Power Management Power Management chpwrmgmt lspwrmgmt		X
Perform VIOS Command viosvrcmd viosvrcmd	X	X		X
Delete Delete rmsyscfg	X	X		X
Mobility: Migrate Migrate lslparmigr migrlpar	X	X		X
Mobility: Validate Validate lslparmigr migrlpar	X	X		X
Mobility: Recover Recover lslparmigr migrlpar	X	X		X
Manage profiles Manage Profiles chsyscfg lssyscfg mksyscfg rmsyscfg chsysstate	X	X		X
Launch OS Management Operations	X	X	X	X
Configuration
Create Logical Partition: AIX or Linux Create Logical Partition mksyscfg	X	X
Create Logical Partition: VIO Server Create Logical Partition mksyscfg	X	X
Create Logical Partition: IBM i Create Logical Partition mksyscfg	X	X
System Plans: Create System Plans mksysplan		X
System Plans: Deploy System Plans deploysysplan		X
System Plans: Import System Plans cpsysplan		X
System Plans: Export System Plans cpsysplan		X
System Plans: Remove System Plans rmsysplan		X
System Plans: View System Plans		X
Manage Custom Groups Manage Custom Groups	X	X		X
View Workload Management Groups View Workload Management Groups lshwres lssyscfg	X	X	X	X
Partition Availability Priority Partition Availability Priority chsyscfg lssyscfg mksyscfg	X	X
Manage System Profiles Manage System Profiles chsyscfg chsysstate lssyscfg mksyscfg rmsyscfg	X	X	X	X
Manage Partition Data: Restore Manage Partition Data rstprofdata	X	X
Manage Partition Data: Initialize Manage Partition Data rstprofdata	X	X
Manage Partition Data: Backup Manage Partition Data bkprofdata	X	X		X
Recover Partition Data chsysstate rstprofdata	X	X		X
Manage Partition Data: Delete Manage Partition Data rmprofdata	X	X
Save Current Configuration Save Current Configuration mksyscfg	X	X
Virtual Resources: Shared Processor Pool Management Shared processor pool management chhwres lshwres		X
Virtual Resources: Shared Memory Pool Management Shared Memory Pool Management lshwres lsmemdev chhwres		X
Virtual Resources: Virtual Storage Management Virtual Storage Management		X
Virtual Resources: Virtual Network Management Virtual Network Management		X
Connections
Service Processor Status Connections lssysconn	X	X	X	X
Reset or Remove Connections Connections rmsysconn	X	X
Disconnect Another HMC Connections		X
Add Managed System Connections mksysconn	X	X
Hardware (Information)
Adapters: Host Channel Host Channel Adapter (HCA) lshwres	X	X	X	X
Adapters: Host Ethernet Host Ethernet Adapter (HEA) chhwres lshwres	X	X	X	X
Adapters: Switch Network Interface Switch Network Interface lshwres	X	X	X	X
View Hardware Topology View Hardware Topology	X	X	X	X
Virtual I/O Adapters: SCSI Virtual IO Adapters lshwres	X	X	X	X
Virtual I/O Adapters: Ethernet Virtual IO Adapters lshwres	X	X	X	X
Dynamic Logical Partitioning
Processor Processor chhwres lshwres	X	X		X
Memory Memory chhwres lshwres	X	X		X
Physical Adapters Physical Adapters chhwres lshwres	X	X		X
Virtual Adapter Virtual Adapter chhwres lshwres	X	X		X
Host Ethernet Host Ethernet chhwres lshwres	X	X		X
Updates
Change Licensed Internal Code for the current release Change Licensed Internal Code for the current release lslic updlic		X		X
Upgrade Licensed Internal Code to a new release Upgrade Licensed Internal Code to a new release lslic updlic		X		X
Check system readiness Check system readiness updlic		X		X
View system information View system information lslic		X		X
Update HMC updhmc lshmc		X		X
Console Window
Open Terminal Window Open Restricted Shell Terminal mkvterm	X	X		X
Close Terminal Connection rmvterm	X	X		X
Open Shared 5250 Console	X	X		X
Open Dedicated 5250 Console	X	X		X
Serviceability
Manage Serviceable Events Manage Serviceable Events chsvcevent lssvcevents		X		X
Create Serviceable Event Create Serviceable Event		X		X
Reference Code History Reference Code History lsrefcode	X	X	X	X
Control Panel Functions: (20) Type, Model, Feature Control Panel Functions lssyscfg	X	X
Hardware: Add FRU Add FRU		X		X
Hardware: Add Enclosure Add Enclosure		X		X
Hardware: Exchange FRU Exchange FRU		X		X
Hardware: Remove FRU Remove FRU		X		X
Hardware: Remove Enclosure Remove Enclosure		X		X
Hardware: Power On/Off Unit Power On/Off IO Unit		X		X
Manage Dumps Manage Dumps dump cpdump getdump lsdump startdump lsfru	X	X		X
Collect VPD Collect VPD	X	X	X	X
Edit MTMS Edit MTMS		X
FSP Failover: Setup FSP Failover chsyscfg lssyscfg		X
FSP Failover: Initiate FSP Failover chsysstate		X
Capacity on Demand (CoD)
Enter CoD code Capacity on Demand chcod		X
View History Log Capacity on Demand lscod	X	X	X	X
Processor: View Capacity Settings Capacity on Demand lscod	X	X	X	X
Processor CUoD: View Code Information Capacity on Demand lscod	X	X	X	X
Processor: On/Off CoD: Manage Capacity on Demand chcod		X
Processor: On/Off CoD: View Capacity Settings Capacity on Demand lscod	X	X	X	X
Processor: On/Off CoD: View Billing Information Capacity on Demand lscod	X	X	X	X
Processor: On/Off CoD: View Code Information Capacity on Demand lscod	X	X	X	X
Processor: Trial CoD: Stop Capacity on Demand chcod		X
Processor: Trial CoD: View Capacity Settings Capacity on Demand lscod	X	X	X	X
Processor: Trial CoD: View Code Information Capacity on Demand lscod	X	X	X	X
Processor: Reserve CoD: Manage Capacity on Demand chcod		X
Processor: Reserve CoD: View Capacity Settings Capacity on Demand lscod	X	X	X	X
Processor: Reserve CoD: View Code Information Capacity on Demand lscod	X	X	X	X
Processor: Reserve CoD: View Shared Processor Utilization Capacity on Demand lscod	X		X	X
PowerVM® (formerly known as Advanced POWER® Virtualization): Enter Activation Code Capacity on Demand chcod		X
PowerVM: View History Log Capacity on Demand lscod	X	X	X	X
PowerVM: View Code Information Capacity on Demand lscod	X	X	X	X
Enterprise Enablement: Enter Activation Code Capacity on Demand chcod		X
Enterprise Enablement: View History Log Capacity on Demand lscod	X	X	X	X
Enterprise Enablement: View Code Information Capacity on Demand lscod	X	X	X	X
Other Advanced Functions: Enter Activation Code Capacity on Demand chcod		X
Other Advanced Functions: View History Log Capacity on Demand lscod	X	X	X	X
Other Advanced Functions: View Code Information Capacity on Demand lscod	X	X	X	X
Processor: Manage Capacity on Demand chcod		X
Processor: View Capacity Settings Capacity on Demand lscod	X	X	X	X
Processor: View Code Information Capacity on Demand lscod	X	X	X	X
Memory: Manage Capacity on Demand chcod		X
Memory: View Capacity Settings Capacity on Demand lscod	X	X	X	X
Memory: View Code Information Capacity on Demand lscod	X	X	X	X

This table describes the Frame Management tasks, commands, and default user roles.

Table 5. Frame management tasks, commands, and user roles
HMC Interface Tasks and Associated Commands	User roles/IDs
HMC Interface Tasks and Associated Commands	Operator (hmcoperator)	Super Administrator (hmcsuperadmin)	Viewer (hmcviewer)	Service Representative (hmcservicerep)
Properties Properties chsyscfg lssyscfg	X	X	X	X
Initialize Frame(s) Initialize Frames	X	X		X
Initialize All Frames Initialize All Frames	X	X		X
Power off unowned I/O drawers chsysstate	X	X		X
Launch Frame Advanced System Management (ASM) asmmenu	X	X	X	X
Bulk Power Assembly (BPA) Status Bulk Power Assembly (BPA) Status lssysconn	X	X	X	X
Reset Reset rmsysconn	X	X
View VLAN Network Data	X	X	X	X
Serviceability
Hardware: Fill and Drain Tool Tasks: Fill and Drain Tool Fill		X		X
Hardware: Fill and Drain Tool Tasks: Fill and Drain Tool Drain		X		X
Hardware: Fill and Drain Tool Tasks: Fill and Drain Tool Fill Node		X		X
Hardware: Fill and Drain Tool Tasks: Fill and Drain Tool Fill Initial System Fill		X		X
Hardware: Fill and Drain Tool Tasks: Fill and Drain Tool Fill System Top Off		X		X

This table describes the Control Panel Functions tasks, commands, and default user roles.

Table 6. Control Panel Functions tasks, commands, and user roles
HMC Interface Tasks and Associated Commands	User roles/IDs
HMC Interface Tasks and Associated Commands	Operator (hmcoperator)	Super Administrator (hmcsuperadmin)	Viewer (hmcviewer)	Service Representative (hmcservicerep)
Serviceability
(21) Activate Dedicated Service Tools Control Panel Functions chsysstate	X	X
(65) Disable Remote Service Control Panel Functions chsysstate	X	X
(66) Enable Remote Service Control Panel Functions chsysstate	X	X
(67) DIsk Unit IOP Reset / Reload Control Panel Functions chsysstate	X	X
(68) Concurrent Maintenance Power Off Domain Control Panel Functions	X	X
(69) Concurrent Maintenance Power On Domain Control Panel Functions	X	X
(70) IOP Control Storage Dump Control Panel Functions chsysstate	X	X

This table describes the commands that are not associated with an HMC UI task, and defines the default user roles that can perform each command.

Table 7. Command line tasks, associated commands, and user roles
Command line tasks	User roles/IDs
Command line tasks	Operator (hmcoperator)	Super Administrator (hmcsuperadmin)	Viewer (hmcviewer)	Service Representative (hmcservicerep)
Change which encryption is used by the HMC to encrypt the passwords of locally authenticated HMC users, or change which encryptions can be used by the HMC Web UI. chhmcencr		X
List which encryption is used by the HMC to encrypt the passwords of locally authenticated HMC users, or list which encryptions can be used by the HMC Web UI chhmcfs	X	X	X
Free up space in HMC file systems chhmcfs	X	X
List HMC file system information lshmcfs	X	X	X	X
Test for removable media readiness on the HMC ckmedia	X	X		X
Obtain required files for an HMC upgrade from a remote site getupgfiles	X	X		X
Provide screen capture on the HMC hmcwin	X	X	X	X
Log SSH command usage logssh	X	X	X	X
Clear or dump partition configuration data on a managed system lpcfgop		X
List environmental information for a managed frame, or for systems contained in a managed frame lshwinfo	X	X	X	X
List which HMC owns the lock on a managed frame lslock	X	X	X	X
Force an HMC lock on a managed frame to be released rmlock		X
List the storage media devices that are available for use on the HMC lsmediadev	X	X	X	X
Manage SSH authentication keys mkauthkeys	X	X	X	X
Monitoring HMC subsystems and system resources monhmc	X	X	X	X
Remove the utilization data collected for a managed system from the HMC rmlparutil	X	X		X
Enable users to edit a text file on the HMC in a restricted mode rnvi	X	X	X	X
Restore hardware resources after a DLPAR failure rsthwres		X
Restore upgrade data on the HMC rstupgdata	X	X		X
Transfer a file from the HMC to a remote system sendfile	X	X	X	X
chsvc	X	X		X
lssvc	X	X	X	X
chstat	X	X		X
lsstat	X	X	X	X
chpwdpolicy		X
lspwdpolicy	X	X	X	X
mkpwdpolicy		X
rmpwdpolicy		X
expdata		X

Last updated: Fri, December 06, 2019