2.38 pdfzeroinit (Initialize used area in a HiRDB file system area)

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

(1) Function

The pdfzeroinit command initializes the used area in a specified HiRDB file system area.

You use the pdfzeroinit command when you have used the HDP facility to virtualize HiRDB file system areas.

For details about using the HDP facility to virtualize HiRDB file system areas, see the HiRDB Version 9 System Operation Guide.

(2) Executor

HiRDB administrator

(3) Format

pdfzeroinit HiRDB-file-system-area-name

(4) Command arguments

(a) HiRDB-file-system-area-name ~<path name>((1 to 165 bytes))

Specifies the name of the HiRDB file system area in which the used area is to be initialized.

(5) Rules

  1. The pdfzeroinit command can be executed regardless of whether HiRDB is running.
  2. The pdfzeroinit command must be executed separately for each server machine containing the HiRDB file system area. If you are executing this command on a HiRDB file system area that is being used as a shared RDAREA, execute the command from the server machine that contains a back-end server that can be updated.
  3. You can execute this command only while the specified HiRDB file system area contains no HiRDB files. If it contains a HiRDB file, the command terminates with warning.
  4. The range of used area that is subject to initialization by the pdfzeroinit command is from the end of the management area in the HiRDB file system area to the current maximum amount used by the user.
  5. When the used area in the specified HiRDB file system area is initialized, 0 is set for the maximum size of the area, the maximum number of files, and the maximum number of extensions currently being used by the user.

(6) Notes

  1. The time required by the pdfzeroinit command to write data depends on the size of used area to be initialized. Do not execute the pdfzeroinit command on a HiRDB file system area that is being accessed by an application. If the command is executed in such a case, the application might be affected.
  2. If you execute the pdfzeroinit command on a HiRDB file system area whose type is WORK, make sure that HiRDB is stopped. If this command is executed while HiRDB is running, the SQL statements and utilities that require work table files might be affected.
  3. Do not execute the pdfstatfs -c command on areas that are subject to initialization. If executed, the used areas can no longer be initialized by the pdfzeroinit command.