dcauditsetup OpenTP1-directory

The dcauditsetup command sets up the environment for using the audit log facility.

To change an operand related to audit logs (a log_audit_xxxx operand) in the log service definition, stop OpenTP1, change the log service definition, and then execute the dcauditsetup command. Also, whenever you change the location specified by the DCCONFPATH operand in the system environment definition (env), the log service definition at the new location will not take effect until you execute the dcauditsetup command.

The audit log facility will be disabled if the log_audit_out operand is omitted from the log service definition, or if N is specified for the operand.

The dcauditsetup command references the environment variable DCCONFPATH in the file OpenTP1-directory-in-command-argument/conf/env and sets up the environment for the audit log facility. If env does not exist at this location, or the environment variable DCCONFPATH is not defined, the command proceeds with the environment setup process using OpenTP1-directory/conf as the value of DCCONFPATH.

The following table lists the files and directories that are created when you execute the dcauditsetup command. If you create the directories in advance, make sure that you assign the appropriate access permissions as shown in the table.

Table 13-1 Files and directories created by the dcauditsetup command

File or directory	User ID	Group ID	Access permission	Description
$DCDIR/auditlog#	User ID of OpenTP1 system administrator	Group ID of OpenTP1 system administrator	0777	Directory for storing audit log files
$DCDIR/auditlog/audit.log#	User ID of OpenTP1 system administrator	Group ID of OpenTP1 system administrator	0666	Audit log file

#

This directory is used when the log_audit_path operand is omitted from the log service definition. If the operand is specified with a directory, that directory is used.

For details about the log service definition, see the manual OpenTP1 System Definition.

The following tables show what happens when you execute the dcauditsetup command, if the directory serving as the output destination for audit logs already exists or an audit log file already exists at the specified location.

Table 13-2 Execution result of the dcauditsetup command when the audit log output directory already exists

User ID of directory	Group ID of directory	Directory access permission	Command execution result
User ID of OpenTP1 system administrator	Group ID of OpenTP1 system administrator	0777	Successful
		Other than 0777	Error
User ID of OpenTP1 system administrator	Other group ID	0777	Error
		Other than 0777
Other user ID	Group ID of OpenTP1 system administrator	0777	Error
		Other than 0777
Other user ID	Other group ID	0777	Error
		Other than 0777

Table 13-3 Execution result of the dcauditsetup command when the audit log file already exists

User ID of audit log file	Group ID of audit log file	Audit log file access permission	Command execution result
User ID of OpenTP1 system administrator	Group ID of OpenTP1 system administrator	0666	Successful
		Other than 0666	Error
User ID of OpenTP1 system administrator	Other group ID	0666	Successful
		Other than 0666	Error
Other user ID	Group ID of OpenTP1 system administrator	0666	Successful
		Other than 0666	Error
Other user ID	Other group ID	0666	Successful
		Other than 0666	Error

OpenTP1-directory~<path name>

Specifies the OpenTP1 directory. Use no more than 50 characters.

Message ID	Description	Output destination
KFCA33500-I	Help message	Standard error output
KFCA33501-E	Error occurred during command execution.	Standard error output
KFCA33502-I	Log service definition has been analyzed.	Standard output
KFCA33503-I	Audit log facility was enabled/disabled.	Standard output

Only the superuser can execute the dcauditsetup command.