Traces are a more detailed version of logs. They can be used to perform a more in depth investigation of technical issues.
Server traces are stored in the location defined in this section of
ucsrv.ini :
[TRACE]
file=..\temp\$$srv_trc_*_##.txt
Disclaimer : activating traces may cause latency and produce huge size files. For these reasons it should only be done for a short time and upon request of Automic's support.
In this post we're going to see how to activate traces on the Automation Engine server from the GUI, with a script or by editing the server's ini file.
1. From the GUI
A/ Up to version 11.2 : with the User Interface This can be done from the System Overview > Automation Engine.
Right-click on any WP from the list and select 'Properties'.
Turn on traces : fill in the cells in the left with the desired values.
Turn off traces : Set the values back to '0' in the cells.
B/ In AWI (v12 only)Go to the "
Administration" panel
> Automation Engine Management > Processes & usage then right-click on a server process and choose "
Trace Options".
Turning traces on / off can be done by adjusting values in the drop-down boxes.
2. With a script
The script function
SET_UC_SETTING can be coupled with
GET_UC_SYSTEM_NAME() for that purpose.
A/ Turning on traces!Set a DB=4 trace on the WPs
!Get System Name
:SET &TRC# = GET_UC_SYSTEM_NAME()
!Turn on tracing for WPs
:SET_UC_SETTING SET_TRACE, &TRC#, "0400000000000000"
B/ Turning off traces : apply the same principle to set values back to 0.
:SET &TRC# = GET_UC_SYSTEM_NAME()
!Turn on tracing for WPs
:SET_UC_SETTING SET_TRACE, &TRC#, "0000000000000000"
3. From ucsrv.ini
Manually edit
ucsrv.ini and set values in the
[TRACE] section
tcp/ip=
database=
trc03=
srcall=
memio=
jcl=
memsv=
snmp=
zuxml=
cache=
trc11=
ucds=
xscript=
uc4global=
trc15=
trc16=
Please make sure to not forget de-activating them afterwards! This option is not really recommended as it is taken into account every time the server is started.
Going further
Here are a few ready-to-use scripts developed by Automic staff members
Trace scheduler :
https://automic.force.com/support/apex/CommunityArticleDetail?id=ka4b00000004MP5
Rolling traces : https://automic.force.com/support/apex/CommunityArticleDetail?id=ka4b00000004MCp