Each audit token defines a message to write to the Client Automation event component, which directs it to the application log and the agent auditing log file when a specific event occurs, such as the start or completion of a transfer job. You can customize the message (called the audit value) for each token to contain free text and macros that are expanded when the token is issued, that is, when the message is issued by the Data Transport Server or Data Transport Agent.
For example, the following audit tokens represent the events for which you can customize the messages the DTS agent. The audit value is the macro plus free text, if any, that you specify for each of these events.
DTA_ABORT=${DT} ${TT} Transfer from ${XF} to ${XT} aborted.
DTA_COMPLETE=${DT} ${TT} Transfer from ${XF} to ${XT} completed.
DTA_FAIL=${DT} ${TT} Transfer from ${XF} to ${XT} failed; error message=${XX}.
DTA_START=${DT} ${TT} Transfer from ${XF} to ${XT} started.
DTA_SUSPEND=${DT} ${TT} Transfer from ${XF} to ${XT} suspended.
DTA_RESUME=${DT} ${TT} Transfer from ${XF} to ${XT} resumed.
AUDIT_START=${DT} ${TT} Audit file started.
AUDIT_END=${DT} ${TT} Audit file stopped.
The first group of audit tokens (DTA_ABORT ... DTA_RESUME) are issued when a transfer that specifies this agent as the initiator or responder aborts, completes, fails, starts, is suspended, or is resumed after a suspension.
These messages supply transfer-specific information to the initiating DTS agent. They can be very useful, because transfer-related messages from the TOS are not displayed on the agent machine unless the TOS and agent reside on the same machine.
The last two audit tokens (AUDIT_START and AUDIT_END) are issued when auditing is turned on or off.
The ${DT} and ${TT} macros used in each audit message are the short forms of ${DateStandard} and ${TimeStandard}, respectively. These macros display the date and time in the standard C library format for this DTS agent computer.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|