# token-dest-dn

<token-dest-dn> expands to the destination DN specified in the current operation or a portion thereof. If start and length are not specified or are set to the default values {0,-1}, then the entire DN is used, otherwise only the portion of the DN specified by start and length is used. The format of the DN is automatically to the format of the source datastore if convert attribute is set to true.

### Example

>     <token-dest-dn/>

## 1. Allowed Content

> EMPTY

## 2. Attributes

> Attribute | Value(s) | Default Value
> --- | --- | ---
> convert | true | false convert to DN format of source datastore | false
> length | CDATA number of DN segments to include negative numbers are interpreted as (total # of segments + length) + 1 (e.g for a DN with 5 segments a length of -1 = (5 + (-1)) + 1 = 5, -2 = (5 + (-2)) + 1 = 4, etc.) | -1
> notrace | true | false true if this element should not be traced during execution of policy | false
> start | CDATA segment index to start with 0 is the rootmost segment >0 is an offset from the rootmost segment -1 is the leafmost segment <-1 is an offset from the leafmost segment towards the rootmost segment | 0

## 3. Content Declaration

> Empty

## 4. Parent Elements

> arg-association
>   association argument
> arg-component
>   component argument
> arg-dn
>   DN argument
> arg-node-set
>   node set argument
> arg-password
>   password argument
> arg-string
>   string argument
> arg-value
>   value argument
> token-base64-decode
>   decode base64 data into a string
> token-base64-encode
>   encode a string into base64 data
> token-convert-time
>   convert a date/time from one format to another
> token-escape-for-dest-dn
>   convert a string for use in a destination DN
> token-escape-for-src-dn
>   convert a string for use in a source DN
> token-join
>   join a node-set into a string
> token-lower-case
>   convert a string to lower case
> token-map
>   map a string through a mapping table
> token-parse-dn
>   parse and/or convert a DN
> token-replace-all
>   replace all instances of a substring within a string
> token-replace-first
>   replace a single instance of a substring within a string
> token-split
>   split a string into a node-set
> token-substring
>   substring of a string
> token-upper-case
>   convert a string to upper case
> token-xml-parse
>   parse XML
> token-xml-serialize
>   serialize XML

Top Elements || All Elements || Tree