Tivoli Storage Manager for Windows: Administrator's Reference

|QUERY PATH (Display a Path)

| | |

|

|Use this command to display the path between a source and a |destination.

|Privilege Class

|Any administrator can issue this command.

|Syntax


|
|

When the destination is adrive

               .-*-----------.  .-*----------------.
>>-Query PATH--+-------------+--+------------------+------------>
               '-source_name-'  '-destination_name-'
 
   .-SRCType--=--ANY-----------.
>--+---------------------------+-------------------------------->
   '-SRCType--=--+-ANY-------+-'
                 +-DATAMover-+
                 '-SERVer----'
 
   .-DESTType--=--ANY-----------------------------.
>--+----------------------------------------------+------------->
   '-DESTType--=--DRIVE--LIBRary--=--library_name-'
 
   .-Format--=--Standard-----.
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'
                '-Detailed-'
 
 

|Syntax


|
|

When the destination is alibrary

               .-*-----------.  .-*----------------.
>>-Query PATH--+-------------+--+------------------+------------>
               '-source_name-'  '-destination_name-'
 
   .-SRCType--=--ANY-----------.  .-DESTType--=--ANY-----.
>--+---------------------------+--+----------------------+------>
   '-SRCType--=--+-ANY-------+-'  '-DESTType--=--LIBRary-'
                 '-DATAMover-'
 
   .-Format--=--Standard-----.
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'
                '-Detailed-'
 
 

|Parameters |

|source_name
|Specifies the name of a source for which to display paths. |You can specify wildcard characters. This parameter is optional. |The default is to display paths for all sources. A source is either a |data mover or a storage agent.

|destination_name
|Specifies the name of a destination for which to display paths. |This parameter is optional. The default is to display paths for all |destinations.

|SRCType
|Specifies the type of the source. This parameter is |optional. The default is to display paths for all source types. |Possible values are: |

|ANY
|Specifies that paths with any source type display.

|DATAMover
|Specifies that only paths with source type DATAMOVER display.

|SERVer
|Specifies that only paths with source type SERVER display. (A |source that has a source type of SERVER is a storage agent.) |

|DESTType
|Specifies the type of the destination. This parameter is |optional. The default is to display paths for all destination |types. Possible values are: |

|ANY
|Specifies that paths with any destination type display.

|DRive
|Specifies that only paths with destination type DRIVE display. When |the destination type is a drive, you must specify the library name.

|LIBRary
|Specifies that only paths with destination type LIBRARY display. |

|LIBRary
|Specifies the name of the library to which the drive belongs. This |parameter is required when the destination type is a drive |(DESTTYPE=DRIVE).

|Format
|Specifies how the information is displayed. This parameter is |optional. The default is STANDARD. Possible values are: |

|Standard
|Specifies that partial information is displayed.

|Detailed
|Specifies that complete information is displayed. |
|

|Examples

|Task

|Display information about paths for the source NETAPP1. |

|Command:
|query path netapp1

|Output:
|  |
|+----------------------------------------------------------------------------------+
||Source Name  Source Type  Destination Name  Destination Type  Online              |
||-----------  -----------  ----------------  ----------------  ------              |
||NETAPP1      Data mover   DRIVE1            Drive             Yes                 |
||NETAPP1      Data mover   NASLIB            Library           Yes                 |
|+----------------------------------------------------------------------------------+

|See the next task for field descriptions.

|Task

|Display detailed information about paths for the source |NETAPP1. |

|Command:
|query path netapp1 format=detailed

|Output:
|  |
|+--------------------------------------------------------------------------------+
||                   Source Name: NETAPP1                                         |
||                   Source Type: DATAMOVER                                       |
||              Destination Name: NASLIB                                          |
||              Destination Type: LIBRARY                                         |
||                       Library:                                                 |
||                        Device: mc0                                             |
||                     Directory:                                                 |
||                       On-Line: Yes                                             |
||Last Update by (administrator): SERVER_CONSOLE                                  |
||         Last Update Date/Time: 06/21/2001 20:52:56                             |
||                                                                                |
||                                                                                |
||                   Source Name: NETAPP1                                         |
||                   Source Type: DATAMOVER                                       |
||              Destination Name: DRIVE1                                          |
||              Destination Type: DRIVE                                           |
||                       Library: NASLIB                                          |
||                        Device: rst0l                                           |
||                     Directory:                                                 |
||                       On-Line: Yes                                             |
||Last Update by (administrator): SERVER_CONSOLE                                  |
||         Last Update Date/Time: 06/21/2001 20:55:23                             |
|+--------------------------------------------------------------------------------+
|

|Source Name
|The name of the source.

|Source Type
|The type of the source, either a data mover or a server (storage |agent).

|Destination Name
|The name of the destination.

|Destination Type
|The type of the destination. The destination type is either a drive |or a library.

|Library
|The name of the library that contains the drive that is the |destination. This field will be blank if the destination type is |library. The library name is in destination name field when the |destination is a library.

|Device
|The name of the device that is the destination.

|Online
|Whether the path is online and available for use.

|Last Update by (administrator)
|The ID of the administrator who performed the last update.

|Last Update Date/Time
|The date and time when the last update occurred. |

|Related Commands
|

|Table 199. Commands Related to QUERY PATH

Command Description
DEFINE PATH Defines a path from a source to a destination.
DELETE PATH Deletes a path from a source to a destination.
UPDATE PATH Changes the path from a source to a destination.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]