2.63 pdls [-d aud] (Display the status of audit trail files)

Organization of this section
(1) Function
(2) Format
(3) Options
(4) Notes
(5) Output format

(1) Function

The pdls -d aud command displays the status of audit trail files.

(2) Format

 pdls -d aud [-u unit-identifier] [-U authorization-identifier]

(3) Options

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

Specifies the identifier of the unit whose information is to be displayed.

The -u option is applicable to a HiRDB parallel server configuration. When the -u option is omitted, the command displays the information for all units.

(b) -U authorization-identifier

Specifies the auditor's authorization identifier. When this option is specified, a message requesting entry of a password is displayed.

This option is effective when the pdls -d aud command is executed during HiRDB operation.

Rules
  1. When the HiRDB administrator executes a command, a message requesting entry of a password is displayed. The auditor must then enter an authorization identifier and password. Note that if HiRDB is stopped, authorization to access HiRDB is not performed.
  2. The command uses the authorization identifier specified in this option and the password that is entered in the response-request message to connect to HiRDB and checks that this authorization identifier has the audit privilege.
  3. You can specify this option only when you execute the pdls -d aud command in an environment in which you can enter a response to a response-request message.
  4. When this option is omitted, the pdls -d aud command assumes the value set in the PDUSER environment variable during command execution. If this option is omitted and the PDUSER environment variable has not been set, the pdls -d aud command cannot be executed. If this option is omitted, the PDUSER environment variable must be set, as shown in the following example.
    Example: C shell
    setenv PDUSER '"authorization-identifier"/"password"'

(4) Notes

  1. Return code 0 for the pdls -d aud command indicates normal termination, and return code 8 indicates abnormal termination.
  2. The pdls -d aud command cannot be executed during unit startup or termination processing or when HiRDB was started with the pdstart -r command.
  3. 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, executing the pdls -d aud command results in a command error.
  4. If you execute the pdls -d aud command for a HiRDB parallel server configuration without specifying the -u option and an error occurs on the unit during command processing, the command displays the error message; if no error occurs on the unit, the command displays information about the audit trail files.
  5. If you initialize a unit status file while the unit is inactive and then start the unit, the command displays - as the data loading status of the audit trail file generation that has been placed in shutdown status due to an error.

(5) Output format

HOSTNAME     : aa...a(bbccdd)
UNITID       : eeee
Audit-Status : ff...f
File-Name    : gg...g
Generation-Name    Status
hh...h             ijk
   :                :

When information about all units is displayed, the command displays as many sets of the above information as there are units.

Explanation
aa...a:
Host name (1-32 characters)
bbccdd:
Time the pdls command was executed (hour-minute-second)
eeee:
Unit identifier (4 characters)
ff...f:
Audit trail acquisition status (1-8 characters)
ACTIVE: Acquiring
INACTIVE: Stopped
********: The audit trail acquisition status cannot be displayed because HiRDB is not active.
gg...g:
Name of the HiRDB file system area for audit trail files (absolute path name expressed in 1-117 characters)
If the name of the audit trail file exceeds 117 characters, the command displays the first 117 characters.
hh...h:
File name for each audit trail file generation (16 characters)
If the number of audit trail file generations is 1 or fewer, this information is not displayed.
ijk:
Status of each audit trail file generation (3 characters)
If the number of audit trail file generations is 1 or fewer, this information is not displayed.
i: Current status of the audit trail file:
c: Current. The current audit trail is being output to this generation. If audit trail acquisition has stopped, this file will be used as the current file the next time acquisition begins.
s: Standby. The current audit trail is not being output to this generation. In the case of an audit trail file that is in shutdown status due to an error, s is displayed while the unit is inactive.
j: Data loading status of the audit trail file:
d: Waiting for data loading. Data has not been loaded from the applicable audit trail file generation to the audit trail table.
-: Data loading has been completed. Data has been loaded from the applicable audit trail file generation to the audit trail table. In the case of an audit trail file that is in shutdown status due to an error, - is displayed while the unit is inactive.
k: Shutdown status of the audit trail file:
h: Shut down. An error occurred in the audit trail file and no audit trail has been output to the file since then.
-: Not shut down.