 | ||
| UMI | ||
|---|---|---|
| Prev | Agent messages: format | Next |
The UMI (unique message identifier) includes an originator ID, a category ID, and a message ID.
The originator ID is a decimal number preceded by a "V-" that defines the component that the message comes from. This ID is assigned by Veritas.
The category ID is a number in the range of 0 to 65536 assigned by Veritas. The category ID indicates the agent that message came from. For each custom agent, you must contact Veritas so that a unique category ID can be registered for the agent.
For C++ messages, the category ID is defined in the VCSAgStartup function.
See Log category.
For script-based entry points, the category is set within the VCSAG_SET_ENVS function
See VCSAG_SET_ENVS.
For debug messages, the category ID, which is 50 by default, need not be defined within logging functions.
Message IDs can range from 0 to 65536 for a category ID. Each normal message (that is, non-debug message) generated by an agent must be assigned a message ID. For C++ entry points, the msgid is set as part of the VCSAG_LOG_MSG and VCSAG_CONSOLE_LOG_MSG macros. For script-based entry points, the msgid is set using the VCSAG_LOG_MSG function. The msgid field is not used by debug functions or required in debug messages.
See VCSAG_LOG_MSG.