Tivoli Header

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

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 attributes associated with a path.


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