InfoScale™ 9.0 Cluster Server Agent Developer's Guide - AIX, Linux, Solaris, Windows
- Introduction
- Agent entry point overview
- About agent entry points
- Agent entry points described
- About the action entry point
- About the info entry point
- Considerations for using C++ or script entry points
- About the agent information file
- About the ArgList and ArgListValues attributes
- Creating entry points in C++
- About creating entry points in C++
- Syntax for C++ entry points
- Agent framework primitives
- Agent Framework primitives for container support
- Creating entry points in scripts
- About creating entry points in scripts
- Syntax for script entry points
- Agent framework primitives
- VCSAG_GET_ATTR_VALUE
- Agent Framework primitives with container support
- Example script entry points
- Logging agent messages
- Building a custom agent
- Building a script based IMF-aware custom agent
- Creating XML file required for AMF plugins to do resource registration for online and offline state monitoring
- Testing agents
- Static type attributes
- About static attributes
- Static type attribute definitions
- AdvDbg
- ArgList
- State transition diagram
- Internationalized messages
- Troubleshooting VCS resource's unexpected behavior using First Failure Data Capture (FFDC)
- Appendix A. Using pre-5.0 VCS agents
Severity arguments for C++ macros
A severity argument for a logging macro, for example, VCS_ERROR or VCS_DBG1, is in fact a macro itself that expands to include the following information:
actual message severity
function name
name of the file that includes the function
line number where the logging macro is expanded
For example, the application severity argument VCS_ERROR within the monitor entry point for the FileOnOff agent would expand to include the following information:
ERROR, res_monitor, FileOnOff.C, 28
Application severity macros map to application severities defined by the enum VCSAgAppSev and the debug severity macros map to severities defined by the enum VCSAgDbgSev. For example, in the VCSAgApiDefs.h header file, these enumerated types are defined as:
enum VCSAgAppSev { AG_CRITICAL, AG_ERROR, AG_WARNING, AG_NOTICE, AG_INFORMATION }; enum VCSAgDbgSev { DBG1, DBG2, DBG3, . . DBG21, DBG_SEV_End };
With the severity macros, agent developers need not specify the name of the function, the file name, and the line number in each log call. The name of the function, however, must be initialized by using the macro VCSAG_LOG_INIT. See Initializing function_name using VCSAG_LOG_INIT .