QUERY PROCESS (Query one or more server processes)

Use this command to display information about active background processes.

To cancel background processes, issue the CANCEL PROCESS command. To display detailed information about node replication processes, issue the QUERY REPLICATION command.

Privilege class

Any administrator can issue this command.

Syntax

Read syntax diagramSkip visual syntax diagramQuery PRocessprocess_number DESCription=stringSTATus=string

Parameters

process_number
Specifies the number of the background process to be queried. This parameter is optional. If not specified, information about all background processes is displayed.
DESCription
Specifies a text string that you want to search for in the list of active processes' descriptions. Enclose the string expression in quotation marks if it contains blanks. You can use text and a wildcard character to specify this string. This parameter is optional.
STATus
Specifies a text string that you want to search for in the list of active processes' statuses. Enclose the string expression in quotation marks if it contains blanks. You can use text and a wildcard character to specify this string. This parameter is optional.

Example: Query a single background process

Display information about background process 202. See Field descriptions for field descriptions.
query process 202

Process   Job  Process          Process
Number    ID   Description      Status
-------   ---  --------------   ----------------------------------------
     202       EXPORT SERVER   ANR0NNNI EXPORT
                               Identifier MYEXPORTSERVER
                               ANR0648I Have copied the
                               following: 8 Domains 2
                               Policy Sets 10 Management
                               Classes 4 Copy Groups 1
                               Administrators 746 Bytes
                               (0 errors have been
                               detected) Current input
                               volume(s): C:\BUILD\540\
                               GA\BUILD\NT\I386\DEBUG\
                               -00000014.BFS,(6 Seconds)

Example: Query all background processes

Display information about all background processes. See Field descriptions for field descriptions.
query process

Process   Job  Process               Process
Number    ID   Description           Status
-------   ---  --------------        ----------------------------------------
     304       IDENTIFY DUPLICATES  Storage Pool
                                    FILEPOOL, Volume
                                    /tsmpool2/00006664.
                                    BFS, Files Processed:
                                    2000, Duplicate Extents
                                    Found: 344, Duplicate
                                    Bytes Found: 3,238,123,
                                    Current Physical File
                                    (bytes): 2,626,676,296.
                                    Status: Processing

     284      IDENTIFY DUPLICATES   Storage Pool
                                    FILEPOOL, Volume
                                    /tsmpool2/00006666.
                                    BFS, Files Processed:
                                    2000, Duplicate Extents
                                    Found: 344, Duplicate
                                    Bytes Found: 3,238,123,
                                    Current Physical File
                                    (bytes): None.
                                    Status: Idle

       4     Replicate Node         Replicating Node(s) IRONMAN. 
                                    File spaces complete: 0. File
                                    spaces identifying and
                                    replicating: 1. File spaces
                                    replicating: 0. File spaces
                                    not started: 3. Files current:
                                    11,920. Files replicated: 0
                                    of 0. Files updated: 0 of 0.
                                    Files deleted: 0 of 0. Amount
                                    Replicated: 11,482 KB of 11,482
                                    KB. Amount transferred: 11,482 KB.
                                    Elapsed time: 0 Day(s), 0 Hour(s),
                                    1 Minute(s).

      37    Expiration              Processed 12 nodes out of 30 total
                                    nodes, examined 411 objects,  
                                    deleting 411 backup objects,
                                    0 archive objects,
                                    0 DB backup volumes,
                                    0 recovery plan files;
                                    0 objects have been retried and
                                    0 errors encountered.

Example: Query all background replication processes

Display information about all background replication processes. See Field descriptions for field descriptions.
query process desc="replicate node"

