To turn on a certain trace mode for the CA Harvest SCM agent, specify the option ‑trlvl=int in the product agent command line or in the HAgent.arg file.
When the trace option is on and the option -verbose is not specified, trace messages are logged into the agent log file. If the product agent is running in verbose mode (with -verbose), trace messages display in the standard output.
Trace messages contain five fields: thread ID, time stamp, trace mode, function name, and additional information.
Thread id | Time stamp | LVLx: Function Name - Additional Information
The following example shows a mode 1 trace with thread ID 13, time stamp 08:23:29, function name ConnectionMsgThreadMain, and no additional information.
13 | 08:23:29 | LVL1: in ConnectionMsgThreadMain
The following example shows a mode 2 trace with thread ID 420, time stamp 17:09:57, function name CptHAgentC::Fremove, and information that remove file c:\cko1\f1.sh has failed.
420 | 17:09:57 | LVL2: CPtHAgntC::FRemove failed to remove <C:\cko1\f1.sh>
The following example shows a level 3 trace with thread ID 368, time stamp 16:45:31, function name cbExecuteA, following the successful invocation of "hexecp -b xxx -m xxx -usr xxx -pw xxx -syn -prg c:\1651\echo.bat":
368 | 16:45:31 | LVL3: cbExecuteA bSynch is true 41| File<c:\1651\echo.bat> CmdArg<> Stdin<> CB<4211056> Fm</pt_HClient://ni-ya01h511b2/62> |0
368 | 16:45:35 | LVL3: cbExecuteA done 41| File<c:\1651\echo.bat> |0
In addition to four modes of trace, an error message is always logged regardless of the trace mode specified. The error message indicates that an agent encountered an error but it is not able to reply to the client. The error message has the following format:
Thread id | Time stamp | ERR: Function Name - Additional Information
Example:
127 | 08:39:08 | ERR: cbLogIn() -ServerCrypt.CreateKeyAgreementPair() failed
|
Copyright © 2013 CA.
All rights reserved.
|
|