lspe

The lspe command is used by a DS6000 user to find previously created PE package files that are ready to send to IBM. These files were created with the mkpe command and must be sent to IBM because there was an error during the original FTP of the PE package file.


>>-lspe--+-----+--+----------------------+---------------------><
         +- -s-+  '- -state--+-ready---+-'   
         '- -l-'             +-sending-+     
                             +-copying-+     
                             '-sent----'

Parameters

Note: This command can only be initiated from the DSCLI client installed locally on the management console connected to the target storage unit.

-s

(Optional) Specifies that only the PE package file names be displayed. You cannot use the -l and the -s parameters together.

-l

(Optional) Specifies that the default output plus additional attributes that are identified as long output be displayed. You cannot use the -l and the -s parameters together.

-state ready | sending | copying | sent

(Optional) Specifies that the report display PE package files that meet the designated criteria. For example, if you specify the -state ready parameter, the report returns only those PE package file names that are ready to be sent to IBM.

Each option (ready, sending, copying, and sent) that is associated with this parameter represents a specific status that you can designate to narrow the search criteria. The lspe command uses this criteria when it searches for PE package files. The following values are associated with each option:

Ready: Specifies that the PE package file was created but not yet sent to IBM.
Sending: Specifies that the file is in the process of being transferred to IBM.
Copying: Specifies that the PE package file is in the process of being copied from either of the two storage management consoles.
Sent: Specifies that the PE package file has been transferred to IBM.

Example

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

Invoking the lspe command

dscli>lspe -l  
-state ready

The resulting output

Date/Time: Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS:

PE Package	State	Date	Size (KB)
175051113 AB15A.IBM. 0.NOPMH. 200503282 23544. cl0.pe.zip	Ready	10/23/2005 00:00:00 PST	800
1750511SMC 0000.tucson. 000.NOPMH. 20051023000 000.cl0. SMCLog.zip	Ready	10/23/2005 00:00:10 PST	300

Report field definitions

PE Package: Specifies the name of the PE package file.
State: Specifies the status associated with the PE package file.
Date: Specifies the last modified timestamp of the designated PE package file.
Size (KB): Specifies the size of the designated PE package file.