Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Usage of Special Characters in Remote Filenames

    The router supports the following special characters for remote filenames:

    • %x—An integer in hexadecimal format (base 16)
    • %s—A character string
    • %u—An unsigned integer in decimal (base 10)
    • %d—An integer in decimal (base 10)

    The % variables in the remote name are replaced at runtime with the sysName and sysUpTime parameters to produce variable filenames on the remote host. For more information about configuring remote filenames, see the bulkstats receiver remote-name command. The following example shows the usage of special characters in remote filename configuration:

    host1(config)#bulkstats receiver 1 remote-name “ bulk%s%d.sts” sysName collectorSequence


    The current capabilities and limitations of the bulk statistics formatter are:

    • If you add %d or any numeric formatter for a string value (such as sysName), the attribute name will be used (for instance, sysName). The opposite is also true, except for sysUptime, which will use %s as a %u.
    • You can use %% if you want a % character to be part of the parsed name.
    • You can use the same attribute multiple times. For example, you may want a name that has %x and %u of collectorSequence.
    • Currently, there is no control over sequence numbers, except for the guarantee that the formatter will:
      1. Use sequential values, beginning from 1
      2. Persist through system reboot
    • If you need the sequential number to restart, remove and then add the bulk statistics receiver again.
    • You can use up to 128 characters for the remote file name. Anything beyond that is truncated when the filename is stored in nonvolatile memory, but this truncation is not visible until the next time the system reboots.

    Published: 2014-08-12