IBM Tivoli Storage Manager, Version 7.1

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-----------------------------+-'   
                  +-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.
DRive: Specifies to display only paths with the DRIVE destination type. When the destination type is a drive, you must specify the library name. You can refine which paths are displayed by entering a name in the LIBRARY parameter.
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.

Example: Display summary path information

Display information about paths for the source NETAPP1. See Field descriptions for field descriptions.

query path netapp1

Source Name  Source Type  Destination Name  Destination Type  Online
-----------  -----------  ----------------  ----------------  ------
NETAPP1      DATAMOVER    DRIVE1            DRIVE             Yes
NETAPP1      DATAMOVER    NASLIB            LIBRARY           Yes

Example: Display detailed path information

Display detailed information about paths for the source NETAPP1. See Field descriptions for field descriptions.

query path netapp1 format=detailed

                   Source Name: NETAPP1
                   Source Type: DATAMOVER
              Destination Name: NASLIB
              Destination Type: LIBRARY
                       Library:
                        Device: /dev/tsmscsi/mc0
                     Directory:
                       On-Line: Yes   
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 06/21/2002 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/2002 20:55:23

                   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

Example: Display detailed path information for a z/OS media server

Display detailed information about a z/OS® media server path. See Field descriptions for field descriptions.

query path format=detailed

                   Source Name: SERVER1
                   Source Type: SERVER
              Destination Name: ZOSMEDIA
              Destination Type: LIBRARY
                       Library:
                     Node Name:
                        Device:
              External Manager:
              ZOS Media Server: MEDSERV1
                   Comm Method:
                           LUN:
                     Initiator: 0
                     Directory:
                       On-Line: Yes
Last Update by (administrator): ADMIN
         Last Update Date/Time: 06/08/2011 15:33:39

Field descriptions

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.
Node Name: The name of the device that is the destination.
Device: The name of the device that is the destination.
Directory: Specifies the directory location of a file on the source.
LUN: Specifies the logical unit name through which the disk can be accessed by the source.
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 1. 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.

Feedback