Managed Transfers (TOS) › dtscli Command—Apply Filters › dtscli Command—Add File Filters

dtscli Command—Add File Filters

Valid DTSCLI file filters include the following types:

• Directory filters
• Encryption filters
• File attribute filters

When adding file filters, parcel filters may also be needed. To transfer a directory, file filters must now be added to the dtscli command. If you try to transfer a directory without adding the directory filter, you will get the following error message:

"Failed to open input data <c:\dtstemp> error=<Permission denied>".

Help for file filters is given by the command:

dtscli -help agent f_filters

Example: Transfer a Directory

• The following example transfers a directory using a short format for the directory filter:

  dtscli -agent ipath=Gold::c:\dtstemp 
  

  "rpath=Silver::c:\dtstemp" 
  "f_filters=dir"
  

• This example performs the same operation but uses a long format:

  dtscli -agent "ipath=Gold::c:\dtstemp" 
  

  "rpath=Silver::c:\dtstemp" 
  "f_filters=DIRTREE_READ:DIRTREE_WRITE"
  "p_filters=binary"
  

Note: If using the longhand format, you must also apply parcel filters.

Example: Encrypt a File

The following example encrypts the file before it sending it to the responder:

dtscli -agent "ipath=Gold::c:\dtstemp" 

"rpath=Silver::c:\dtstemp" 
"f_filters=PLAIN_ENCRYPT_FILE(ENDEC_KEY=key):PLAIN_DECRYPT_FILE()"
"p_filters=binary"

Example: Apply Attributes of Original File to Transferred File

The use of the file attribute filter forces the transferred file to have the same attributes as the original.

• This example gives file.src certain attributes, like read only, hidden, and so on, using a short format:

  dtscli -agent "ipath=Gold::c:\dtstemp\file.src"
  

  "rpath=Silver::c:\dtstemp\file.dest"
  "f_filters=fattr"
  "p_filters=binary'
  

• This example performs the same operation but uses a long format:

  dtscli -agent "ipath=Gold::c:\dtstemp\file.src"
  

  "rpath=Silver::c:\dtstemp\file.dest"
  "f_filters=FILE_ATTRIBUTE:"
  "p_filters=binary"