lsproc

Displays a list of long-running processes that are not yet complete and their attributes.

Read syntax diagramSkip visual syntax diagram
>>-lsproc--+--------+--+-----------------------------+---------->
           +- -?----+  |        .-default----------. |
           +- -h----+  '- -fmt--+-delim--character-+-'
           '- -help-'           '-xml--------------'

>--+--------------+--+----------------+--+-------------+-------->
   |      .-off-. |  |        .-on--. |  '- -r--number-'
   '- -p--+-on--+-'  '- -hdr--+-off-+-'

>--+--------------+--+-----+--+----------------------+---------><
   |      .-off-. |  +- -l-+  '- -name--process_name-'
   '- -v--+-on--+-'  '- -s-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–fmt
Specifies the format of the output. You can specify one of the following values:
default
Specifies to display output in a tabular format using spaces as the delimiter between the columns. This is the default value. For example:
ID   Name            Started
===============================================
5    CHECKMETADATA   Feb 11, 2003 9:29:56:13 PM
delim character
Specifies to display output in a tabular format using the specified character to separate the columns. If you use a shell metacharacter (for example, * or \t) as the delimiting character, enclose the character in single quotation mark (') or double quotation mark ("). A blank space is not a valid character. For example, lsproc -fmt delim ',' would display output in the following format:
5,CHECKMETADATA,Feb 11, 2003 9:29:56:13 PM
xml
Specifies to display output using XML format, for example:
<IRETURNVALUE>
<INSTANCE CLASSNAME="STC_AdminProcesses">
<PROPERTY NAME="Id" TYPE="uint64"><VALUE TYPE="uint64">5</VALUE>
</PROPERTY>
<PROPERTY NAME="Command" TYPE="string"><VALUE TYPE="uint32">STOPSERVER
</VALUE></PROPERTY>
<PROPERTY NAME="InstallDate" TYPE="datetime"><VALUE TYPE="datetime">
20030211092956&#46;000000&#45;420</VALUE></PROPERTY>
</INSTANCE>
</IRETURNVALUE>
–p
Specifies whether to display one page of text at a time or all text at once.
off
Displays all text at one time. This is the default value when the sfscli command is run in single-shot mode.
on
Displays one page of text at time. Pressing any key displays the next page. This is the default value when the sfscli command is run in interactive mode.
–hdr
Specifies whether to display the table header.
on
Displays the table header. This is the default value.
off
Does not display the table header.
–r number
Specifies the number of rows per page to display when the –p parameter is on. The default is 24 rows. You can specify a value from 1 to 100.
–v
Specifies whether to enable verbose mode.
off
Disables verbose mode. This is the default value.
on
Enables verbose mode.
–l
Displays additional information about the processes.
–s
Displays only the identifier of each process.
–name process_name
Specifies the name of a process to list.

Prerequisites

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

If you do not specify a listing parameter or if you specify the –l listing parameter, this command displays the following information for each process:
  • Identifier of the process.
  • Name of the process.
  • Time that the process was started.

Example

Lists long-running processes The following example lists the long-running processes currently in progress:
sfscli> lsproc

ID   Name            Started
===============================================
5    CHECKMETADATA   Feb 11, 2003 9:29:56:13 PM
7    STOPCLUSTER     Feb 10, 2003 9:30:20:24 PM
9    STARTSERVER     Feb 10, 2003 9:12:22:24 PM

Parent topic: Administrative commands

Related tasks
Listing processes
Viewing process details
Viewing process limits

Library | Support | Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.
IBM TotalStorage SAN File System v2.2