Creating a default client user-options file

Creating a default client user-options file (dsm.opt) is an optional task.

You can use the default client user-options file to define the following options:

• Backup and archive processing options
• Restore and retrieve processing options
• Scheduling options
• Format options
• Command processing options
• Authorization options
• Error processing options
• Transaction processing option
• Web client options

If you are a root user or a system administrator, you can create or modify a default client user-options file for all users on your workstation. From the UNIX command line:

1. Change to the directory containing the sample file.
2. For systems other than Solaris, copy the dsm.opt.smp file to dsm.opt or to a new file name of your choice.
3. For UNIX and Linux (other than Mac OS X), use the following information:
   • For the default client user-options file: You can store your default client user-options file to the default file dsm.opt, in the same directory as the dsm.sys.smp file, or use any other path and file name to which you have read access. If you rename your client user-options file or place it in a different directory, you can set the DSM_CONFIG environment variable or use the optfile option to point to your new client user-options file.
4. For Mac OS X systems, use the following information:
   • For the default client user-options file: You can store your default client user-options file as /Library/Preferences/Tivoli Storage Manager/dsm.opt.
   • For the client user-options file: You can copy your client user-options file to ~/Library/Preferences/Tivoli Storage Manager/dsm.opt, or in any directory for which you have write access. If you rename your client user-options file or place it in a different directory, you must set the DSM_CONFIG environment variable or use the optfile option to point to your new client user-options file.
   Important: For Mac OS X, the system-options file must be a plain text file, encoded as Unicode (UTF-8). By default, TextEdit does not save files as plain text. Select Format > Make PlainText to save the user-options file as a plain text file. Set the Plain Text Encoding: to Unicode (UTF-8). Do not add the .txt extension.

You can then edit your dsm.opt file as appropriate for your system. From the GUI, you can edit this file using the Preferences editor by opening the Edit menu and selecting Preferences. The Preferences editor updates the client configuration files, dsm.opt and dsm.sys, if any options have changed. If you update the dsm.opt file during a session, you must restart the session to pick up the changes.

The Preferences editor uses the environment variable DSM_DIR to locate the dsm.sys file and DSM_CONFIG to locate the client user-options file (default name dsm.opt). The Preferences editor queries the server for options on the server, but cannot change the server options file.