Sends its argument to an audit logger/listener process. This function requires setting the AZA_ENABLE audit logging facility in the $gtm_dist/restrict.txt file. For information on setting up the AZA_ENABLE audit logging facility, refer to "Configuring the Restriction Facility" section in the GT.M Administration and Operations Guide.The format for the $ZAUDITLOG() function is:
ZAUDITLOG(expr)
expr specifies the string to send for audit logging
A return of TRUE (1) indicates successful logging, FALSE (0) indicates logging is not enabled; a trappable RESTRICTEDOP error indicates logging is enabled but not working.
$ZAUDITLOG() identifies its message with src=4, and like other GT.M logging facilities, records the location of GT.M distribution, uid, euid, pid, tty, and the command / argument(s).
If LGDE is specified as an option for the AZA_ENABLE facility, GDE logs all commands. GT.M ignores this option if specified with other A*_ENABLE audit logging facilities. When it fails to log a command, GDE issues a GDELOGFAIL error. The following table characterizes $ZAUDITLOG() and GDE audit logging behavior:
$ZAUDITLOG() / GDE logging Characteristics | ||||
---|---|---|---|---|
AZA_ENABLE |
LGDE |
Logging success |
GDE audit logging |
$ZAUDITLOG() result |
Yes |
Yes |
Yes |
Yes |
1 |
Yes |
No |
Yes |
No |
1 |
Yes |
Yes |
No |
GDELOGFAIL error |
RESTRICTEDOP error |
Yes |
No |
No |
No |
RESTRICTEDOP error |
No |
N/A |
N/A |
No |
0 |