QUERY EXPORT (Query for active or suspended export operations)
Use this command to list all restartable export operations. A restartable export is a server-to-server export operation whose FILEDATA value is not NONE. Only active server-to-server export operations that can be suspended are displayed.
Any EXPORT NODE or EXPORT SERVER operation with FILEDATA=NONE are not displayed. Additionally, the QUERY EXPORT command does not show export operations where the target device is either sequential media or virtual volumes.
Privilege class
An administrator can issue this command.
Syntax
.-*---------------------. >>-Query EXPort--+-----------------------+----------------------> '---export_identifier---' .-STate--=--ALl-----------. >--+-------------------------+----------------------------------> '-STate--=--+-ALl-------+-' +-RUnning---+ '-SUSpended-' >--+----------------------------+-------------------------------> '-PROCess--=--process_number-' .-Format--=--Standard-----. >--+-------------------------+--------------------------------->< '-Format--=--+-Standard-+-' '-Detailed-'
Parameters
- export_identifier
- This optional parameter is the unique string identifier for the server-to-server export operation. Wildcard characters can be used to specify this name, and all matching export operations are queried. If you do not specify a value for this parameter and you also do not specify a PROCESS identifier, then all export operations are queried.
- STate
- This optional parameter queries the state of the valid server-to-server
export operations. The default value is ALL. The possible values are:
- ALl
- Lists all running and suspended server-to-server export operations.
- RUnning
- Lists all active server-to-server export operations that are identifying eligible files or exporting files to the target server.
- SUSpended
- Lists all suspended server-to-server export operations. These suspended operations stopped running because of a failure or by the SUSPEND EXPORT command being issued.
- PROCess
- This optional parameter specifies the number of a running server-to-server export operation that you want to query. If PROCESS is specified, Tivoli® Storage Manager only displays the running server-to-server export operation associated with the process number. If PROCESS is not specified, Tivoli Storage Manager displays information on all server-to-server export operations. You cannot specify this parameter if you specify an export identifier or if you specify the STATE parameter with a value of SUSPENDED.
- Format
- This optional parameter specifies how the information is displayed.
The default value is STANDARD. Possible values are:
- Standard
- Specifies that partial information is displayed for the specified export operations.
- Detailed
- When specified, displays all available information for the export operations.
Example: Display running and suspended export operations
List information for all currently running and suspended export operations. Issue the following command:query export state=all
Export Start Time State Process Command
Identifier ID
------------- ------------ --------- --------- -----------------------------
MYEXPORTNODE 01/24/2007 Suspended -- Export NODE me,you,them
10:30:03 filespace=c$ nametype=unicode
filedata=all durunits=
indefinite toserver=athens
exportid=MYEXPORTNODE
EXPORT_HOME_ 01/25/2007 Running 11 Export NODE n2,n3,n4
DIRS 09:30:03 filespace=/home nametype=
server filedata=all durunits=
indefinite toserver=athens
exportid=EXPORT_HOME_DIRS
EXPORT_NODE_ 01/25/2007 Running Not -- Export NODE n5,n6,n7
0001 14:30:33 Suspendible filespace=d$ nametype=unicode
filedata=archive durunits=
indefinite toserver=athens
See Field descriptions for field descriptions.Example: Display information about a running export operation
List information for the currently running export operation with process number "7." Issue the following command:query export process=7
Export Start Time State Process Command
Identifier ID
____________ _________ ______ _______ _______
MYEXPORTNODE 01/24/2007 Running 7 Export NODE me,you,them
10:30:03 filespace=c$ nametype=unicode
filedata=all toserver=athens
exportid=MYEXPORTNODE
See Field descriptions for field descriptions.Example: Display detailed information about all suspended export operations
List information for all currently suspended
export operations. Issue the following command:
query export state=suspended format=detailed
Export Identifier : MyExportNode
Start Time : 01/24/2007 10:30:03
State : Suspended
Process Id : --
Command : Export NODE m* filespace=c$ nametype=unicode
filedata=all durunits=indefinite
toserver=athens
Phase : File list complete. Exporting eligible files
Total Running Time : 3 Days 0 Hours 24 Minutes
Current Process Running Time :
Export Operation Restart Count: 0
Date and Time of Last Restart : --
Date and Time of Last Suspend : 01/25/2007 08:30:11
Policy Domains Exported : 0
Policy Sets Exported : 0
Schedules Exported : 0
Mgmt Classes Exported : 0
Copy Groups Exported : 0
Administrators Exported : 1
Option Sets Exported : 0
Node Definitions Exported : 3
Filespace Definitions Exported : 7
Archive Files Exported : 50,000
Backup Files Exported : 150,000
Space Managed Files Exported : 0
Archive Files Skipped : 0
Backup Files Skipped : 25
Space Managed Files Skipped : 0
Total bytes Transferred (MB) : 7,000
Total Files to be Transferred : 900,000
Files Remaining : 700,000
See Field descriptions for field descriptions.Example: Display information for server-to-server export operations
List detailed information for all currently running server-to-server export operations. Issue the following command:query export state=running format=detailed
Export Identifier : export_HOME_Dirs
Start Time : 01/25/2007 09:30:03
State : Running
Process Id : 11
Command : Export NODE n2,n3,n4
filespace=/home nametype=
server filedata=all
toserver=athens
Phase : Identifying and exporting
eligible files
Total Running Time : 0 Days 22 Hours 0 Minutes
Current Process Running Time : 01:30:00
Export Operation Restart Count: 4
Date and Time of last Restart : 02/01/2007 11:00:03
Date and Time of last Suspend : 01/31/2007 05:01:00
Policy Domains Exported : 0
Policy Sets Exported : 0
Schedules Exported : 0
Mgmt Classes Exported : 0
Copy Groups Exported : 0
Administrators Exported : 1
Option Sets Exported : 0
Node Definitions Exported : 3
Filespace Definitions Exported : 7
Archive Files Exported : 0
Backup Files Exported : 1000
Space Managed Files Exported : 0
Archive Files Skipped : 0
Backup Files Skipped : 0
Space Managed Files Skipped : 0
Total bytes Transferred (MB) : 50
Total Files to be Transferred : 400,000
Files Remaining : 399,000
See Field descriptions for field descriptions.Field descriptions
- Export identifier
- The unique identifier assigned to this server-to-server export operation.
- Start time
- The time and date that this export operation was first initiated.
- State
- The current state of this export operation. The value is one of
the following:
- Running - Not Suspendible
- The operation is active and is transmitting definitions to the target server. The process cannot be suspended, and if the process fails while in this state, you cannot restart it.
- Running
- The operation is active and is either searching for eligible files or transmitting file data to the target server.
- Running - Suspend in Progress
- The operation is in the process of being suspended as a result
of a SUSPEND EXPORT command. The export operation
is fully suspended when all of the data from the export operation
is saved. An export operation in this state does not respond to the
following commands:
- CANCEL PROCESS
- CANCEL EXPORT
- RESTART EXPORT
- SUSPEND EXPORT
- Suspended
- The operation stopped running due to a failure or was suspended with the SUSPEND EXPORT command.
- Process ID
- The process ID for the export operation when the status is either "Initializing" or "Running".
- Command
- The full command issued to start this server-to-server export.
- Phase
- The current step that the operation is performing. The possible
phases are shown in the order in which they are performed:
- Creating definitions on target server
- The operation is exporting definitions. The process cannot be suspended. Should the process fail in this phase, it cannot be restarted.
- Identifying and exporting eligible files
- The operation is building a list of eligible files for export. Some files may also be transmitted to the target during this phase. A process in this phase can be suspended. Should the process fail in this phase, it can be restarted.
- File list complete. Exporting eligible files
- The operation has completed building the list of eligible files for export and it is now transmitting the files to the target. A process in this phase can be suspended. Should the process fail in this phase, it can be restarted.
- Total running time
- The overall running time for this server-to-server export operation. For example, if this operation started and was then suspended and restarted two times, this value is the total running time of all three active processes of the export operation.
- Current process running time
- The running time of the active process of a server-to-server export operation. No value is displayed for a suspended operation because no active process exists.
- Export operation restart count
- The number of times the server-to-server export operation was restarted.
- Date and time of last restart
- The last date and time at which this server-to-server export operation was restarted.
- Date and time of last suspend
- The last date and time at which this server-to-server export operation was suspended.
- Policy domains exported
- The number of policy domain definitions successfully exported to the target server.
- Policy sets exported
- The number of policy set definitions successfully exported to the target server.
- Schedules exported
- The number of schedule definitions successfully exported to the target server.
- Mgmt classes exported
- The number of management class definitions successfully exported to the target server.
- Copy groups exported
- The number of copy group definitions successfully exported to the target server.
- Administrators exported
- The number of administrator definitions successfully exported to the target server.
- Option sets exported
- The number of option set definitions successfully exported to the target server.
- Node definitions exported
- The number of node definitions successfully exported to the target server.
- File space definitions exported
- The number of file space definitions successfully exported to the target server.
- Archive files exported
- The number of archive files successfully exported to the target server.
- Backup files exported
- The number of backup files successfully exported to the target server.
- Space managed files exported
- The number of space managed files successfully exported to the target server.
- Archive files skipped
- The number of archive files that were eligible for export but were skipped.
- Backup files skipped
- The number of backup files that were eligible for export but were skipped.
- Space managed files skipped
- The number of space managed files that were eligible for export but were skipped.
- Total bytes transferred (MB)
- The total number of bytes transmitted so far to the target server for this export operation.
- Total files to be transferred
- The total number of files transmitted so far to the target server for this export operation.
- Files remaining
- The total number of files remaining to be transmitted to the target server for this export operation.
Related commands
Command | Description |
---|---|
CANCEL PROCESS | Cancels a background server process. |
CANCEL EXPORT | Deletes a suspended export operation. |
EXPORT NODE | Copies client node information to external media or directly to another server. |
EXPORT SERVER | Copies all or part of the server to external media or directly to another server. |
IMPORT NODE | Restores client node information from external media. |
IMPORT SERVER | Restores all or part of the server from external media. |
QUERY PROCESS | Displays information about background processes. |
RESTART EXPORT | Restarts a suspended export operation. |
SUSPEND EXPORT | Suspends a running export operation. |