NAME

lshmcusr - list Hardware Management Console user information

SYNOPSIS

lshmcusr [--script] [--filter "filter-data"] [-F [attribute-names] [--header]] [--help]

DESCRIPTION

lshmcusr lists Hardware Management Console (HMC) user information.

OPTIONS

--script
List managed resource objects in a format that can be used as input to the chhmcusr, chaccfg, and mkaccfg commands.

--filter

The filter to apply to the HMC users to be listed. A filter is used to select which HMC users are to be listed. If a filter is not used, then all HMC users 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.

Multiple values can be specified for each filter.

Valid filter names for this command:

names

Specify user name(s)

resources

Specify managed resource object(s)

resourceroles

Specify managed resource role name(s)

taskroles

Specify task role name(s)

-F

A delimiter separated list of attribute names for the desired attribute values to be displayed for each HMC user. If no attribute names are specified, then values for all of the attributes for each HMC user 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.

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

--help

Display the help text for this command and exit.

EXAMPLES

List all HMC users:

lshmcusr

List only the user names and managed resource roles for all HMC users, and separate the output values with a colon:

lshmcusr -F name:resourcerole

List the HMC users hscroot and user1:

lshmcusr --filter ""names=hscroot,user1""

List the HMC users with the task role hmcviewer and the managed resource role mr1:

lshmcusr --filter "taskroles=hmcviewer,resourceroles=mr1"

ENVIRONMENT

None

BUGS

None

SEE ALSO

chhmcusr, mkhmcusr, rmhmcusr, lsaccfg