tsmdlst (Display information about devices)

Options

After devices are configured, you can run the tsmdlst utility to display device information. The utility is in the devices server directory, which is \Program Files\Tivoli\TSM\server by default.

/computer=computer_name

Specifies the name of the computer for which devices are listed. The default is the local system.

/detail

Displays details on devices in the list. By default, a summary is shown.

/all

Displays information about all types of devices. By default, only tape drives and tape libraries are included in the results.

/nogenerictapecheck

Skips the step for opening detected drives to see whether they are supported for the IBM Spectrum Protect™ GENERICTAPE device type.

/nohbacheck

Skips the step for host bus adapter (HBA) API detection, which might speed up processing. This option can be useful when debugging is needed.

/trace

Used for diagnostic purposes. Stores trace output in the tsmdlst_trace.txt file.

/?

Displays usage information about tsmdlst and its parameters.

/xinquiry

Provides an alternative way to obtain serial number and worldwide name information. This option is used only for devices that are supported by the IBM® tape device driver. The following parameters are specific to the /xinquiry option:

/processAll

Indicates that the process loops until all devices are processed.

/maxRetries=#

Indicates the maximum number of attempts to open each drive. This option requires the /processAll option.

/genpathfile

Use this option to generate a list of devices and serial numbers. The tsmdlst_pathfile.txt file is written with information for the /genmacropathsync and /genmacropathoffline options.

/includelib

If this parameter is specified with the /genpathfile option, the list of devices includes libraries in addition to drives.

/genmacropathsync

Generates a macro to synchronize IBM Spectrum Protect paths for the storage agent based on serial number. A drive must have a serial number that is defined to IBM Spectrum Protect for this option to work.

/genmacropathoffline

Generates a macro to update IBM Spectrum Protect paths for the storage agent to online or offline status based on drive accessibility. A drive is accessible if an operating system open call results in: ERROR_SUCCESS, ERROR_BUSY or ERROR_ACCESS_DENIED. This option works only for devices that are using the IBM device driver. A symbolic name, for example \\.\tape0, is required to open a device.

The following options are used only with the /genmacropathsync and /genmacropathoffline options:

/server=servername

Specifies the name of the server that the storage agent is using.

/stagent=stagentname

Specifies the name of the storage agent.

/tcps=address

Specifies the IBM Spectrum Protect server address.

/tcpp=port

Specifies the IBM Spectrum Protect server port. The default is 1500.

/id=id

Specifies the IBM Spectrum Protect administrative ID.

/pass=password

Specifies the IBM Spectrum Protect administrative password.

/devicetype=drivetype

Specifies the device type of the drive, for example, LTO. This option is case-sensitive and optional.

/libraryname=libname

Filters on the library name of the drive, for example LTO3584. This option is case-sensitive and optional.

/execmacropathsync

Issues the path synchronize macro to the IBM Spectrum Protect server.

/execmacropathoffline

Issues the path offline macro to the IBM Spectrum Protect server.

/addpaths

Adds define and update path statements. This option is used with the /genmacropathsync option.

/verbose

Lists both drive and path information returned from the IBM Spectrum Protect server and contents of the path file.

/encodednames

If a path is set to online=no, the device name encodes time stamp, error, and device as the updated device name.