subscribe iconSubscribe to this information
POWER7 information

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
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 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
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
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
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
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
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
Monitor 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    


Send feedback Rate this page

Last updated: Tue, June 17, 2014