Customizing Data Transport Service › Customizing Audit Messages › Customize Audit Tokens

Customize Audit Tokens

You can customize audit tokens in Client Automation.

To customize the value of any of the audit tokens

1. Navigate to the Data Transport Service (DTS) subnode under the Control Panel, Configuration, Configuration Policy, Default Computer Policy, DSM node in the DSM Explorer.
2. Click the Audit policy group subnode.

   All of the DTS auditing policies appear on the Audit pane (right pane).

3. Double-click the appropriate policy, for example, DTA_ABORT.

   The Setting Properties dialog appears.

4. Edit the default text for the audit token associated with the selected policy.
5. Click OK.

   The selected audit token is customized.

The predefined audit value for the transfer-related audit tokens (DTA_ABORT ... DTA_RESUME) includes the following:

• Brief free text ("Transfer from...to...event") that describes what happens to the transfer, for example, it starts, aborts, or fails.
• The {XF} macro, the short form for {TransferFrom}, identifies the sending machine in the transfer.
• The {XT} macro, the short form for {TransferTo}, identifies the receiving machine in the transfer.

The DTA_FAIL message includes the following additional phrase:

...error message=${XX}.

The {XX} macro, the short form for {TransferExit}, specifies the reason the transfer failed. This macro displays the default message number and text for the error.

The predefined audit value for the AUDIT_START and AUDIT_END audit tokens includes the following:

• Brief free text that describes the event ("Audit file started [or stopped]...at...").
• The ${DT} and ${TT} macros, explained above.

When you customize these messages, we recommend that you retain the predefined text and macros. (The exception is the format you choose for the date and time.) By doing so, you retain important information and can easily locate the message in the DTS section of the DSM Messages Help, which contains possible reasons and corrective actions (if applicable) for the event. When you retain these tokens, your customization adds site-specific or company-specific value to the message, but does not remove any value.

Note: For more information, see the Configuration Policy section of the DSM Explorer Help.