Process   Job  Process          Process
Number    ID   Description      Status
-------   ---  --------------   ----------------------------------------
       4       Replicate Node   Replicating Node(s) IRONMAN. 
                                File spaces complete: 0. File
                                spaces identifying and
                                replicating: 1. File spaces
                                replicating: 0. File spaces
                                not started: 3. Files current:
                                11,920. Files replicated: 0
                                of 0. Files updated: 0 of 0.
                                Files deleted: 0 of 0. Amount
                                Replicated: 11,482 KB of 11,482
                                KB. Amount transferred: 11,482 KB.
                                Elapsed time: 0 Day(s), 0 Hour(s),
                                1 Minute(s).

Example: Query all background replication processes for a specific node

Display information about all background replication processes. See Field descriptions for field descriptions.
query process desc="replicate node" status=ironman

Process   Job  Process          Process
Number    ID   Description      Status
-------   ---  --------------   ----------------------------------------
       4       Replicate Node   Replicating Node(s) IRONMAN. 
                                File spaces complete: 0. File
                                spaces identifying and
                                replicating: 1. File spaces
                                replicating: 0. File spaces
                                not started: 3. Files current:
                                11,920. Files replicated: 0
                                of 0. Files updated: 0 of 0.
                                Files deleted: 0 of 0. Amount
                                Replicated: 11,482 KB of 11,482
                                KB. Amount transferred: 11,482 KB.
                                Elapsed time: 0 Day(s), 0 Hour(s),
                                1 Minute(s).

Example: Verify that a replication recovery process was initiated

After you start a node replication process with file recovery enabled, verify that the target replication server initiated the file recovery process. Issue the QUERY PROCESS command on the target replication server. For descriptions of fields, see Field descriptions.
query process

Process   Job  Process          Process
Number    ID   Description      Status
-------   ---  --------------   ----------------------------------------
4              Replicate Node - Replicating node(s) 3MAUTOIMPORT.
               Recovery.        File spaces complete: 87.
                                File spaces identifying and
                                replicating: 0.
                                File spaces replicating: 6.
                                File spaces not started: 0.
                                Files current: 0.
                                Files replicated: 0 of 14.
                                Files updated: 0 of 0.
                                Files deleted: 0 of 0.
                                Amount replicated: 
                                0 KB of 11,688 bytes.
                                Amount transferred: 0 KB. 
                                Elapsed time:
                                0 Day(s), 0 Hour(s), 1 Minute(s).

Example: Verify that damaged files are being recovered during a replication process

After you start a node replication process with file recovery enabled, verify that damaged files are being recovered. Issue the QUERY PROCESS command on the source replication server. For descriptions of fields, see Field descriptions.
query process

Process   Job  Process            Process
Number    ID   Description        Status
-------   ---  --------------     ----------------------------------------
6              Replicate Node     Recovering damaged files
               (As Secondary      from server SERVER2,
                Recovery)         process 4, number of
                                  active sessions 10.

Example: Verify that the files are being converted

After you start a storage pool conversion process, verify that the files are being converted. For descriptions of fields, see Field descriptions.
query process

Process   Job  Process            Process
Number    ID   Description        Status
-------   ---  --------------     ----------------------------------------
6              Convert Stgpool    Converting storage pool FILEPOOL1
                                  to directory-container storage pool
                                  NEWDEDUP1. Volumes Converted: 1 of 6,
                                  Volumes Failed: 0,
                                  Converted Files: 975, Converted
                                  Bytes: 196.27 MB, Skipped Files: 0,
                                  Skipped Bytes: 0 B, Total Bytes
                                  Transferred: 151.27 MB

7             Convert Stgpool     Converting storage pool DEDUPPOOL to
                                  directory-container storage pool
                                  DIRPOOL. Converted Files:  150 of 360,
                                  Converted Bytes: 79,598 KB of 388 MB.
                                  Unconverted Files: 12. Unconverted
                                  Bytes: 27 MB. Current input volume:
                                  /fvt/srv/BK01. Elapsed time: 0 Day(s),
                                  0 Hour(s), 1 Minute(s).

