lscollection

You can use the lscollection command to display a list of collections and status information for each collection in the list.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --lscollection-- --+----+--+-------------------+--->
                                +--s-+  '--devtype--+-ess-+-'
                                '--l-'              '-svc-'

>--+-----------------+-- --+---------------------------+-------->
   '--dev--device_ID-'     '--status--+-running---+-- -'
                                      +-timeout---+
                                      +-aborted---+
                                      +-canceled--+
                                      +-complete--+
                                      '-canceling-'

>--+----------------------+------------------------------------><
   '-task_name--+-------+-'
                '-[...]-'

Parameters

-s
An optional parameter that displays the device name only.
-l
An optional parameter that displays the default output and description
-devtype ess | svc
An optional parameter that displays a choice of device type. The choice can be ess or svc.
-dev device_ID
An optional parameter that displays only the nickname or model, serial number, and manufacturer of the specified device_ID.
-status running | timeout | aborted | canceled | complete
An optional parameter that sorts the collection status of a collection. The status can be running, timeout, aborted, canceled, and complete.
task_name[...]
Specifies the name of the collection task that is to be listed. Separate multiple collection tasks with a comma between each name. If no names are specified, all collection tasks are listed.

Description

You can use the lscollection command to display a list of collections and status information for each collection in the list.

Return values

Possible failures

Examples

An invocation example: The following are examples of the lscollection command for a specific device type:

perfcli> lscollection -devtype ess

The resulting output:

Name                                                           Device Type Status    Length (hrs) Frequency (min)
=================================================================================================================
ess_26884_5                                                    ESS         Completed            1               5
ess_28019_10                                                   ESS         Completed            1              10
ess28019                                                       ESS         Completed            1               5
mycollection                                                   ESS         Aborted             10              10
myveryowncollectionisthisonedontyouthinkwowthisisalongdescript ESS         Aborted             20              20
mycollection2                                                  ESS         Canceled            10              10
mycollection3                                                  ESS         Canceled            10              10
perfcli> lscollection -devtype svc

The resulting output:

Name        Device Type Status    Length (hrs) Frequency (min)
==============================================================
duc_blackn1 SVC         Aborted              1              15
duc_red1    SVC         Completed            1              15

Related topics

(C) Copyright International Business Machines Corporation 2004