Rsdiag Syntax

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

RsDiag Syntax

Art Imagersdiag [/d DBType OutputFile] [/i] [/m] [/v [DriveLetter]] [/s] [/w Path\FileName] [/j [JobName]] [/c JobName] [/r [/f]] [/x RecallJob] [/e ErrorCode] [/t] [/?]



  • Except as noted, you can use only one RsDiag parameter with each command.
  • */d* *DBType OutputFile*
    Writes the specified Remote Storage database to the specified text file. Typically, support engineers use these files to identify or resolve metadata errors.

    DBtype identifies the database. This variable is required with /d. The following table lists valid values for DBType.

    DBType Database type Description


    Engine database (EngDb)

    The primary remote storage database for the installation.


    FSA database (FsaDb)

    The FSA database stores a list of premigrated files on each volume.

    In premigrated files, the file data has been copied to remote storage, but it also remains on the local volume as long as space is available. Files that were migrated and then recalled are considered to be premigrated.


    FSA temporary unmanaged database

    A temporary database that stores FSA data for a volume during the unmanaged process. When the process is complete, this database is deleted.


    FSA persistent (RsFsa.col)

    A collection file that stores the configuration options set for each volume.


    Engine persistent (RsEng.col)

    A collection file that stores configuration options set for the Remote Storage installation.

    OutputFile is the full path and file name of the text file that RsDiag creates to store this display; for example, C:\RSS\myrssdb.txt. The full path is required, even when the file is in the local directory. All directories in the path must exist before you run the command. Use quotation marks to enclose names that contain spaces.

  • */i*
    Lists and displays version information for the collection (.col) files on this system. The collection files store configuration information for Remote Storage. To display the collection files, use the /d a or /d n parameter.
  • */m*
    Lists volumes on this system that are eligible for Remote Storage management.
  • */v* [DriveLetter]
    Lists the managed volumes on this system. With a drive letter, /v displays detailed information about the specified managed volume.
  • */s*
    Lists and describes the physical storage media used on this system.
  • */w* *Path\FileName*
    Finds the specified managed file in remote storage. This parameter displays the physical location of any file on a managed volume. The display includes the physical storage medium on which the most current version of the specified file resides, and the data set of which the file is a member. Specify the full path and file name of the file. The full path is required even when the file is in the local directory. Use quotation marks to enclose names that contain spaces. To see which files are migrated, or to determine the Remote Storage status of a file, use Rsdir Overview.
  • */j* [JobName]
    Lists the Remote Storage jobs scheduled on this system. With a job name, /j displays detailed information about the specified job. Use quotation marks to enclose job names that include spaces. This display lets you predict the duration of a job and compare the run time of different jobs.
  • */c* *JobName*
    Stops a Remote Storage job in progress. This parameter stops the current run of the specified job. It does not affect the job schedule. To display the jobs scheduled for the system, use the /j parameter. Caution
    • This command stops the job, but does not cancel or reverse actions already completed by the job. Files processed before the job was stopped are not restored to their original state.
  • */r* [/f]
    Displays the jobs in the Remote Storage server's internal recall queue. The display includes the name and logical size of each recalled file. The /f (full) parameter adds the state of the recall, the user who initiated the recall, and the file offset into the media to the display.
  • */x* *RecallJob*
    Deletes the specified recall job from the Remote Storage server's internal recall queue. Only pending recalls can be cancelled. To display the recall queue, use /r. RecallJob is the name of the job that recalls the file. It consists of the full path to the file being recalled, including the server name. This value appears in the Queued Recall field of the /r display.
  • */e* *ErrorCode*
    Explains HRESULT and WIN32 error codes. Type an ErrorCode value in decimal or hexadecimal format. The default is decimal. For hexadecimal error codes, prepend 0x to the error code, for example, 0x81000005.
  • */t*
    Reloads the trace files. This setting is for internal use only.
  • */?*
    Displays help information for the tool.

See Also


Rsdiag Overview
Rsdiag Examples
Rsdir Overview