8             Convert Stgpool     Converting storage pool FILEPOOL1 to
                                  directory-container storage pool
                                  NEWDEDUP1. Converted Files: 0,
                                  Converted Bytes: 0 B of 1.00 GB,
                                  Skipped Files: 0, Skipped Bytes: 0 B,
                                  Total Bytes Transferred: 0 B,
                                  Current input volume:
                                  /STORAGE/file1/00000005.BFS,
                                  Elapsed time: 0 Days, 0 Hours,
                                  1 Minutes.

10            Convert Stgpool     Converting storage pool FILEPOOL1 to
                                  directory-container storage pool
                                  NEWDEDUP1. Converted Files: 1007,
                                  Converted Bytes: 285.44 MB of 1.33 GB,
                                  Skipped Files: 0, Skipped Bytes: 0 B,
                                  Total Bytes Transferred: 196.28 MB,
                                  Current input volume:
                                  /STORAGE/file1/00000004.BFS,
                                  Elapsed time: 0 Days, 0 Hours, 1 Minutes.

Example: Verify movement from local disk to the cloud

After the data-transfer operation from the local disk to the cloud starts, verify that the data is moving. For descriptions of fields, see Field descriptions.
query process
 
Process   Job  Process            Process
Number    ID   Description        Status
-------   ---  --------------     ----------------------------------------
4              Local to Cloud     Local disk to cloud transfer for 
               Transfer           directory-container storage pool CLOUDPOOL. 
                                  1 container(s) processed.
                                  2,100 KB in 4 data extent(s) transferred.
                                  Elapsed time: 0 Day(s), 0 Hour(s), 1 Minute(s).

Example: Verify that a retention set is being copied to tape storage

After you start a job to copy a retention set to tape storage, verify that the data is moving. For descriptions of fields, see Field descriptions.
query process
 
Process   Job  Process                      Process
Number    ID   Description                  Status
-------   ---  --------------               ----------------------------------------
2           1  COPY RETENTION SET (SUMMARY) Processing of storage rule L180MAN is in progress,
                                            copying retention set 1 to tape storage pool L180MAN 
                                            with the following results: copied files: 0, 
                                            files still copying: 216, 
                                            copied bytes: 0 bytes, 
                                            bytes still copying: 63,597 KB, skipped files: 0, 
                                            total transferred bytes: 0 bytes,
                                            elapsed time: 0 Days, 0 Hours, 1 Minutes.

Process   Job  Process                      Process
Number    ID   Description                  Status
-------   ---  --------------               ----------------------------------------
2           1  Copy Retention Set (Worker)  Processing of storage rule L180MAN is in progress,
                                            copying retention set 1 to tape storage pool L180MAN 
                                            with the following results: copied files: 0, 
                                            files still copying: 216, 
                                            copied bytes: 0 bytes,  
                                            bytes still copying: 63,597 KB, skipped files: 0, 
                                            total transferred bytes: 0 bytes,
                                            elapsed time: 0 Days, 0 Hours, 1 Minutes. Waiting for
                                            mount of output volume G03038TA (7 seconds).

Field descriptions

Process Number
Specifies the number that is assigned to the active background process.
Job ID
The unique numeric ID of the job that is associated with the process.
Process Description
Specifies a description of the active background process.
Process Status
Specifies the status of the active background process.
Tip: When a node replication process is finished on the target replication server, only end process information is stored in the activity summary table. The full summary for the replication process is stored in the activity summary table on the source replication server.

Related commands

Table 1. Command related to QUERY PROCESS
Command Description
CANCEL EXPORT Deletes a suspended export operation.
CANCEL PROCESS Cancels a background server process.
IDENTIFY DUPLICATES Identifies duplicate data in a storage pool.
QUERY EXPORT Displays the export operations that are currently running or suspended.
QUERY REPLICATION Displays information about node replication processes.
QUERY REPLNODE Displays information about the replication status of a client node.
RESTART EXPORT Restarts a suspended export operation.
SUSPEND EXPORT Suspends a running export operation.