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).
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
- Command line:
- Assuming 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.
- Assume that the command 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?9000 c:\gpfs\home\myfiles\?file c:\gpfs\home\myfiles\**README**version2 c:\gpfs\home\myfiles\ABC?file*
- If 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*
- Command line:
- Assuming 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.
- Assume that the command issued is dsmc sel -filelist=/home/user1/important_files, where important_files.txt contains the list of files to process.
- important_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*
- If 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*