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