2.94 pdprflevel (Display or change the performance trace collection level)

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

(1) Function

The pdprflevel command displays or changes the performance trace acquisition level (value of the pd_prf_level operand).

(2) Executor

HiRDB administrator

(3) Format

 pdprflevel [-l performance-trace-acquisition-level]

(4) Options

(a) -l performance-trace-acquisition-level

Displays or changes the performance trace acquisition level.

performance-trace-acquisition-level:
Specifies the performance trace collection level that is to be set. Specify 00000007 for minimum level, 0000001f for standard level, 0000007f for detail level, 000001ff for maintenance level, or 00000000 for suppression level. For details, see the pd_prf_level operand in the manual HiRDB Version 9 System Definition.
When the specification is omitted:
Displays the performance trace collection level that is currently set (in hexadecimal).

(5) Rules

  1. The pdprflevel command can be executed only while HiRDB is running.
  2. Execute the pdprflevel command on each server machine.

(6) Notes

  1. The following are the pdprflevel command's return codes:
    0: Normal termination
    8: Abnormal termination
  2. If Y or nothing is specified for pd_prf_trace in the system definition, execute this command while the troubleshooting information collection process (pdprfd process) is running. If the command is executed while the pdprfd process is not running, it will terminate with an error. You can use the OS's ps command to check the status of the pdprfd process.
  3. When the performance trace collection level is changed by this command, the change takes effect at the next performance trace acquisition point. For details about performance trace acquisition points, see the HiRDB Version 9 System Operation Guide.
  4. When the performance trace collection level is changed by this command, HiRDB terminates and then restarts with the performance trace collection level reset to the value that is newly set in the pd_prf_level operand.
  5. If system switchover occurs after the performance trace collection level has been changed by this command, the new performance trace collection level is not inherited to the standby HiRDB. If you are running system switchover in the server mode, you must also execute in the standby system the pdprflevel command with the same performance trace collection level specified. If you are running system switchover in the monitor mode, change the performance trace collection level after system switchover has been completed.