2.5 pdaudend (Stop acquisition of audit trails)

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

(1) Function

The pdaudend command stops acquisition of audit trails.

(2) Executor

HiRDB administrator

(3) Format

(a) HiRDB single server configuration

pdaudend

(b) HiRDB parallel server configuration

pdaudend [-u unit-identifier]

(4) Options

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

Specifies the identifier of the unit that is to stop acquisition of an audit trail.

If the -u option is omitted, the command stops acquisition of audit trails on all units.

(5) Rules

  1. The pdaudend command can be executed only while HiRDB is active and audit trail acquisition has started.
  2. The pdaudend 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 pdaudend command is executing.
  4. The pdaudend 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. In a HiRDB parallel server configuration, if you execute the pdaudend command omitting the -u option and an error occurs during command processing or audit trail acquisition has already stopped, the command displays an error message at the corresponding unit. The command stops acquisition of audit trails on the units where no error resulted.
  6. Once audit trail acquisition begins, the system keeps acquiring audit trails until the unit is stopped or you execute the pdaudend command.

(6) Notes

  1. The result of pdaudend 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; 4 indicates that only some of the units have terminated normally; and 8 indicates abnormal termination.