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   Process              Process
Number    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   Process              Process
Number    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   Process              Process
Number    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   Process              Process
Number    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   Process Description   Process Status
Number
--------  -------------------   -------------------------------------
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   Process Description   Process Status
Number
-------   -------------------   ------------------------
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  Process           Process
Number   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   Process          Process
Number    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).

Field descriptions

Process Number
Specifies the number that is assigned to the active background 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.