| -r | The type of reference codes to list. Valid values are sys for managed system reference codes, and lpar for partition reference codes. |
| -m | The name of the managed system which has the reference codes to list. 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. |
| -s |
When listing managed system reference codes, use this option to specify the service processor for which reference codes are to be listed. Valid values are p for the primary service processor and s for the secondary service processor. If this option is not specified, reference codes for the primary service processor will be listed.
This option is only valid when listing managed system reference codes. |
| -n |
The number of reference codes to list, starting with the current reference code, for the managed-system or for each partition. Reference codes are listed in order, with the most recent (current) reference code first.
The number specified must be greater than 0. If there are fewer reference codes available than number, only the available reference codes will be listed. If this option is omitted, only the current reference code will be listed. |
| --filter |
The filter to apply to the partition reference codes to be listed. A filter is used to select the partitions for which reference codes are to be listed. If no filter is specified, then reference codes for all partitions in the managed-system 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,...<LF> Note that certain filters accept a comma separated list of values, as follows: filter-name=value,value,... ,...<LF> 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. Valid filter names for this command are lpar_names or lpar_ids. Only one of these filters may be specified. Multiple partitions can be specified with the filter. This option is not valid when listing managed system reference codes. |
| -F |
A delimiter separated list of attribute names for the desired attribute values to be displayed for each reference code. If no attribute names are specified, then values for all of the reference code 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. |
| --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. |
lsrefcode -r sys -m system1
List the last 10 reference codes for the managed system, and only display attribute values for each reference code, following a header of attribute names:
lsrefcode -r sys -m 9406-570*1543901A -n 10 -F --header
List the last 5 reference codes for the secondary service processor on the managed system:
lsrefcode -r sys -m system1 -s s -n 5
List the current reference code for each partition in the managed system, and only list the partition name, time stamp, and reference code value for each reference code, and separate the output values with a comma:
lsrefcode -r lpar -m system1 -F lpar_name,time_stamp,
refcode
List the last 25 reference codes for partitions p1 and p2:
lsrefcode -r lpar -m 9406-520*12345678 -n 25 --filter
""lpar_names=p1,p2""
| None | |
| None | |
| Linux | LSREFCODE (1) | February 2006 |