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

dtscli Command—Add File Filters

Valid DTSCLI file filters 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 be added to the dtscli command. If you try to transfer a directory without adding the directory filter, you get the following error message:

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

Help for file filters command:

dtscli -help agent f_filters

Example: Transfer a Directory

• Transfer a directory using a short format for the directory filter:

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

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

• Perform the same operation using a long format:

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

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

Note: When using the long format, also apply parcel filters.

Example: Encrypt a File

Encrypt the file before 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.

• Assign file.src certain attributes, such as read only, hidden, using a short format:

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

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

• Performs the same operation using long format:

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

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