WEBAUDIT parameter
Summary
dl>
Description
This parameter makes it possible to reduce the quantity of useless audit trail data associated with Janus Web Server applications. The WEBAUDIT parameter is a collection of bits that, when set, reduce the quantity of data sent to the Model 204 journal or make it possible to reduce this quantity. The bits in WEBAUDIT are:
- X'00000001'
- Allow NOAUDIT and NOAUDITW keywords on MSGCTL command. Specifying MSGCTL msg_no NOAUDIT prevents msg_no from ever going to the audit trail, while MSGCTL msg_no NOAUDITW prevents msg_no from going to the audit trail, if issued on a Janus Web Server thread.
- X'00000001'
- Suppress APSY load since-last statistics for Janus Web Server threads. The resource usage associated with the APSY load such as CPU, DKPRs, disk I/Os, etc. will be included in the EVAL since-last statistics for the request. Since APSY load resource utilization is typically extremely minor relative to request evaluation, APSY load since-last statistics tend to be fairly useless.
- X'00000004'
- Suppress APSY load since-last statistics for all threads. The resource usage associated with the APSY load such as CPU, DKPRs, disk I/Os, etc. will be included in the EVAL since-last statistics for the request. Since APSY load resource utilization is typically extremely minor relative to request evaluation, APSY load since-last statistics tend to be fairly useless.
- X'00000008'
- Suppress “NO USERID” logout messages (M204.0353) for Janus Web Server threads. These messages are sometimes issued before a user logon, even though there is no userid logged on the thread, so they are singularly useless.
- X'00000010'
- Suppress “NO USERID” logout messages (M204.0353) for all threads.
These messages are sometimes issued before a user logon, even
though there is no userid logged on the thread, so they are singularly
useless.
The MSGCTL NOAUDIT enhancement should be used with caution. Preventing certain
messages from going to the journal could make diagnosing certain problems more
difficult. It is not, however, a new capability or one that is only available to Janus Web
Server customers. Even without Janus Web Server, it is possible to issue a MSGCTL
command for any message with the AUDITRK parameter. It is then possible to
suppress RK messages from going to the audit trail by making sure the X'20' bit is not
set in SYSOPT. The one unfortunate side-effect of this technique is that it also
suppresses RK messages that one might actually want to go to the audit trail, but this
can be overcome by MSGCTL'ing these messages to NOAUDITRK. Thanks to Warren
Kring for this technique.
In any case, the MSGCTL NOAUDIT and NOAUDITW provide a neater and more finegrained
way of reducing audit trail messages for Janus Web Server or other threads.
Some good candidates for MSGCTL NOAUDIT or NOAUDITW are:
- M204.0099
- MINIMUM SERVSIZE FOR THESE TABLES = ...
- M204.0131
- (Checkpoint completed or timed out messages)
- M204.0353
- (login/logout message that is essentially a shortened version of M204.0352 that also gets logged to the journal)
- M204.0608
- FILE CLOSED: ...
- M204.0619
- GROUP FILE OPENED: ...
- M204.0620
- FILE file OPENED (-- NO UPDATES ALLOWED)
- M204.0621
- (Informational message indicating recovery status of file being opened)
- M204.0622
- (Informational message indicating the last update applied by the last rollforward for a file being opened)
- M204.0821
- GROUP FILE CLOSED: ...
- M204.0858
- GROUP group OPENED (-- NO UPDATES ALLOWED)
- M204.1203
- FILE file WAS LAST UPDATED ON ...
- M204.1238
- (Informational message indicating the time the file was last recovered.) Under Sirius Mods version 6.9 and later, there is also a NOAUD parameter on Janus port definitions that allow even more information to be suppressed from the audit trail on a port basis.