halog - add messages to the engine log
halog -addtags tag1 [tag2 tag3 ...] [-sys system]
halog -deltags tag1 [tag2 tag3 ...] [-sys system]
halog -add\ "quoted_string" -sev C|E|W|N|I [-sys system] [-msgid message-number [-encoding encoding] [-parameters parameter1 parameter2 ...]]
halog -add\ "quoted_string" -dbg 1-21 [-sys system] [-msgid message-number [-encoding encoding] [-parameters parameter1 parameter2 ...]]
halog -cache [number_of_messages_<=_1024]
The halog command adds messages to the engine log. The halog command command is also used internally to log messages from agent entry points written in Perl or Shell script. Starting with VCS 4.0, it is no longer necessary to directly call halog to log messages from script-based entry points. It is recommended to use the wrapper functions VCSAG_SET_ENVS, VCSAG_LOG_MSG, and VCSAG_LOGDBG_MSG to call the halog command. The logging functions for script-based entry points are described in the VCS Agent Developer's Guide.
-addtags tag1 [tag2 tag3 ...] [-sys system]
Enable a debug tag. If the system is supplied, this tag is enabled only on that system. See Example 2.
-deltags tag1 [tag2 tag3 ...] [-sys system]
Delete a debug tag that was previously enabled. See Example 3.
-add\ "quoted_string" -sev C|E|W|N|I [-sys system] [-msgid message-number [-encoding encoding] [-parameters parameter1 parameter2 ...]] Add a message from the command line to the log file. See examples 6, 7, and 9. -msgid is the message number. The severity values C, E, W, N, and I have the following significance:
Maximum size of quoted_string is 4096 bytes; strings longer than 4096 bytes are truncated. Combined size of all arguments parameter1 parameter2 ... must not exceed 4096 bytes. If total exceeds 4096 bytes, then each argument is allowed an equal portion of 4096 bytes and truncated if it exceeds the allowed portion.
-add\ "quoted_string" -dbg 1-21 [-sys system] [-msgid message-number [-encoding encoding] [-parameters parameter1 parameter2 ...]] Add a debug message from the command line to the log file. See Example 8. Maximum size of quoted_string is 4096 bytes; strings longer than 4096 bytes are truncated. Combined size of all arguments parameter1 parameter2 ... must not exceed 4096 bytes. If total exceeds 4096 bytes, then each argument is allowed an equal portion of 4096 bytes and truncated if it exceeds the allowed portion.
-cache [number_of_messages_<=_1024]
Display the most recent messages sent to the log. The maximum is 1024. See Examples 4 and 5.
Display the maximum size of the log file and the enabled global and local tags. Ses Examples 1 and 2.
Display usage for halog command.
VCS NOTICE V-16-1-10114 Opening GAB library
VCS NOTICE V-16-1-10619 'HAD' starting on: mars17
VCS INFO V-16-1-10125 GAB timeout set to 15000 ms
VCS INFO V-16-1-10077 Received new cluster membership
VCS NOTICE V-16-1-10080 System (mars17) - Membership: 0x1, Jeopardy: 0x2
VCS NOTICE V-16-1-10114 Opening GAB library
VCS NOTICE V-16-1-10619 'HAD' starting on: mars17
% halog -add "This is an application message" -sev N
VCS NOTICE V-16-1-0 (mars17) This is an application message
% halog -add "This is an application message" -sev N -sys mars17
% halog -add "This is a debug message" -dbg 2 -sys mars17
% halog -add "This is an application message for group1" \
-sev N -sys mars17 -msgid 11057 -parameters group1
hares (1M)