HMC Manual Reference Pages - LSNPORTLOGIN (1)

NAME

lsnportlogin - list N_Port login information

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

lsnportlogin [-m managed-system] [-w wait-time] [-d detail-level]
--filter "filter-data" [-F [attribute-names] [--header]] [--help]

DESCRIPTION

lsnportlogin lists WWPN login status information for virtual fibre channel client adapters configured in partitions or partition profiles.

OPTIONS

-m The name of the managed system for which to list WWPN login status information. 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. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.

-w The maximum time, in minutes, to wait for each Virtual I/O Server (VIOS) command issued by the HMC to complete. If a VIOS command does not complete within the time specified, the query operation for the virtual fibre channel client adapter will be stopped.
wait-time must be a whole number. If wait-time is 0, the operation will not be timed out.
If this option is not specified, a default value of 3 minutes is used.

-d The level of detail requested from VIOS commands issued by the HMC. Valid values are 0 (none) through 5 (highest).
If this option is not specified, a default value of 1 is used.

--filter The filters to apply to the WWPN login status information to be listed. Filters are used to select the partitions or partition profiles for which WWPN login status information is to 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 ’#146; character.
Multiple values can be specified for each filter.
Valid filter names:
lpar_names | lpar_ids, profile_names

-F A delimiter separated list of attribute names for the desired attribute values to be displayed. If no attribute names are specified, then values for all of the attributes 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.
Descriptions of selected command attributes:
wwpn_status
The WWPN status. Possible values are:
0 - WWPN is not activated
1 - WWPN is activated
2 - WWPN status is unknown

--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 the WWPN login status information for partition clientPartition:
lsnportlogin -m sys --filter "lpar_names=clientPartition"
List the WWPN login status information for profile defaultProf for the partition with ID 5:
lsnportlogin -m 9117-MMB*1234567 --filter "profile_names=defaultProf,
lpar_ids=5"
List only the partition name, WWPN, and WWPN status, and separate the output values with a colon:
lsnportlogin -m sys --filter "lpar_names=clientPartition" -F
lpar_name:wwpn:wwpn_status

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

HMC Manual Reference Pages - LSNPORTLOGIN (1)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

ENVIRONMENT

BUGS

AUTHOR

SEE ALSO

-m	The name of the managed system for which to list WWPN login status information. 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. The tttt-mmm*ssssssss form must be used if there are multiple managed systems with the same user-defined name.
-w	The maximum time, in minutes, to wait for each Virtual I/O Server (VIOS) command issued by the HMC to complete. If a VIOS command does not complete within the time specified, the query operation for the virtual fibre channel client adapter will be stopped. wait-time must be a whole number. If wait-time is 0, the operation will not be timed out. If this option is not specified, a default value of 3 minutes is used.
-d	The level of detail requested from VIOS commands issued by the HMC. Valid values are 0 (none) through 5 (highest). If this option is not specified, a default value of 1 is used.
--filter	The filters to apply to the WWPN login status information to be listed. Filters are used to select the partitions or partition profiles for which WWPN login status information is to 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 ’#146; character. Multiple values can be specified for each filter. Valid filter names: lpar_names \| lpar_ids, profile_names
-F	A delimiter separated list of attribute names for the desired attribute values to be displayed. If no attribute names are specified, then values for all of the attributes 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. Descriptions of selected command attributes: wwpn_status The WWPN status. Possible values are: 0 - WWPN is not activated 1 - WWPN is activated 2 - WWPN status is unknown
--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.