Wildcardsareliteral

The wildcardsareliteral option specifies whether question marks (?) and asterisks (*) are interpreted literally, when they are included in a file list specification on a filelist option.

Ordinarily, Tivoli® Storage Manager does not accept wildcard characters (? and *) in a file list specification that is included on a filelist option. Some file systems, such as the IBM® General Parallel File System (GPFS™), allow these characters in file and directory names. To prevent errors that would otherwise occur, when file specifications are included on a filelist option and they contain wildcard characters, set wildcardsareliteral yes. When wildcardsareliteral is set to yes, question marks (?) and asterisks (*) that are included in a file list specification on the filelist option are interpreted literally, and not as wildcard characters.

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

Read syntax diagramSkip visual syntax diagram
                        .-no------.   
>>-WILDCARDSareliteral--+-+-----+-+----------------------------><
                          '-yes-'     

Parameters

no
Specifies that question marks and asterisks are interpreted as wildcards when used in a file list specification that is included on a filelist option. No is the default. If a file list specification on a filelist option includes a question mark or asterisk, an error occurs and the file specification cannot be processed.
yes
Specifies that asterisks and question marks in a file list specification that is included on a filelist option are interpreted literally, and not as wildcard characters. Specify this value if you are backing up files from a file system that allows wildcard characters in file or directory names.

Examples

Options file:
WILDCARDSARELITERAL YES
Windows operating systemsCommand line:
Windows operating systemsAssuming that the file system allows wildcard characters in paths, the following are examples of files in a file list specification that can be successfully processed if WILDCARDSARELITERAL is set to YES.
Windows operating systemsAssume that the command issued is dsmc sel -filelist=c:\important_files.txt, where important_files.txt contains the list of files to process.
Windows operating systemsimportant_files.txt contains the following list of files:
c:\gpfs\home\myfiles\file?9000
c:\gpfs\home\myfiles\?file
c:\gpfs\home\myfiles\**README**version2
c:\gpfs\home\myfiles\ABC?file*
Windows operating systemsIf both WILDCARDSARELITERAL and QUOTESARELITERAL are both set to YES, the following backups can be successfully processed:
c:\gpfs\home\myfiles\"file?
c:\gpfs\home\myfiles\?file'
c:\gpfs\home\myfiles\**"README Tomorrow"**
c:\gpfs\home\myfiles\file*
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsCommand line:
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsAssuming that the file system allows wildcard characters in paths, the following are examples of files in a file list specification that can be successfully processed if WILDCARDSARELITERAL is set to YES.
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsAssume that the command issued is dsmc sel -filelist=/home/user1/important_files, where important_files.txt contains the list of files to process.
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsimportant_files.txt contains the following list of files:
/home/user1/myfiles/file?9000
/home/user1/myfiles/?file
/home/user1/myfiles/**README**version2
/home/user1/myfiles/ABC?file*
AIX operating systemsHP-UX operating systemsLinux operating systemsMac OS X operating systemsOracle Solaris operating systemsIf both WILDCARDSARELITERAL and QUOTESARELITERAL are both set to YES, the following backups can be successfully processed:
/home/user1/myfiles/"file?
/home/user1/myfiles/?file'
/home/user1/myfiles/**"README Tomorrow"**
/home/user1/myfiles/file*