Administrator's Reference

QUERY PATH (Display a Path Definition)

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

Privilege Class

Any administrator can issue this command.

Syntax

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

Parameters

source_name

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

destination_name

Specifies the name of a destination for which to display paths. This parameter is optional. You can specify wildcard characters. 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 to display paths with any source type.

DATAMover

Specifies to only display paths with the DATAMOVER source type.

SERVer

Specifies to only display paths with the SERVER source type. (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 to display paths with any destination type.

DATAMover

Specifies to display only paths with the DATAMOVER destination type.

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                 |
+----------------------------------------------------------------------------------+

Descriptions of the query fields are provided after the last task example.

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                             |
+--------------------------------------------------------------------------------+

Descriptions of the query fields are provided after the last task example.

Source Name

The name of the source.

Destination Name

The name of the destination.

Source Type

The type of the source.

Destination Type

The type of the destination.

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 197. Commands Related to QUERY PATH