Agent debug logging macros for C++ entry points
Prev Logging agent messages Next

Agent debug logging macros for C++ entry points

Use the macros VCSAG_RES_LOG_MSG and VCSAG_LOGDBG_MSG within agent entry points to log debug messages of a specific severity level to the agent log.

Use the LogDbg attribute to specify a debug message severity level. See the description of the LogDbg attribute (LogDbg). Set the LogDbg attribute at the resource type level. The attribute can be overridden to be set at the level for a specific resource.

The VCSAG_LOGDBG_MSG macro controls logging at the level of the resource type level, whereas VCSAG_RES_LOG_MSG macro can enable logging debug messages at the level of a specific resource.

The following table describes the argument fields for the application logging macros:

 

dbgsev 

Debug severity of the message. The values of dbgsev are macros ranging from VCS_DBG1 to VCS_DBG21. 

See Severity arguments for C++ macros. 

 

flags 

Describes the logging options. 

Default flags (0) prints UMI, NEWLINE. A macro, VCS_DEFAULT_FLAGS, represents the default value for the flags 

fmt 

A formatted string containing symbols. For example: "PathName is (%s)" 

variable_args 

Variable number (as many as 6) of type char, char * or integer 

For example:

VCSAG_RES_LOG_MSG(VCS_DBG4, VCS_DEFAULT_FLAGS, "PathName is (%s)",

(CHAR *)(*attr_val));

For the example shown, the specified message is logged to the agent log if the specific resource has been enabled (that is, the LogDbg attribute is set) for logging of debug messages at the severity level DBG4.

Prev Up Next
Agent application logging macros for C++ entry points Home Severity arguments for C++ macros