Quotesareliteral

The quotesareliteral option specifies whether single quotation marks (') or double quotation marks (") are interpreted literally, when they are included in a file list specification on a filelist option.

Ordinarily, Tivoli® Storage Manager requires you to use single or double quotation marks to delimit file specifications that contain space characters. Some file systems, such as the IBM® General Parallel File System (GPFS™), allow single and double quotation marks in file and directory names.

To prevent errors that would otherwise occur, when file specifications are included on a filelist option and they contain single quotation marks (') or double quotation marks ("), set quotesareliteral yes. When quotesareliteral is set to yes, quotation marks that are included in a file list specification on a filelist option are interpreted literally, as quotation marks, and not as delimiters.

This option applies to any command that accepts a filelist option as command parameter.

Supported Clients

This option is valid for all supported platforms. The option is applied to any command that takes a file list specification as a parameter.

Options File

Place this option in the client user options file (dsm.opt).

Syntax


                     .-no------.   
>>-QUOTEsareliteral--+-+-----+-+-------------------------------><
                       '-yes-'

Parameters

no: Specifies that single quotation marks (') and double quotation marks (") are interpreted as delimiters for file list specifications included on a filelist option. No is the default setting.
yes: Specifies that single quotation marks (') and double quotation marks (") are interpreted literally, and not as delimiters, for file list specifications that are included on a filelist option. Specify this value if you are backing up files from a file system that allows quotation marks in file or directory names.

Examples

Options file:

QUOTESARELITERAL YES

Command line:

Assuming that the file system allows quotation marks in paths, the following are examples of files in a file list specification that can be successfully processed if QUOTESARELITERAL is set to YES.

Assume the command that is issued is dsmc sel -filelist=c:\important_files.txt, where important_files.txt contains the list of files to process.

important_files.txt contains the following list of files:

c:\gpfs\home\myfiles\"file"1000
c:\gpfs\home\myfiles\'file'
c:\gpfs\home\myfiles\file'ABC
c:\gpfs\home\myfiles\ABC"file"

Command line:

Assuming that the file system allows quotation marks in paths, the following are examples of files in a file list specification that can be successfully processed if QUOTESARELITERAL is set to YES

Assume the command that is issued is dsmc sel -filelist=/home/user1/important_files, where important_files.txt contains the list of files to process.

/home/user1/myfiles/"file"1000
/home/user1/myfiles/'file'
/home/user1/myfiles/file'ABC
/home/user1/myfiles/ABC"file"