Query Systeminfo

Use the query systeminfo command to gather information and output this information to a file or the console.

This command is intended primarily as an aid for IBM® support to help diagnosing problems. However, users who are familiar with the concepts addressed by this information might also find it useful.

If you use the console option, no special formatting of the output is performed to accommodate screen height or width. Therefore, the console output can be difficult to read due to length and line-wrapping. If the console output is difficult to read, use the filename option with the query systeminfo command. This combination allows the output to be written to a file that can be submitted to IBM support.

Supported Clients

This command is valid for all clients.

Syntax


                     .-------------.                   
                     V             |                   
>>-Query SYSTEMInfo------ --item---+--+------------+-----------><
                                      '- --options-'

Parameters

item: Specifies one or more items from which you want to gather information and output the information to the file name that you specify with the filename option or to the console. The default is to gather all items.

You can gather information on one or more of the following items:

DSMOPTFILE - The contents of dsm.opt file.
DSMSYSFILE - The contents of the dsm.sys file.
ENV - Environment variables.
ERRORLOG - The client error log file.
FILE - Attributes for the file name that you specify.
FILESNOTTOBACKUP - Enumeration of Windows Registry key:
```
HKEY_LOCAL_MACHINE\
   SYSTEM\
      CurrentControlSet\
         BackupRestore\
            FilesNotToBackup
```
This key specifies those files that are not to be backed up. The query inclexcl command indicates that these files are excluded per the operating system.
INCLEXCL - Compiles a list of include-exclude in the order in which they are processed during backup and archive operations.
KEYSNOTTORESTORE - Enumeration of Windows Registry key:
```
HKEY_LOCAL_MACHINE\
   SYSTEM\
      ControlSet001\
         BackupRestore\
            KeysNotToRestore
```
This key specifies those Windows Registry keys that are not to be restored.
MSINFO - Windows system information (output from MSINFO32.EXE).
OPTIONS - Compiled options.
OSINFO - Name and version of the client operating system
OSINFO - Name and version of the client operating system (includes ULIMIT information for UNIX).
POLICY - Policy set dump.
REGISTRY - IBM Spectrum Protect™-related Windows Registry entries.
SCHEDLOG - The contents of the schedule log (usually dsmsched.log).
SFP - The list of files that are protected by Windows System File Protection, and for each file, indicates whether that file exists. These files are backed up as part of the SYSFILES system object.
SFP=<filename> - Indicates whether the specified file (filename) is protected by Windows System File Protection. For example:
```
SFP=C:\WINNT\SYSTEM32\MSVCRT.DLL
```
SYSTEMSTATE - Windows system state information.
CLUSTER - AIX® cluster information.
CLUSTER - Windows cluster information.
ENCRYPT - Available encryption methods.

Note:

Use the filename option to specify a file name in which to store the information that is gathered from the items you specify. If you do not specify a file name, by default the information is stored in the /Library/Application Support/tivoli/tsm/client/ba/bin/dsminfo.txt file (for Mac OS X) or the dsminfo.txt file (for other UNIX and Linux).
Use the filename option to specify a file name in which to store the information gathered from the items you specify. If you do not specify a file name, by default the information is stored in the dsminfo.txt file.
Use the console option if you want to output the information to the console.

Table 1. Query Systeminfo command: Related options
Option	Where to use
console	Command line only.
filename	Command line only.

Examples

Task: Gather and store the contents of the dsm.opt file and the IBM Spectrum Protect error log file in the tsminfo.txt file.
Command: query systeminfo dsmoptfile errorlog -filename=tsminfo.txt