2.6 pdaudrm (Delete audit trail files in shutdown status)

Organization of this section
(1) Function
(2) Executor
(3) Format
(4) Options
(5) Rules
(6) Notes

(1) Function

The pdaudrm command deletes audit trail files that are in shutdown status.

(2) Executor

HiRDB administrator

(3) Format

(a) HiRDB single server configuration

pdaudrm -g audit-trail-file-name [-f]

(b) HiRDB parallel server configuration

pdaudrm -u unit-identifier -g audit-trail-file-name [-f]

(4) Options

(a) -u unit-identifier ~<identifier> ((4 characters))

Specifies the identifier of the unit that contains the audit trail file to be deleted.

(b) -g audit-trail-file-name

Specifies the name of the audit trail file to be deleted.

(c) -f

Specifies that the audit trail file specified in the -g option is to be deleted even if it is waiting for data loading.

You can use the pdls -d aud command to check for audit trail files.

(5) Rules

  1. The pdaudrm command can be executed only while HiRDB is active.
  2. The pdaudrm command must be executed at the server machine that contains the single server or where the system manager is located.
  3. A command error results if you execute the pdaudbegin, pdaudend, pdaudrm, or pdaudswap command while the pdaudrm command is executing.
  4. The pdaudrm command results in a command error if the pd_aud_file_name operand has not been specified in the system definition or the audit trail file specified in the pd_aud_file_name operand is missing.
  5. You cannot delete the current audit trail file.

(6) Notes

  1. The result of pdaudrm command can be checked by using the pdls -d aud command, by checking for any error messages, or on the basis of the return code from execution of the command. A return value of 0 for this command indicates normal termination; 8 indicates abnormal termination.
  2. If an attempt is made to delete an audit trail file whose creation failed due to insufficient capacity, the KFPS05752-E message (reason code: FILE_ACCESS) is issued and an error results. In this case, no corrective action is needed. If you terminate HiRDB normally and then start HiRDB normally, the audit trail file whose creation failed will no longer be displayed by the pdls -d aud command.