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 diagram
>>-Query PRocess--+----------------+---------------------------><
                  '-process_number-'   

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.

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: 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. 
                                    						    

		             
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

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 Description      Process Status
Number
--------  --------------------    ----------------------------------------	
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.
		             
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systems

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 Description      Process Status
Number
--------  --------------------    ----------------------------------------	
4         Local to Cloud Transfer  Local disk to cloud transfer for 
                                   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.