pdfmkfs (Initialize HiRDB file system area)
Function
The pdfmkfs command initializes a specified hard disk partition (character special files) or a regular files area as a HiRDB file system area.
Executor
HiRDB administrator
Format
pdfmkfs -n HiRDB-file-system-area-size -l max-files-count
[-k usage-purpose] [-e max-secondary-allocations-count]
[-s sector-length] [-i]
character-special-files-area-name
pdfmkfs [-r] -n HiRDB-file-system-area-size -l max-files-count
[-k usage-purpose] [-e max-secondary-allocations-count]
[-i] [-r]
regular-files-area-name
Options
Specifies, in megabytes, the space to be allocated as the HiRDB file system area. The permitted value ranges are as follows:
File type | HP-UX | Solaris | AIX 5L | Linux | |
---|---|---|---|---|---|
Regular file | 1-2,047 | 1-2,047 | 1-2,047 | 1-2,047 | |
Character special file | 1-2,047 | 1-2,047 | 1-2,047 | 1-2,047 | |
Large file | Regular file | 1-131,071 | 1-1,048,575 | 1-65,411# | 1-1,048,575 |
Character special file | 1-131,071 | 1-1,048,575 | 1-1,048,575 | 1-1,048,575 |
The management area used for management of a HiRDB file system area is also included in the value of the -n option. Therefore, the actual size allocated to the HiRDB file is (value of the -n option) - (size of management area). For details about determining the size of the management area, see Notes. You can use the pdfstatfs command to check the actual size that is allocated to the HiRDB file.
Specifies the maximum number of HiRDB files that can be created in the allocated HiRDB file system area.
Once you execute the pdfmkfs command, you can no longer change this value. Therefore, carefully determine this value taking into account the number of HiRDB files to be used and future expansion plans.
Specifies the purpose for which the HiRDB file system area will be used:
Usage purpose | Availability | Remarks |
---|---|---|
DB | Y | |
SDB | Y | |
SYS | Y | |
WORK | N | You cannot specify a character special file in the pdwork operand in the system definition. |
UTL | Y | |
SVR | N |
Specifies the maximum number of extensions for each HiRDB file in the HiRDB file system area. HiRDB increases the size of HiRDB files according to the specified number of extension. The maximum number of extensions permitted per HiRDB file is 23. If the specified value is maximum number of files 23 or greater, the command ignores the specified value and assumes the maximum number of files
23.
-k option | Number of extensions to be specified |
---|---|
DB | min (60000, 23 ![]() If you frequently perform deletion, re-initialization (for reduction of allocation size or with with reconstruction specified), or integration of RDAREAs, you should use the following value: min (60000, 23 ![]() |
SDB | |
SYS | 0 |
WORK | min(60000, 23 ![]() min(60000, 23 ![]() Extension is applied to work table files and final files in the RDAREA subject to extension.* |
UTL | |
SVR |
If you are using a character special file as the HiRDB file system area with a device that handles a medium with a physical sector length of 2,048 and 4,096 bytes, such as DVD-RAM device, this option specifies the minimum I/O unit expressed as the sector length (the physical sector length of a medium corresponding to a character string special file). For details about the physical sector length of a medium, see the manual for the medium.
Specifies that the HiRDB file system area specified in the -n option is to be initialized from the beginning. When this option is omitted, the command creates only the management information for the HiRDB file system area. If the HiRDB file system area is large, it may take time to initialize it.
If you omit the -i option for a regular file, the command creates only the management information for the HiRDB file system area (an area with a maximum size of about 3.5 megabytes is allocated).
The HiRDB file system area will be extended up to the size specified with the -n option when it is actually used. The OS file system containing this HiRDB file system area may become full when this HiRDB file system area is put into use. To avoid this, specify the -i option.
Specifies that no confirmation message is to be displayed when a regular file is initialized. If this option is omitted and the specified regular file already exists, the command displays a confirmation message asking whether or not to initialize the file. If a letter other than g is entered in response to the confirmation message, the command will not initialize the file.
Command arguments
Specifies a name for the character special files area to be initialized. This name is used as the name of the HiRDB file system area.
Specifies a name for the regular files area to be initialized. This name is used as the name of the HiRDB file system area.
You can specify a maximum of 30 characters for the name of a HiRDB file that is created in the HiRDB file system area. Note that because HiRDB-file-system-area-name/HiRDB-filename cannot exceed 167 characters, the maximum length of an HiRDB file name is reduced accordingly if the HiRDB file system area name is greater than 136 characters.
For HiRDB files that are created automatically by HiRDB, make sure that the following maximum lengths for HiRDB file system area names are not exceeded:
HiRDB file created automatically by HiRDB | Maximum length of HiRDB file system area name (in characters) |
---|---|
Work table file (specified with pdwork operand in system definition) | 141 |
Audit trail file (specified with pd_aud_file_name operand in system definition) | 150 |
Index information file for delayed batch creation of plug-in index (specified with pd_plugin_ixmk_dir operand in system definition) | 136 |
Unload log file for system log for the automatic log unloading facility (specified with pd_log_auto_unload_path operand in system definition) | 136 |
Rules
Notes
Management area (bytes)
= Fixed management section + variable management section + HiRDB file management section a
+ 4096 (applicable to AIX 5L)
Examples
Initialize the following HiRDB file system areas:
pdfmkfs -n 25 .......................1
-l 10 .......................2
-e 5 ........................3
/svr01 ......................4
pdfmkfs -n 30 .......................5
-l 15 .......................6
/prdb/ios001 ................7