WEBAUDIT parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 54: Line 54:
though there is no userid logged on the thread, so they are singularly
though there is no userid logged on the thread, so they are singularly
useless.
useless.
 
</dl>
The MSGCTL NOAUDIT enhancement should be used with caution. Preventing certain
The MSGCTL NOAUDIT enhancement should be used with caution. Preventing certain
messages from going to the journal could make diagnosing certain problems more
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
difficult.
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
In any case, the MSGCTL NOAUDIT and NOAUDITW provide a neater and more finegrained

Revision as of 12:33, 12 February 2015

Janus Web audit trail reduction flags

Summary

Default value
X'00000000'
Parameter type
System
Where set
User 0 CCAIN parameters
Related products
All
Introduced
Sirius Mods 6.9

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'00000002'
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.

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.